Auto-tag GitLab repos with semantic version tags — one tool, two strategies.
Project description
semvertag
Auto-tag your GitLab repository with semantic version tags from CI — one tool, two strategies.
Install
uvx semvertag tag
Use it in GitLab CI
Include the Catalog component in your .gitlab-ci.yml:
include:
- component: gitlab.com/modern-python/semvertag/semvertag@v0.1.0
inputs:
strategy: branch-prefix # or: conventional-commits
The component runs uvx semvertag tag against your repo on the
default branch. semvertag inspects the latest commit + tag history,
decides the appropriate semver bump, and creates the new tag via the
GitLab API.
Strategies
- branch-prefix (default): the latest commit on the default branch
must be a merge commit whose source branch starts with
feature/(minor),bugfix/, orhotfix/(patch). - conventional-commits: parses the latest commit's
Conventional Commits
header (
feat:minor,fix:/perf:patch,!orBREAKING CHANGE:major).
Both are configurable via env vars. See docs for the full configuration surface.
License
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file semvertag-0.1.0.tar.gz.
File metadata
- Download URL: semvertag-0.1.0.tar.gz
- Upload date:
- Size: 12.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2ca4f59b1b0ba5792e3ea309119b55427815f8c1b4c3b45fbdba8a63d74a83d1
|
|
| MD5 |
a1e01c0716e7251cfb62a2d6a558d32d
|
|
| BLAKE2b-256 |
4c3426d475ae41550f90a936256444d40f016c6655081a95b96f4cf7e3b39dc0
|
File details
Details for the file semvertag-0.1.0-py3-none-any.whl.
File metadata
- Download URL: semvertag-0.1.0-py3-none-any.whl
- Upload date:
- Size: 18.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.17 {"installer":{"name":"uv","version":"0.11.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3992e8c495aed91e40384de46fb91ee19f6e2bf1fbea3477ce7059a09dad3349
|
|
| MD5 |
85505ebcdc1f24b84bde2910fe2a1cb9
|
|
| BLAKE2b-256 |
688c8e54356f95b1530e20f1495be2f21a486546fa0cb998c3326881fc8fec79
|
