This package regroups utilities to deal with pep440 versioning. It is based on the
PyPA's packaging
project and extends it.
It makes it easier to handle version bumps and strictly follows PEP440 specification.
Use pip
or poetry
to install this package:
$ pip install pep440-version-utils
# or alternatively
$ poetry add pep440-version-utils
Since this package extends the packaging
library, so it supports version parsing and ordering as described
in this documentation.
To bump to a new release version:
from pep440_version_utils import Version
version = Version("1.10.2")
version.next_micro() # 1.10.3
version.next_minor() # 1.11.0
version.next_major() # 2.0.0
To bump to a new developmental or prerelease version:
from pep440_version_utils import Version
version = Version("1.10.2")
version.next_alpha() # 1.10.3a1
version.next_beta() # 1.10.3b1
version.next_release_candidate() # 1.10.3rc1
version.next_dev() # 1.10.3.dev1
version.next_alpha("minor") # 1.11.0a1
version.next_beta("minor") # 1.11.0b1
version.next_release_candidate("major") # 2.0.0rc1
version.next_dev("major") # 2.0.0.dev1
And it implements the full release cycle:
from pep440_version_utils import Version
version = Version("1.10.2")
alpha1 = version.next_alpha() # 1.10.3a1
alpha2 = alpha1.next_alpha() # 1.10.3a2
beta1 = alpha2.next_beta() # 1.10.3b1
rc1 = beta1.next_release_candidate() # 1.10.3rc1
rc2 = rc1.next_release_candidate() # 1.10.3rc2
new_version = rc2.next_micro() # 1.10.3
Complete with support for developmental versions, including within prerelease phases:
from pep440_version_utils import Version
version = Version("1.10.2")
dev1 = version.next_dev() # 1.10.3.dev1
alpha1 = dev1.next_alpha() # 1.10.3a1
beta1 = alpha1.next_beta() # 1.10.3b1
rc1 = beta1.next_release_candidate() # 1.10.3rc1
rc2_dev1 = rc1.next_dev() # 1.10.3rc2.dev1
rc2 = rc2_dev1.next_release_candidate() # 1.10.3rc2
new_version = rc2.next_micro() # 1.10.3
You can also check if a version is a specific type of prerelease:
from pep440_version_utils import Version
Version("1.10.2a1").is_alpha # True
Version("1.10.2b2").is_beta # True
Version("1.10.2rc1").is_release_candidate # True
This package doesn't support post, versions yet and has limited support for local versions. Contributions are welcome 😊
This package is fairly simple, here is how you can contribute:
- ⚙️ Install
poetry
- 📦 In the repository folder, run
poetry install
- ✍️ Implement the desired changes
- ✅ Run test, type checking and code quality checks:
$ poetry run black . --check
$ poetry run mypy */**.py --ignore-missing-imports
$ poetry run pytest --cov=pep440_version_utils
- ➡️ Submit a new pull request
Do not hesitate to contribue, even for very small changes!