Find version automatically based on git tags and commit messages.

Last update: Nov 07, 2021

Overview

GIT-CONVENTIONAL-VERSION

Find version automatically based on git tags and commit messages.

The tool is very specific in its function, so it is very flexible.

You can use it as a part of many different integrations and it will not break your process.

Install

python3 -m pip install git-conventional-version

Usage

Get new bumped final version:

gcv

Get new bumped release candidate version:

gcv --type=rc

Get current (old) version, 0.0.0 if none exists:

gcv --old

Example of CI automation script:

old=$(gcv --old)
new=$(gcv)
# check if version bump would happen
if [ ! $new == $old ]; then
    # if yes, update setup.cfg
    sed -i "s/^version.*/version = $new/g" setup.cfg
    # and commit release
    git add setup.cfg
    git commit -m "$new"
    git tag "$new"
    git push --tags
    git push
fi

Version formats

Tags are equivalent to versions, no suffix or prefix is added or interpreted. Formats follow https://www.python.org/dev/peps/pep-0440/.

Final version

Standard tag is in the format \d+\.\d+\.d+ ie. 1.0.0. It can be divided into major . minor . patch versions.

It is automatically bumped based on commits messages and old version of the same type (look at Git commit message convention below).

Pre-release versions

Pre-release versions bumps are calculated based on last final version, its expected bump and old version of the same pre-release type.

- Release candidate version

Format \d+\.\d+\.d+rc\d+ ie. 1.0.0rc1.

- Developmental version

Format \d+\.\d+\.d+dev\d+ ie. 1.0.0dev1.

Local version

Also, local version can be created from commit sha and old version: \d+\.\d+\.d\+.+ ie. 0.0.0+79ad.

Git commit message convention

Convention is based on https://www.conventionalcommits.org/en/v1.0.0/ (it's good!). At the moment, only the following rules apply (I usually use only these but more can be added easily):

Start commit with 'fix:' or 'fix(.*):' to bump patch version.
Start commit with 'feat:' or 'feat(.*):' to bump minor version.
Include in the commit line with 'breaking change:' to bump major version.

Notices

Automatically handling many types of version tags in git is more complicated than it initially seems like.

Comments

Fix tag comparison (numerical order)

Tag comparison was done using alphabetical ordering instead of numerical ordering. This won't work for releases that uses numbers over 9. Casting each version component to an int will force numerical ordering.

The bug can easily be reproduced by creating a dummy repository and adding tags "0.9.0" and "0.10.0". "0.9.0"will be seen as the latest by error.

opened by sgrimard 0

Find version automatically based on git tags and commit messages.

Related tags

Overview

GIT-CONVENTIONAL-VERSION

Install

Usage

Version formats

Git commit message convention

Notices

You might also like...

Python code to generate and store certificates automatically , using names from a csv file

Python script to launch burp scans automatically

Automatically Generate Rulesets for IIS for Intelligent HTTP/S C2 Redirection

Python utilities for writing cross-version compatible libraries

Create C bindings for python automatically with the help of libclang

An awesome tool to save articles from RSS feed to Pocket automatically.

Nmap script to guess* a GitLab version.

Early version for manipulate Geo localization data trough API REST.

This program organizes automatically files in folders named as file's extension

Comments

Fix tag comparison (numerical order)

Releases(1.0.2)

1.0.2(Oct 30, 2021)

Owner

Multipurpose Growtopia Server tools, can be used for newbie to learn things.

Python 3 script unpacking statically x86 CryptOne packer.

A color library based on pokemons colors!

A (very dirty) experiment to remove layers from a Docker image.

Yet another retry utility in Python

✨ Une calculatrice totalement faite en Python par moi, et en français.

Local backup made easy, with Python and shutil

Export watched content from Tautulli to the Letterboxd CSV Import Format

Backman is a random/fixed background image setter for wlroots based compositors

A simple python implementation of Decision Tree.

ColorController is a Pythonic interface for managing colors by english-language name and various color values.

Animation retargeting tool for Autodesk Maya. Retargets mocap to a custom rig with a few clicks.

A workflow management tool for numerical models on the NCI computing systems

Check username

extract gene TSS/TES site form gencode/ensembl/gencode database GTF file and export bed format file.

Simple script to export contacts from telegram into vCard file

Fraud Multiplication Table Detection in python

Utility to add/remove licenses to/from source files

Build capture utility for Linux

💉 코로나 잔여백신 예약 매크로 커스텀 빌드 (속도 향상 버전)