Are you happy with your logging solution? Would you help us out by taking a 30-second survey? Click here

Automatic version numbers for git-based python projects

Subscribe to updates I use

Statistics on

Number of watchers on Github 84
Number of open issues 1
Main language Python
Open pull requests 0+
Closed pull requests 1+
Last commit over 2 years ago
Repo Created over 4 years ago
Repo Last Updated almost 2 years ago
Size 8 KB
Organization / Authorchangaco
Page Updated
Do you use Leave a review!
View activity
View on github
Fresh, new opensource launches 🚀🚀🚀
Trendy new open source projects in your inbox! View examples

Subscribe to our mailing list

Evaluating for your project? Score Explanation
Commits Score (?)
Issues & PR Score (?) saves you from having to hard-code the version number of your project by getting it from git tags (directly or indirectly).

To use the script, simply copy it into your project and call get_version() in your file:

from version import get_version


By default the tags that are considered to be version numbers are those that start with a digit. If you use a prefix, for example a v, modify the PREFIX constant in accordingly.

You need to distribute the file in your sdist packages by adding the following line in the file:


For the script to work within git archives (for example those automatically generated by GitHub for each tag) you need to add the following line to the .gitattributes file:  export-subst

Note: if you don't care about git archives, or you're looking for a solution that works with Mercurial, then you can use setuptools_scm instead.

Compatibility: python 3.x and 2.7

Licence: CC0 Public Domain Dedication open issues Ask a question     (View All Issues)
  • about 4 years Add support for Mercurial list of languages used
Other projects in Python