Skip to main content

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

setuptools-gitver-1.1.0.tar.gz (2.6 kB view details)

Uploaded Source

Built Distribution

setuptools_gitver-1.1.0-py2.py3-none-any.whl (5.5 kB view details)

Uploaded Python 2Python 3

File details

Details for the file setuptools-gitver-1.1.0.tar.gz.

File metadata

File hashes

Hashes for setuptools-gitver-1.1.0.tar.gz
Algorithm Hash digest
SHA256 0daa2b63b2765570ad3beb404c037d2883c2a2dd1b4d6f1dd82063b73bf9b17d
MD5 ecd948a9c1497ddd005edac3b523fb40
BLAKE2b-256 546f1b8061a3e2192c20df52affe7d2caeb352550ef297250aed76bcbcb4e4d1

See more details on using hashes here.

File details

Details for the file setuptools_gitver-1.1.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for setuptools_gitver-1.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 2f831c4164574c1c64173fddc2037ba1fbab54d9055ac57cd488c38c0c47c9cd
MD5 5dd07f48d2fea290bf3961de2ad2f948
BLAKE2b-256 dfe317801e9324d5fe259b4b61977bda7a3f8a27844fb8b726fe083d0517a2e3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page