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.
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|python_semantic_release-3.11.2-py2.py3-none-any.whl (27.4 kB) Copy SHA256 hash SHA256||Wheel||py2.py3|
|python-semantic-release-3.11.2.tar.gz (18.5 kB) Copy SHA256 hash SHA256||Source||None|