semtag 0.2.0

A tool for managing semantic version tags in git repositories

Semantic Version GIT Tagger

A pretty trivial python script to easily manage git tags with semantic versioning (semver.org)

Usage

semtag [options]

Options

• -p, --patch - Increment patch version (x.x.PATCH)
• -m, --minor - Increment minor version (x.MINOR.0)
• -M, --major - Increment major version (MAJOR.0.0)
• -b, --by - Increment by a specific number (default: 1)
• -l, --label - Add label to the version (e.g., -l rc1 creates 1.0.0-rc1)
• -u, --push - Push the new tag to remote repository
• -U, --pushall - Push all local tags to remote repository
• -n, --nofetch - Do not fetch tags from remote prior creating new one

• -v, --verbose - Increase verbosity (use -v or -vv for more detail (INFO,DEBUG))

Examples

# Increment minor version (1.0.0 -> 1.1.0)
semtag -m

# Increment major version (1.0.0 -> 2.0.0)
semtag -M

# Increment patch version (1.0.0 -> 1.0.5)
semtag -p -b 5

# Increment patch and add label (1.0.0 -> 1.0.1-rc1), don't fetch and push new tag
semtag -n -u -p -l rc1

Installation

Using pip (preferred)

pip install semtag

From git

git clone https://github.com/mateuszmikrut/semtag.git
cd semtag
python -m venv venv
source ./venv/bin/activate
pip install -r requirements.txt
python ./semtag.py

Supported Version Formats

The script supports semantic versioning with the following formats:

• v1.0.0 (with 'v' prefix)
• 1.0.0 (without prefix)
• 1.0.0-rc1 (with prerelease label)

When incrementing versions, prerelease labels are automatically removed.