Automatic semantic versioning for python projects
Automatic semantic versioning for python projects. This is an python implementation of the semantic-release for js by Stephan Bönnemann. If you find this topic interesting you should check out his talk from JSConf Budapest.
pip install python-semantic-release
The general idea is to have some sort of tag in commit messages that indicates certain types of changes. If a commit message lack a tag it is ignored. Running release can be run locally or from a CI service.
Usage: semantic-release [OPTIONS] COMMAND Options: --major Force major version. --minor Force minor version. --patch Force patch version. --noop No-operations mode, finds the new version number without changing it. --post If used with the changelog command, the changelog will be posted to the release api. --retry Retry the same release, do not bump. --help Show this message and exit.
- version - Create a new release. Will change the version, commit it and tag it.
- publish - Runs version before pushing to git and uploading to pypi.
- changelog - Generates the changelog for the next release.
Running commands from setup.py
Add the following to your setup.py and you will be able to run python setup.py <command> as you would semantic-release <command>.
try: from semantic_release import setup_hook setup_hook(sys.argv) except ImportError: pass
Configuration belongs in semantic_release section of the setup.cfg file in your project. Details about configuration options can be found in the configuration documentation.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size python_semantic_release_pypi-3.11.2-py2.py3-none-any.whl (28.6 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View hashes|
|Filename, size python-semantic-release-pypi-3.11.2.tar.gz (18.3 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for python_semantic_release_pypi-3.11.2-py2.py3-none-any.whl
Hashes for python-semantic-release-pypi-3.11.2.tar.gz