version-wizard

https://github.com/tillahoffmann/wizard-version/actions/workflows/main.yml/badge.svg

The version wizard extracts version information from a git tag and includes it in your python package so you don’t have to worry about commit messages like Bump version to 0.8.1 anymore. Here’s how to use the wizard:

Install by running pip install version-wizard.
Add include VERSION to your MANIFEST.in file (or create one by running echo "include VERSION" > MANIFEST.in).
Update your setup.py as shown below.
Push semantic versioning tags to your GitHub branch, e.g, 0.8.1.

# setup.py
from setuptools import setup, ...
from version_wizard import from_github_tag

setup(
    version=from_github_tag(),
    ...
)

Behind the scenes

The call to from_github_tag will do one of two things:

If the VERSION file exists, it simply returns its contents. This is the typical behavior when your installing the package from pypi, for example.
If the VERSION file does not exist, it will try to extract the version from the GITHUB_REF environment variable and write it to the VERSION file.

Because the MANIFEST.in includes VERSION, the VERSION file will be included in any distribution, e.g., when you run python setup.py sdist. The correct version is thus automatically packaged with your distribution elminiating any possible inconsistencies.

Interface

..automodule:: version_wizard
  :members:

Metadata

Release files for version-wizard 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for version-wizard 0.1.2
File	Size	Uploaded
version-wizard-0.1.2.tar.gz	3.9 kB	Oct 25, 2022	Details

Release files / version-wizard-0.1.2.tar.gz

Download URL	version-wizard-0.1.2.tar.gz
Size	3.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`c060b50944ae87130648cf0b21f1869ef171fe69041c025b88ef493d248d2247`
BLAKE2b-256 checksum How to use checksums	`f89eb4b11f1c9598bcee377ae0cea2b33d1fdd30be75fac8e256d3dd4c8b264e`
Upload date	Oct 25, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.9.15`