hatch-regex-commit
This provides a plugin for Hatch that automatically creates a Git commit and tag after version bumping.
Global dependency
Ensure hatch-regex-commit is defined within the build-system.requires field in your pyproject.toml file.
[build-system]
requires = ["hatchling", "hatch-regex-commit"]
build-backend = "hatchling.build"
Version source
The version source plugin name is regex_commit.
-
pyproject.toml
[tool.hatch.version] source = "regex_commit" path = "my_library/___about___.py"
-
hatch.toml
[version] source = "regex_commit" path = "my_library/___about___.py"
Version source options
This plugin inherits from the Hatch builtin Regex version source. It inherits from all its options and add the following ones:
| Option | Type | Default | Description |
|---|---|---|---|
check_dirty |
bool |
true | Check if the Git repository is dirty, e.g., you have uncommited changes. If you have, the version bumping will abort. |
commit |
bool |
true | Whether to create a Git commit. |
commit_message |
str |
Bump version {current_version} → {new_version} |
Template of the Git commit message. |
commit_extra_args |
list[str] |
[] | List of extra arguments for Git commit command. |
tag |
bool |
true | Whether to create a Git tag. |
tag_name |
str |
v{new_version} |
Template for the Git tag name. |
tag_message |
str |
Bump version {current_version} → {new_version} |
Template of the Git tag message. |
tag_sign |
bool |
true | Whether to sign the Git tag. |
Examples
Basic
[tool.hatch.version]
source = "regex_commit"
path = "my_library/___about___.py"
Custom commit message
[tool.hatch.version]
source = "regex_commit"
path = "my_library/___about___.py"
commit_message = "🚀 Version {new_version}"
Edit commit message in the editor before proceeding
[tool.hatch.version]
source = "regex_commit"
path = "my_library/___about___.py"
commit_extra_args = ["-e"]
Disable Git tag
[tool.hatch.version]
source = "regex_commit"
path = "my_library/___about___.py"
tag = false
License
hatch-regex-commit is distributed under the terms of the MIT license.
Metadata
Release files for hatch-regex-commit 0.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| hatch_regex_commit-0.0.4.tar.gz | 6.2 kB | Without provenance | Details for hatch_regex_commit-0.0.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| hatch_regex_commit-0.0.4-py3-none-any.whl | Python 3 | none | any | Details for hatch_regex_commit-0.0.4-py3-none-any.whl |
Total release size: 12.9 kB
Release files / hatch_regex_commit-0.0.4.tar.gz
| Download URL | hatch_regex_commit-0.0.4.tar.gz |
|---|---|
| Size | 6.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ccf5c0ddc9040233328a16cf727700406485f22a5307683cce0ac82e24e44689
|
|
BLAKE2b-256 checksum How to use checksums |
e80aa3f18ecffc9629fca96ca58e4d764a6ef2c07f5f536e35eb0ceb36728c7d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-httpx/0.28.1
|
Release files / hatch_regex_commit-0.0.4-py3-none-any.whl
| Download URL | hatch_regex_commit-0.0.4-py3-none-any.whl |
|---|---|
| Size | 6.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3094a7ddf7e4dbdf9a3cbaeadeacfb187b2bf29ee232602c8fd735ceee90bbe5
|
|
BLAKE2b-256 checksum How to use checksums |
3c01a6639792060d304d9485d4ba584c42de0ea3e02fa92ade43bb1baa60ab38
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
python-httpx/0.28.1
|
Security for hatch-regex-commit 0.0.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.