Commitizen plugin for better changelog generation
Project description
cz-changeup
This plugin is a version of Commitizen's default conventional style that provides more flexibility in the changelog format.
Installation
With pip:
pip install cz-changeup
With conda:
conda install -c conda-forge cz-changeup
Configuration
Add to your pyproject.toml:
[tool.commitizen]
name = "cz_changeup"
The behavior of the plugin can be customized by providing the following options under tool.commitizen:
| Option | Description | Default |
|---|---|---|
changeup_repo_base_url |
The base URL for the repository, for instance "https://github.com/my/repo". |
"" |
changeup_show_hash |
Whether to add a link to the commit for each entry in the changelog. If changeup_repo_base_url is provided, the hash are linked to the commit. |
true |
changeup_show_hash_breaking |
Whether to add a link to the commit also for descriptions in the breaking changes section. | true |
changeup_show_body |
Whether to include the commit body in the changelog. | true |
changeup_hide_breaking |
Whether to include the breaking changes section also in the the commit body if changeup_show_body is true. This prevents duplicate entries. |
true |
changeup_body_indent |
The number of spaces to indent the commit body if changeup_show_body is set to true. |
2 |
changeup_link_issues |
If true, tries to convert issue numbers in phrases like closes #21 to links. Only works if changeup_repo_base_url is provided. |
true |
changeup_link_external_issues |
If true, tries to convert external issue numbers like user/repo/#123 to links. Currently only supports github links. |
true |
changeup_scope_prefix |
Prefix for the scope of the change. | "**" |
changeup_scope_suffix |
Suffix for the scope of the change. | "**" |
changeup_scope_separator |
Separator between the scope and the message. | ": " |
Project details
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 cz_changeup-1.1.2.tar.gz.
File metadata
- Download URL: cz_changeup-1.1.2.tar.gz
- Upload date:
- Size: 8.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.0.1 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f3876c32b558cb6e15a9bf8b69b7de840e90a79c0f4765439f4a9f13d4e004f2
|
|
| MD5 |
020dc0663ea1d7be28cdaffcf50e7ffc
|
|
| BLAKE2b-256 |
1954e98511cf11c4a12268a13f28714227b510d1f166e44f5cd2fd234e9297ab
|
Provenance
The following attestation bundles were made for cz_changeup-1.1.2.tar.gz:
Publisher:
release.yml on kmnhan/cz-changeup
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cz_changeup-1.1.2.tar.gz -
Subject digest:
f3876c32b558cb6e15a9bf8b69b7de840e90a79c0f4765439f4a9f13d4e004f2 - Sigstore transparency entry: 156188620
- Sigstore integration time:
-
Permalink:
kmnhan/cz-changeup@402aa918ce549d8fed9e4c49649dc3c7e6c8ee49 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/kmnhan
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@402aa918ce549d8fed9e4c49649dc3c7e6c8ee49 -
Trigger Event:
push
-
Statement type:
File details
Details for the file cz_changeup-1.1.2-py3-none-any.whl.
File metadata
- Download URL: cz_changeup-1.1.2-py3-none-any.whl
- Upload date:
- Size: 5.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.0.1 CPython/3.12.8
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
938a3715cfc248e824b2ac5985b94a0cd1c505d201d8d67289fd1005e8465ec3
|
|
| MD5 |
c0b245117a02e37d520565203cd88062
|
|
| BLAKE2b-256 |
9f38170eab7c366e42df418486172d136b209b5208f5c04d2008d1be9b27d261
|
Provenance
The following attestation bundles were made for cz_changeup-1.1.2-py3-none-any.whl:
Publisher:
release.yml on kmnhan/cz-changeup
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cz_changeup-1.1.2-py3-none-any.whl -
Subject digest:
938a3715cfc248e824b2ac5985b94a0cd1c505d201d8d67289fd1005e8465ec3 - Sigstore transparency entry: 156188621
- Sigstore integration time:
-
Permalink:
kmnhan/cz-changeup@402aa918ce549d8fed9e4c49649dc3c7e6c8ee49 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/kmnhan
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@402aa918ce549d8fed9e4c49649dc3c7e6c8ee49 -
Trigger Event:
push
-
Statement type: