poetry-incr-version 0.1.4

Tool to help manage the version of a Poetry project in CI pipelines

Description

Update the version of a Poetry project both in:

• The pyproject.toml file: in the tool.poetry section.
• All the __init__.py files of the packages registered in the tool.poetry.packages section of the pyproject.toml file.

The reason for having the version in both places is to be able to easily access the version at runtime by importing the package and reading the __version__ attribute in the __init__.py file, and still having the version in the pyproject.toml file for Poetry during the package build.

It is mainly made for being used in CI pipelines to automatically increment the versions at each deployment. But is also very helpful for manual usage, as it maintain consistancy between the versions in the pyproject.toml and the __init__.py files at all time.

Install

$ pip install poetry_incr_version # Easiest method

$ pipx install poetry_incr_version # Preferable for exemple to install on your machine

Usage

$ poetry-incr-version --minor . # Increment the minor version of the project in the current directory

$ poetry-incr-version --set 1.2.3 path/to/project # Sets the version of the project inside path/to/project to 1.2.3

See .gitlab-ci.yml for a real use case.

Notes

• No runtime dependencies: it is fast to install from scratch.
• Requires at least python 3.11: neeeded to parse the pyproject.toml.
• Tested: checked by Pyright with strict mode, Ruff with all lint rules, Pytest with 100% test coverage and by the CI pipelines of the project itself.