hatch-regex-commit
Hatch plugin to create a commit and tag when bumping version
Decision gist · record as of 2026-08-14
Yes, if you use Hatch and want to eliminate manual Git commits and tags during version bumps. The plugin is stable enough for production (Beta status, no known vulnerabilities), has low install friction, and solves a real workflow problem. The aging maintenance status (319 days since last release) is a minor concern but not a blocker—the repository is not archived and the plugin's scope is narrow. Install it if your release process would benefit from automated Git integration; skip it if you prefer manual control or use a different version-management approach.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Git to be installed and your project to be in a Git repository; the plugin will abort if the repository has uncommitted changes (configurable via check_dirty option).
- Low install friction; depends only on hatchling.
- Maintenance status is aging—last release was 319 days ago, though the repository remains active and the project is in Beta development status.
License · maintenance · safety
MIT (permissive) — MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for both open-source and commercial projects.
last release 2025-09-29 (319 days) · last repo commit 2025-09-29 · 11 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 91,309 downloads/mo, #13,525 on PyPI
Alternatives
Verify before relying
# Add to pyproject.toml
[build-system]
requires = ["hatchling", "hatch-regex-commit"]
build-backend = "hatchling.build"
[tool.hatch.version]
source = "regex_commit"
path = "my_library/__about__.py"
# Then run: hatch version patch- Whether the plugin works with all Hatch versions or has specific version constraints beyond what the fact sheet indicates.
- Performance impact or any known issues when used with large repositories or frequent version bumps.
- Compatibility with CI/CD systems and whether GPG signing of tags works reliably across different environments.
What it is and what it does
hatch-regex-commit is a Hatch build-system plugin that extends Hatch's version-bumping workflow to automatically create Git commits and tags. It inherits from Hatch's built-in regex version source, allowing you to bump versions stored in source files (like `__about__.py`) while simultaneously creating corresponding Git artifacts. The plugin runs during the version-bump operation and can be configured to customize commit messages, tag names, tag signing, and other Git options.
You install it as a build-system dependency in `pyproject.toml`, configure it in your Hatch version settings, and then use standard Hatch version commands (e.g., `hatch version patch`). The plugin checks for uncommitted changes by default, creates a commit with a templated message, and optionally signs and tags the commit—all in one operation. It's designed for teams that want version control and release artifacts to stay in sync without manual Git commands.
Use it for
- Automate release workflows where version bumps must be immediately committed and tagged in Git.
- Enforce clean repository state before version changes to prevent accidental partial commits.
- Customize commit and tag messages with project-specific templates or emoji conventions.
- Sign Git tags automatically during version bumps for cryptographic release verification.
- Integrate version management into CI/CD pipelines that rely on Git tags for deployment triggers.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you use Hatch and want to eliminate manual Git commits and tags during version bumps.
The plugin is stable enough for production (Beta status, no known vulnerabilities), has low install friction, and solves a real workflow problem. The aging maintenance status (319 days since last release) is a minor concern but not a blocker—the repository is not archived and the plugin's scope is narrow. Install it if your release process would benefit from automated Git integration; skip it if you prefer manual control or use a different version-management approach.
Install
hatch-regex-commit on PyPI
Before you install
Low install friction; depends only on hatchling. Maintenance status is aging—last release was 319 days ago, though the repository remains active and the project is in Beta development status.
Requires Git to be installed and your project to be in a Git repository; the plugin will abort if the repository has uncommitted changes (configurable via check_dirty option).
License in practice
MIT license permits unrestricted use, modification, and distribution with minimal obligations—suitable for both open-source and commercial projects.
Quickstart
# Add to pyproject.toml
[build-system]
requires = ["hatchling", "hatch-regex-commit"]
build-backend = "hatchling.build"
[tool.hatch.version]
source = "regex_commit"
path = "my_library/__about__.py"
# Then run: hatch version patchVerify before relying
- Whether the plugin works with all Hatch versions or has specific version constraints beyond what the fact sheet indicates.
- Performance impact or any known issues when used with large repositories or frequent version bumps.
- Compatibility with CI/CD systems and whether GPG signing of tags works reliably across different environments.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 1 packagehatchling |
| Maintenance | Aging 319 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 91,309 / month, #13,525 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaFramework :: HatchProgramming Language :: PythonProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy |
Evidence: hatch_regex_commit-0.0.4-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “hatch version bump git commit”
- hatch-regex-commitA Hatch plugin that automatically creates Git commits and tags when…
- hatch-vcsA Hatch plugin that automatically determines your project's version…
- commitizenCommitizen enforces standardized commit messages and automates…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also hatch-vcs · hatchling-autoextras-hook · bump2version · tbump · hatch-nodejs-version · bumpversion · bump-my-version · hatch-fancy-pypi-readme · hatch-jupyter-builder · hatch-requirements-txt