Skip to content

Commit b776623

Browse files
docs: document breaking changes and deprecations; bump version to 1.13.0
Fill in the previously-empty Changed section and expand Deprecated to make the release's user-visible breaking changes and deprecations explicit: Parachute is now abstract (use HemisphericalParachute), add_parachute's legacy parameter form and the rocketpy.rocket.parachute import path are deprecated (removal in v1.14.0), logging is silent by default (enable via rocketpy.utils.enable_logging), Components.sort_by_position returns a new object, small fin sets now warn instead of erroring, the unstable-rocket warning fires at flight creation, and individual fins intentionally omit the multi-fin lift correction. Bump the version to 1.13.0. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1 parent ea27742 commit b776623

2 files changed

Lines changed: 8 additions & 2 deletions

File tree

CHANGELOG.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,10 +57,16 @@ Attention: The newest changes should be on top -->
5757

5858
### Changed
5959

60-
-
60+
- ENH: Adopt built-in Python logging across the library. Runtime info/debug messages are now silent by default; call `rocketpy.utils.enable_logging()` to display them. Warnings and errors remain visible by default. [#973](https://github.com/RocketPy-Team/RocketPy/pull/973)
61+
- MNT: `Components.sort_by_position` now returns a new sorted `Components` object instead of sorting in place. [#818](https://github.com/RocketPy-Team/RocketPy/pull/818)
62+
- MNT: `Rocket.add_trapezoidal_fins`, `add_elliptical_fins` and `add_free_form_fins` now emit a warning (instead of raising) for fin sets with 2 or fewer fins; use the individual fin classes for asymmetric configurations. [#818](https://github.com/RocketPy-Team/RocketPy/pull/818)
63+
- MNT: `UnstableRocketWarning` is now emitted when a `Flight` is created (on the fully-assembled rocket) rather than on every incremental `add_surfaces`/`add_motor` call, avoiding spurious warnings during construction. [#970](https://github.com/RocketPy-Team/RocketPy/pull/970)
64+
- MNT: A set of `n` identical individual `Fin` objects does not reproduce the exact aggregate lift slope of a `Fins(n=...)` set (individual fins omit the empirical multi-fin interference correction by design); use the plural `*Fins` classes for standard symmetric fin sets. [#818](https://github.com/RocketPy-Team/RocketPy/pull/818)
6165

6266
### Deprecated
6367

68+
- MNT: `Parachute` is now an abstract base class and can no longer be instantiated directly — use `HemisphericalParachute` (or another concrete subclass). Passing parachute parameters directly to `Rocket.add_parachute` (e.g. `add_parachute(name=, cd_s=, ...)`) is deprecated and will be removed in v1.14.0; instead build a `HemisphericalParachute` and pass it via the `parachute=` argument. [#958](https://github.com/RocketPy-Team/RocketPy/pull/958)
69+
- MNT: Importing from `rocketpy.rocket.parachute` is deprecated; import from `rocketpy.rocket.parachutes` instead (to be removed in v1.14.0). [#958](https://github.com/RocketPy-Team/RocketPy/pull/958)
6470
- MNT: Rename `radius` to `radius_function` in `CylindricalTank` and `SphericalTank`; old `radius=` keyword argument now raises `DeprecationWarning` [#957](https://github.com/RocketPy-Team/RocketPy/pull/957)
6571

6672
### Removed

pyproject.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
[project]
22
name = "rocketpy"
3-
version = "1.12.1"
3+
version = "1.13.0"
44
description="Advanced 6-DOF trajectory simulation for High-Power Rocketry."
55
dynamic = ["dependencies"]
66
readme = "README.md"

0 commit comments

Comments
 (0)