git-version

Make git version information (e.g. git tag name, git commit id, ...) available to your source files. A simple use case scenario is to output this version information when the application is called with "--version".

This repository contains

• A python script to generate C++ headers or python modules with this version information. You can add the python script to your build process to autogenerate the files on each build.
• A CMake script which can be directly included into a CMake projects. It will then automatically be run on each build and you only have to #include the generated file.

Use with cmake (only C++)

Copy this repository into a subfolder of your project and include the cmake.cmake file in your CMakeLists.txt

INCLUDE(gitversion/cmake.cmake)
TARGET_GIT_VERSION_INIT(buildtarget)

Then, you can write in your source file:

#include <gitversion/version.h>
cout << version::VERSION_STRING << endl;
cout << version::IS_STABLE_VERSION << endl;
cout << version::GIT_COMMIT_ID << endl;
cout << version::GIT_COMMITS_SINCE_TAG << endl;
// ... (see below for more variables)

That's it already. Have fun :)

Use manually (C++ and Python)

Install from PyPi

To install the tool:

pip install git-version

To generate a version.h file containing C++ version information for the git repository located in myrepositorydir:

python -m gitversionbuilder --dir myrepositorydir --lang cpp version.h

Or to generate a module with version information for python:

python -m gitversionbuilder --dir myrepositorydir --lang python version.py

Run script from source tree

If you don't want to use PyPi, you can run the script directly from the source tree. Clone this repository and go to the src directory (or alternatively add the src directory to the PYTHONPATH environment variable), then call for example

python -m gitversionbuilder --dir myrepositorydir --lang cpp version.h

If you want to build a distribution of the package to use it somewhere else, you can use the standard python setuptools. A corresponding setup.py is available in the directory.

Available Information

Basic Information

The following table shows the basic variables that are always available.

Additional Information

We will parse the git tag name and provide additional information if you use the following versioning scheme for your git tag names:

/^v?[0-9]+(\.[0-9]+)*(-?((alpha|beta|rc|pre|m)[0-9]?|stable|final))?$/

In words, we support a set of numeric version components separated by a dot, then optionally a version tag like "alpha", "beta", "beta2", "rc2", "M3", "pre2", "stable", "final". The version tag can optionally be separated with a dash and the version number can optionally be prefixed with "v". The version tag is matched case insensitive. It is for example also allowed to write "RC" instead of "rc".

Examples for supported version numbers:

• 0.8.1
• v3.0
• 1.1-alpha
• 1.2alpha
• 1.4.3beta
• 1.4.3beta2
• 2.0-M2
• 4-RC2
• 3.0final
• 2.1-stable
• ...

If you use a version scheme supported by this, we will provide the following additional information