Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Python commitizen client tool

Project description

Python 3 command line utility to standardize commit messages and bump version
Travis Conventional Commits PyPI Package latest release Supported versions Codecov Example running commitizen



Commitizen is a tool designed for teams.

Its main purpose is to define a standard way of commiting rules and communicating it (using the cli provided by commitizen).

The reasoning behind it is that is easier to read, and enforces writing descriptive commits.

Besides that, having a convetion on your commits, makes it possible to parse them and use them for something else, like generating automatically the version or a changelog.


pip install -U commitizen
poetry add commitizen --dev

Global installation

sudo pip3 install -U commitizen


  • Command line utility to create commits with your rules. Defaults: conventional commits
  • Display information about your commit rules (commands: schema, example, info)
  • Bump version automatically using semantic verisoning based on the commits. Read More
  • Generate a changelog using “Keep a changelog” (Planned feature)

Commit rules

This client tool prompts the user with information about the commit.

Based on conventional commits

This is an example of how the git messages history would look like:

fix: minor typos in code
feat: new command update
docs: improved commitizens tab in readme
feat(cz): jira smart commits
refactor(cli): renamed all to ls command
feat: info command for angular
docs(README): added badges
docs(README): added about, installation, creating, etc
feat(config): new loads from ~/.cz and working project .cz .cz.cfg and setup.cfg

And then using cz bump you can change the version of your project

feat to MINOR fix to PATCH


These are the available commiting styles by default:

The installed ones can be checked with:

cz ls


Run in your terminal

cz commit

or the shortcut

cz c


$ cz --help
usage: cz [-h] [--debug] [-n NAME] [--version]
        {ls,commit,c,example,info,schema,bump} ...

Commitizen is a cli tool to generate conventional commits.
For more information about the topic go to

optional arguments:
-h, --help            show this help message and exit
--debug               use debug mode
-n NAME, --name NAME  use the given commitizen
--version             get the version of the installed commitizen

    ls                  show available commitizens
    commit (c)          create new commit
    example             show commit example
    info                show information about the cz
    schema              show commit schema
    bump                bump semantic version based on the git log


Feel free to create a PR.

  1. Clone the repo.
  2. Add your modifications
  3. Create a virtualenv
  4. Run ./scripts/test

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for commitizen, version 1.8.0
Filename, size File type Python version Upload date Hashes
Filename, size commitizen-1.8.0-py3-none-any.whl (22.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size commitizen-1.8.0.tar.gz (18.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page