Versioning and Backwards Compatibility#

find-work follows the SemVer 2.0.0 version policy.

The following will result in a major version increment:

  • Breaking plugin API changes.

  • Breaking configuration file format changes.

  • Breaking command-line interface changes.

  • Breaking machine-readable output format changes in any of result reporters.

Command-line plugins and result reporter plugins additionally have versioned entry points. This prevents loading incompatible plugins in the first place.

Feature releases are made at irregular intervals when enough new features accumulate. Bugfix releases may be made if bugs are discovered after a feature release.

Plugin packages#

Plugin packages developed in the find-work-plugins repo are also subject to the Semantic Versioning policy.

The following will result in a major version increment:

  • find_work.plugins.v{number} entry point version updates.

  • Breaking configuration file format changes.

  • Breaking command-line interface changes.

Supported Python versions#

Up to three most recent of stable-keyworded CPython versions in Gentoo are supported.

Other versions and implementations might also work but they are not tested.