Harmonica version compatibility¶
Harmonica uses semantic versioning (i.e.,
Major releases mean that backwards incompatible changes were made. Upgrading will require users to change their code.
Minor releases add new features/data without changing existing functionality. Users can upgrade minor versions without changing their code.
Bug fix releases fix errors in a previous release without adding new functionality. Users can upgrade minor versions without changing their code.
We will add
FutureWarning messages about deprecations ahead of making any
breaking changes to give users a chance to upgrade.
The above does not apply to versions <
0.* versions may
deprecate, remove, or change functionality between releases. Proper
warnings will be raised and any breaking changes will be marked as such in
Supported dependency versions¶
Harmonica follows the recommendations in NEP29 for setting the minimum required version of our dependencies. In short, we support all minor releases of our dependencies from the previous 24 months before a Harmonica release with a minimum of 2 minor releases.
We follow this guidance conservatively and won’t require newer versions if the older ones are still working without causing problems. Whenever support for a version is dropped, we will include a note in the Changelog.
This was introduced in Harmonica v0.6.0.
Supported Python versions¶
If you require support for older Python versions, please pin Harmonica to the following releases to ensure compatibility:
Last compatible release