gitver

gitver is an open source, freely distributed, easy-to-use, simple and flexible command-line software that has been designed from the ground up to act as a version string management for Git, based on tags.

Generates Git version strings

In other words, the gitver program is capable of generating Git version strings simply by using a mix between repository information (augmented by user-defined data) and Python-based formatting rules.

Easily adopt versioning schemes

With gitver it’s very easy to adopt versioning schemes like Semantic Versioning. It also keeps version information up-to-date at all times. Sample output, as well as detailed information about how to use this tool is provided on the official homepage.

Getting started with gitver

To install this software on your GNU/Linux operating system, you must first install the Python and Git packages. Download the latest version of gitver from Softoware, save it on a location of your choice, extract it and open a terminal emulator.

Now, execute the “python setup.py instal” command (without quotes), as root or with sudo, to install gitver system wide and make it avaialble to all users on your Linux system. It is also possible to install it via pip, using the “pip2 install gitver” command, without quotes, of course.

After installation, you can use the gitver command from the terminal emulator or from a console environment, in case your operating system doesn’t have a graphical interface. Various options are available and can be viewed by running the “gitver --help” command (without quotes).

Under the hood and supported operating systems

As mentioned, the program is written entirely in the Python programming language, which means that it should work with any distribution of Linux, despite the fact that it has only been tested with a couple of distros. Both 32-bit and 64-bit architectures are supported at this time.

What is new in this release:

• Update README.md
• Fix commit_count in templates not being an empty string when 0

What is new in version 0.3.0:

• fixes lot of bugs
• much internal refactoring
• stdout and stderr streams now handled correctly
• renamed command "cleanall" to "clean-all"
• gitver's version string switched to the Semantic Versioning scheme
• adds custom version string formatting (see config file)
• adds new command "gitver preview" for previewing templates
• adds new "--quiet" and "--quiet-errors" flags
• adds new "current" command
• adds new "--colors" flag to switch coloring on/off, regardless of the configuration file
• adds new "check" command to perform basic .gitignore checking
• adds support for optional revision numbers (x.y.z.W)
• adds support for optional pre-release metadata in tags
• adds support for tags without a "v" prefix
• adds new "safe_mode", enabled by default
• adds new template variable placeholders
• updated configuration file, you should mvoe or remove the previous configuration file (at .gitver/config) and regenerate the new one with the "gitver init" command
• console colors disabled by default, better support for old terminal emulators

What is new in version 0.3.0 RC1:

• This version adds complete customization over the version string format using Python-based named parameters, support Semantic Versioning, and adds bugfixes.

Requirements:

• Python