[](https://github.com/commitizen-tools/commitizen/actions)
[](https://conventionalcommits.org)
[](https://pypi.org/project/commitizen/)
[](https://pypi.org/project/commitizen/)
[](https://pypi.org/project/commitizen/)
[](https://formulae.brew.sh/formula/commitizen)
[](https://codecov.io/gh/commitizen-tools/commitizen)
[](https://github.com/pre-commit/pre-commit)
---
**Documentation:** [https://commitizen-tools.github.io/commitizen/](https://commitizen-tools.github.io/commitizen/)
---
## About
Commitizen is release management tool designed for teams.
Commitizen assumes your team uses a standard way of committing rules
and from that foundation, it can bump your project's version, create
the changelog, and update files.
By default, commitizen uses [conventional commits][conventional_commits], but you
can build your own set of rules, and publish them.
Using a standardized set of rules to write commits, makes commits easier to read, and enforces writing
descriptive commits.
### Features
- Command-line utility to create commits with your rules. Defaults: [Conventional commits][conventional_commits]
- Bump version automatically using [semantic versioning][semver] based on the commits. [Read More](./bump.md)
- Generate a changelog using [Keep a changelog][keepchangelog]
- Update your project's version files automatically
- Display information about your commit rules (commands: schema, example, info)
- Create your own set of rules and publish them to pip. Read more on [Customization](./customization.md)
## Requirements
[Python](https://www.python.org/downloads/) `3.8+`
[Git][gitscm] `1.8.5.2+`
## Installation
To make commitizen available in your system
```bash
pip install --user -U Commitizen
```
### Python project
You can add it to your local project using one of these:
```bash
pip install -U commitizen
```
for Poetry >= 1.2.0:
```bash
poetry add commitizen --group dev
```
for Poetry < 1.2.0:
```bash
poetry add commitizen --dev
```
### macOS
via [homebrew](https://formulae.brew.sh/formula/commitizen):
```bash
brew install commitizen
```
## Usage
Most of the time this is the only command you'll run:
```sh
cz bump
```
On top of that, you can use commitizen to assist you with the creation of commits:
```sh
cz commit
```
Read more in the section [Getting Started](./getting_started.md).
### Help
```sh
$ cz --help
usage: cz [-h] [--debug] [-n NAME] [-nr NO_RAISE] {init,commit,c,ls,example,info,schema,bump,changelog,ch,check,version} ...
Commitizen is a cli tool to generate conventional commits.
For more information about the topic go to https://conventionalcommits.org/
optional arguments:
-h, --help show this help message and exit
--config the path of configuration file
--debug use debug mode
-n NAME, --name NAME use the given commitizen (default: cz_conventional_commits)
-nr NO_RAISE, --no-raise NO_RAISE
comma separated error codes that won't rise error, e.g: cz -nr 1,2,3 bump. See codes at https://commitizen-
tools.github.io/commitizen/exit_codes/
commands:
{init,commit,c,ls,example,info,schema,bump,changelog,ch,check,version}
init init commitizen configuration
commit (c) create new commit
ls show available commitizens
example show commit example
info show information about the cz
schema show commit schema
bump bump semantic version based on the git log
changelog (ch) generate changelog (note that it will overwrite existing file)
check validates that a commit message matches the commitizen schema
version get the version of the installed commitizen or the current project (default: installed commitizen)
```
## Setting up bash completion
When using bash as your shell (limited support for zsh, fish, and tcsh is available), Commitizen can use [argcomplete](https://kislyuk.github.io/argcomplete/) for auto-completion. For this argcomplete needs to be enabled.
argcomplete is installed when you install Commitizen since it's a dependency.
If Commitizen is installed globally, global activation can be executed:
```bash
sudo activate-global-python-argcomplete
```
For permanent (but not global) Commitizen activation, use:
```bash
register-python-argcomplete cz >> ~/.bashrc
```
For one-time activation of argcomplete for Commitizen only, use:
```bash
eval "$(register-python-argcomplete cz)"
```
For further information on activation, please visit the [argcomplete website](https://kislyuk.github.io/argcomplete/).
## Sponsors
These are our cool sponsors!
<!-- sponsors --><!-- sponsors -->
[conventional_commits]: https://www.conventionalcommits.org
[semver]: https://semver.org/
[keepchangelog]: https://keepachangelog.com/
[gitscm]: https://git-scm.com/downloads
Raw data
{
"_id": null,
"home_page": "https://github.com/commitizen-tools/commitizen",
"name": "commitizen",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "commitizen, conventional, commits, git",
"author": "Santiago Fraire",
"author_email": "santiwilly@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/61/12/061e06fda5745421e5de4a8e0d09a21960f2e63e89f6603d8edc923eb906/commitizen-3.25.0.tar.gz",
"platform": null,
"description": "[](https://github.com/commitizen-tools/commitizen/actions)\n[](https://conventionalcommits.org)\n[](https://pypi.org/project/commitizen/)\n[](https://pypi.org/project/commitizen/)\n[](https://pypi.org/project/commitizen/)\n[](https://formulae.brew.sh/formula/commitizen)\n[](https://codecov.io/gh/commitizen-tools/commitizen)\n[](https://github.com/pre-commit/pre-commit)\n\n\n\n---\n\n**Documentation:** [https://commitizen-tools.github.io/commitizen/](https://commitizen-tools.github.io/commitizen/)\n\n---\n\n## About\n\nCommitizen is release management tool designed for teams.\n\nCommitizen assumes your team uses a standard way of committing rules\nand from that foundation, it can bump your project's version, create\nthe changelog, and update files.\n\nBy default, commitizen uses [conventional commits][conventional_commits], but you\ncan build your own set of rules, and publish them.\n\nUsing a standardized set of rules to write commits, makes commits easier to read, and enforces writing\ndescriptive commits.\n\n### Features\n\n- Command-line utility to create commits with your rules. Defaults: [Conventional commits][conventional_commits]\n- Bump version automatically using [semantic versioning][semver] based on the commits. [Read More](./bump.md)\n- Generate a changelog using [Keep a changelog][keepchangelog]\n- Update your project's version files automatically\n- Display information about your commit rules (commands: schema, example, info)\n- Create your own set of rules and publish them to pip. Read more on [Customization](./customization.md)\n\n## Requirements\n\n[Python](https://www.python.org/downloads/) `3.8+`\n\n[Git][gitscm] `1.8.5.2+`\n\n## Installation\n\nTo make commitizen available in your system\n\n```bash\npip install --user -U Commitizen\n```\n\n### Python project\n\nYou can add it to your local project using one of these:\n\n```bash\npip install -U commitizen\n```\n\nfor Poetry >= 1.2.0:\n\n```bash\npoetry add commitizen --group dev\n```\n\nfor Poetry < 1.2.0:\n\n```bash\npoetry add commitizen --dev\n```\n\n### macOS\n\nvia [homebrew](https://formulae.brew.sh/formula/commitizen):\n\n```bash\nbrew install commitizen\n```\n\n## Usage\n\nMost of the time this is the only command you'll run:\n\n```sh\ncz bump\n```\n\nOn top of that, you can use commitizen to assist you with the creation of commits:\n\n```sh\ncz commit\n```\n\nRead more in the section [Getting Started](./getting_started.md).\n\n### Help\n\n```sh\n$ cz --help\nusage: cz [-h] [--debug] [-n NAME] [-nr NO_RAISE] {init,commit,c,ls,example,info,schema,bump,changelog,ch,check,version} ...\n\nCommitizen is a cli tool to generate conventional commits.\nFor more information about the topic go to https://conventionalcommits.org/\n\noptional arguments:\n -h, --help show this help message and exit\n --config the path of configuration file\n --debug use debug mode\n -n NAME, --name NAME use the given commitizen (default: cz_conventional_commits)\n -nr NO_RAISE, --no-raise NO_RAISE\n comma separated error codes that won't rise error, e.g: cz -nr 1,2,3 bump. See codes at https://commitizen-\n tools.github.io/commitizen/exit_codes/\n\ncommands:\n {init,commit,c,ls,example,info,schema,bump,changelog,ch,check,version}\n init init commitizen configuration\n commit (c) create new commit\n ls show available commitizens\n example show commit example\n info show information about the cz\n schema show commit schema\n bump bump semantic version based on the git log\n changelog (ch) generate changelog (note that it will overwrite existing file)\n check validates that a commit message matches the commitizen schema\n version get the version of the installed commitizen or the current project (default: installed commitizen)\n```\n\n## Setting up bash completion\n\nWhen using bash as your shell (limited support for zsh, fish, and tcsh is available), Commitizen can use [argcomplete](https://kislyuk.github.io/argcomplete/) for auto-completion. For this argcomplete needs to be enabled.\n\nargcomplete is installed when you install Commitizen since it's a dependency.\n\nIf Commitizen is installed globally, global activation can be executed:\n\n```bash\nsudo activate-global-python-argcomplete\n```\n\nFor permanent (but not global) Commitizen activation, use:\n\n```bash\nregister-python-argcomplete cz >> ~/.bashrc\n```\n\nFor one-time activation of argcomplete for Commitizen only, use:\n\n```bash\neval \"$(register-python-argcomplete cz)\"\n```\n\nFor further information on activation, please visit the [argcomplete website](https://kislyuk.github.io/argcomplete/).\n\n## Sponsors\n\nThese are our cool sponsors!\n\n<!-- sponsors --><!-- sponsors -->\n\n[conventional_commits]: https://www.conventionalcommits.org\n[semver]: https://semver.org/\n[keepchangelog]: https://keepachangelog.com/\n[gitscm]: https://git-scm.com/downloads\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python commitizen client tool",
"version": "3.25.0",
"project_urls": {
"Homepage": "https://github.com/commitizen-tools/commitizen"
},
"split_keywords": [
"commitizen",
" conventional",
" commits",
" git"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "08c28f8ca93e8d8fecb13b5b66efaa2156f1555bf4a6592de63b0b1bc9ba9d0a",
"md5": "9c071371226df058b5c670f46d3c708a",
"sha256": "46b7f2a5a846df7414440d069aaa43b5d6c5a7f8840e68ae4c541492e93cd086"
},
"downloads": -1,
"filename": "commitizen-3.25.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9c071371226df058b5c670f46d3c708a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 70173,
"upload_time": "2024-04-30T06:51:15",
"upload_time_iso_8601": "2024-04-30T06:51:15.508186Z",
"url": "https://files.pythonhosted.org/packages/08/c2/8f8ca93e8d8fecb13b5b66efaa2156f1555bf4a6592de63b0b1bc9ba9d0a/commitizen-3.25.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "6112061e06fda5745421e5de4a8e0d09a21960f2e63e89f6603d8edc923eb906",
"md5": "2a7fbbfb321ac55df842cff039f0fc56",
"sha256": "65c9c5114ac2ded5ab1e1a75c2540adc27ae7291ed2db9290f9ed208178d1e99"
},
"downloads": -1,
"filename": "commitizen-3.25.0.tar.gz",
"has_sig": false,
"md5_digest": "2a7fbbfb321ac55df842cff039f0fc56",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 49619,
"upload_time": "2024-04-30T06:51:19",
"upload_time_iso_8601": "2024-04-30T06:51:19.338197Z",
"url": "https://files.pythonhosted.org/packages/61/12/061e06fda5745421e5de4a8e0d09a21960f2e63e89f6603d8edc923eb906/commitizen-3.25.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-30 06:51:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "commitizen-tools",
"github_project": "commitizen",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "commitizen"
}
JSON
