setuptools-git-versioning 1.8.1

Use git repo data for building a version number according PEP-440

Use git repo data (latest tag, current commit hash, etc) for building a version number according PEP 440.

Features:

• Can be installed & configured through both setup.py and PEP 518’s pyproject.toml

• Does not require to change source code of the project

• Tag-, file-, and callback-based versioning schemas are supported

• Templates for tag, dev and dirty versions are separated

• Templates support a lot of substitutions including git and environment information

• Well-documented

See difference between setuptools-git-versioning and other tools.

Limitations:

• Currently the only supported VCS supported is Git

• Only git v2 is supported

• Currently does not support exporting version to file for runtime use

Documentation

See https://setuptools-git-versioning.readthedocs.io/en/stable/

Contribution Guide

See ./CONTRIBUTING.rst

Install

pyproject.toml

Just add setuptools-git-versioning to build-sytem part of your pyproject.toml

[build-system]
requires = [ "setuptools>=41", "wheel", "setuptools-git-versioning", ]
build-backend = "setuptools.build_meta"

[tool.setuptools-git-versioning]
enabled = true

setup.py

Just add setuptools-git-versioning to setup_requires part of your setup.py

import setuptools

setuptools.setup(
    ...,
    setuptools_git_versioning={
        "enabled": True,
    },
    setup_requires=["setuptools-git-versioning"],
)