commitizen/docs/third-party-commitizen.md

Third-Party Commitizen Templates

In addition to the native templates, some alternative commit format templates are available as PyPI packages (installable with pip).

Conventional JIRA

Just like conventional commit format, but the scope has been restricted to a JIRA issue format, i.e. project-issueNumber. This standardises scopes in a meaningful way.

Installation

pip install conventional-JIRA

GitHub JIRA Conventional

This plugin extends the commitizen tools by:

• requiring a JIRA issue id in the commit message
• creating links to GitHub commits in the CHANGELOG.md
• creating links to JIRA issues in the CHANGELOG.md

Installation

pip install cz-github-jira-conventional

For installation instructions (configuration and pre-commit) please visit https://github.com/apheris/cz-github-jira-conventional

cz-emoji

conventional commit format, but with emojis

Installation

pip install cz-emoji

Usage

cz --name cz_emoji commit

cz-conventional-gitmoji

conventional commits, but with gitmojis.

Includes a pre-commit hook that automatically adds the correct gitmoji to the commit message based on the conventional type.

Installation

pip install cz-conventional-gitmoji

Usage

cz --name cz_gitmoji commit

Commitizen emoji (Unmaintained)

Just like conventional commit format, but with emojis and optionally time spent and related tasks.

Installation

pip install commitizen-emoji

Usage

cz --name cz_commitizen_emoji commit

Conventional Legacy (cz_legacy)

An extension of the conventional commit format to include user-specified legacy change types in the CHANGELOG while preventing the legacy change types from being used in new commit messages

Installation

pip install cz_legacy

Usage

See the README for instructions on configuration

Third-Party Commitizen Providers

Commitizen can read and write version from different sources. In addition to the native providers, some alternative version sources are available as PyPI packages (installable with pip).

commitizen-deno-provider

A provider for Deno projects. The provider updates the version in deno.json and jsr.json files.

Installation

pip install commitizen-deno-provider

Usage

Add deno-provider to your configuration file.

Example for .cz.yaml:

---
commitizen:
  major_version_zero: true
  name: cz_conventional_commits
  tag_format: $version
  update_changelog_on_bump: true
  version_provider: deno-provider
  version_scheme: semver