Simple Git version plugin for setuptools
Project description
Simple Git version plugin for setuptools.
Usage
Modify the setup.py of your project and add setuptools-gitver to setup_requires and add keyword argument gitver=True. Then, after each release, add .post+gitver suffix to the version string.
For example, in setup.py:
import setuptools if __name__ == '__main__': setuptools.setup( name='example-package', version='1.2.3.post+gitver', setup_requires=['setuptools-gitver'], gitver=True, )
This will then generate version numbers like 1.2.3.post0.dev7+ga1b2c3d where 7 is the number of commits since the v1.2.3 tag and a1b2c3d is commit id of the HEAD.
When creating a release, update the version and remove the post+gitver suffix. When there is no +gitver suffix, the version won’t be touched by Setuptools Gitver. Also remember to tag the release in Git with git tag -a v1.2.3.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for setuptools_gitver-1.1.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2f831c4164574c1c64173fddc2037ba1fbab54d9055ac57cd488c38c0c47c9cd |
|
MD5 | 5dd07f48d2fea290bf3961de2ad2f948 |
|
BLAKE2b-256 | dfe317801e9324d5fe259b4b61977bda7a3f8a27844fb8b726fe083d0517a2e3 |