| Description: | Use git repo data (latest tag, current commit hash, etc) for building a version
number according to 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
Limitations:
• Currently the only supported VCS is Git
• Only Git v2 is supported
• Only Setuptools build backend is supported (no Poetry & others)
• Currently does not support automatic exporting of package version to a file
for runtime use (but you can use setuptools-git-versioning > file redirect
instead) |