setuptools-gitver

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.

Release files for setuptools-gitver 1.1.0

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

Source distribution (sdist)

Source distribution for setuptools-gitver 1.1.0
File	Size	Uploaded
setuptools-gitver-1.1.0.tar.gz	2.6 kB	May 10, 2017	Details

Built distribution (wheel)

Table of built distributions (wheels) for setuptools-gitver 1.1.0
File	Interpreter	ABI	Platform	Reset
setuptools_gitver-1.1.0-py2.py3-none-any.whl 5.5 kB May 10, 2017	Python 2, Python 3	none	any	Details

Total release size: 8.2 kB

Release files / setuptools-gitver-1.1.0.tar.gz

Download URL	setuptools-gitver-1.1.0.tar.gz
Size	2.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`0daa2b63b2765570ad3beb404c037d2883c2a2dd1b4d6f1dd82063b73bf9b17d`
BLAKE2b-256 checksum How to use checksums	`546f1b8061a3e2192c20df52affe7d2caeb352550ef297250aed76bcbcb4e4d1`
Upload date	May 10, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / setuptools_gitver-1.1.0-py2.py3-none-any.whl

Download URL	setuptools_gitver-1.1.0-py2.py3-none-any.whl
Size	5.5 kB
Tags	Python 2 Python 3
SHA-256 checksum How to use checksums	`2f831c4164574c1c64173fddc2037ba1fbab54d9055ac57cd488c38c0c47c9cd`
BLAKE2b-256 checksum How to use checksums	`dfe317801e9324d5fe259b4b61977bda7a3f8a27844fb8b726fe083d0517a2e3`
Upload date	May 10, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No