CHANGELOG.md

## v4.11.1 (2026-01-03)

### Fix

- **providers**: normalize package names in uv provider for uv.lock matching

## v4.11.0 (2025-12-29)

### Feat

- Drop support for Python 3.9 as EOL reached and add Python 3.14 support
- add custom validation

## v4.10.1 (2025-12-11)

### Fix

- **version**: fix the behavior of cz version --major
- **cli**: debug and no_raise can be used together in sys.excepthook
- **git**: replace lstrip with strip for compatibility issue
- **bump**: remove NotAllowed related to --get-next option, other related refactoring

### Refactor

- **version**: rename class member to align with other classes
- **cargo_provider**: cleanup and get rid of potential type errors
- **bump**: extract option validation and new version resolution to new functions
- **changelog**: raise NotAllow when file_name not passed instead of using assert
- **bump**: rename parameter and variables

### Perf

- **ruff**: enable ruff rules TC001~TC006
- add TYPE_CHECKING to CzQuestion imports

## v4.10.0 (2025-11-10)

### Feat

- add config option for line length warning
- **conventional_commits**: allow exclamation in title on BC
- **version**: add the ability to just print major or minor version
- allow `amend!` prefix as created by `git --fixup=reword:<commit>`

### Fix

- **commands/version**: add missing return
- **test**: set terminal width for cli tests
- **Init**: raise InitFailedError on keyboard interrupt on pre-commit hook question, simplify logic, remove unreachable code path

### Refactor

- **bump**: cleanup related to update_version_file
- **RestructuredTest**: rename variable, fix typo and remove unnecessary string copy
- **TomlConfig**: minor cleanups for DX
- **Commit**: refactor _prompt_commit_questions and fix some type hint
- **hooks**: refactor to improve readability
- **Init**: make project_info a module and remove self.project_info
- **BaseConfig**: update docstring, extract factory method and remove unnecessary variable assignment
- remove self.encoding for better maintainability
- **utils**: make get_backup_file_path to return a path for semantic correctness
- remove unnecessary class member tag_format
- **Bump**: remove use of getattr
- **ConventionalCommitsCz**: rewrite message method to make the pattern more clear
- **cmd**: unnest try except
- **BaseCommitizen**: remove NotImplementedError and make them abstract method
- **BaseCommitizen**: construct Style object directly to get rid of potential type error

## v4.9.1 (2025-09-10)

### Fix

- **dependency**: move deprecated to project.dependencies

## v4.9.0 (2025-09-09)

### Feat

- **check**: add check against default branch

### Fix

- **changelog**: mark get_smart_tag_range as deprecated
- **init**: use pre-push as pre-commit stage
- **init**: use pre-push as pre-commit stage
- **init**: make welcome message easier to read
- **Init**: fix a typo in _ask_version_provider options and remove unnecessary filter, use named tuple for options
- **ExitCode**: add from_str in ExitCode and replace parse_no_raise with it
- raise NoVersionSpecifiedError if version is None, and adjust call sites of get_version
- **Changelog**: fix _export_template variable type
- **Bump**: rewrite --get-next NotAllowed error message for consistency

### Refactor

- **changelog**: add get_next_tag_name_after_version and test, mark unused for get_smart_tag_range
- **changelog**: simplify logic for get_oldest_and_newest_rev
- **changelog**: shorten generate_tree_from_commits
- **Init**: remove the variable values_to_add and the update_config function for readability
- **Init**: remove unnecessary methods from ProjectInfo and refactor _ask_tag
- **Init**: fix unbounded variable in _ask_tag_format
- **init**: remote extra words
- **process_commit_message**: better type and early return
- **Init**: extract _get_config_data for readability
- **changelog**: shorten condition expression and early return
- **Changelog**: remove unnecessary intermediate variables for better readability
- **bump**: use a loop to shorten a series of similar NotAllowed exceptions
- **Init**: use ternary operator
- **TagRules**: extract tag_formats property and simplify list comprehension
- **git**: remove redundant if branch
- **ScmProvider**: replace sorted with max
- **ExpectedExit**: make the constructor more compact
- **ParseArgs**: simplify __call__ function body

## v4.8.4 (2025-09-05)

### Fix

- members in workspace, use exclude
- cargo workspaces

### Refactor

- reduce code indentation

## v4.8.3 (2025-06-09)

### Fix

- **cli**: update description for deprecate warning
- **commit**: emit deprecated warning of cz commit -s
- **Check**: make parameters backward compatible
- **BaseConfig**: mypy error
- **deprecated**: mark deprecate in v5
- **defaults**: add non-capitalized default constants back and deprecated warning

### Refactor

- **jira**: refactor message
- **conventional_commits**: use TypedDict for answers
- **conventional_commits**: make schema_pattern more readable
- do not guess if changelog format is provided
- **check**: compile once and rename variable
- **questions**: type questions with TypedDict
- **bump**: simplify nested if
- **git**: retype get_commits parameter to make it more friendly to call sites
- **git**: simplify tag logic
- **bump**: eliminate similar patterns in code
- **bump**: use any to replace 'or' chain
- remove unnecessary bool() and remove Any type from TypedDict get
- **bump**: improve readability and still bypass mypy check
- **commands**: remove unused args, type version command args
- **commit**: type commit args
- **check**: type CheckArgs arguments
- **check**: remove unused argument
- **changelog**: type untyped arguments
- **bump**: TypedDict for bump argument
- make methods protected, better type
- **conventional_commits**: remove unnecessary checks
- fix mypy output and better type
- **BaseCommitizen**: remove unused process_commit
- remove `TypeError` handling since `Python >=3.9` is required
- add comment clarifying `no_raise` parsing to `list[int]`
- **cli.py**: add type hints
- **mypy**: remove `unused-ignore`
- **changelog**: better typing, yield
- **cli**: early return and improve test coverage
- **git**: extract _create_commit_cmd_string
- misc cleanup
- **bump**: clean up
- **bump**: add type for out, replace function with re escape
- **BaseConfig**: use setter
- **changelog**: minor cleanup
- **git**: refactor get_tag_names
- **EOLType**: add eol enum back and reorganize methods
- **git**: code cleanup and better test coverage
- **commit**: simplify call
- **version_scheme**: cleanup
- improve readability and fix typos

### Perf

- **bump**: avoid unnecessary list construction and rename variable to avoid confusion
- **tags**: use set

## v4.8.2 (2025-05-22)

### Refactor

- **check**: simplify code
- **check**: remove unnecessary variable

## v4.8.1 (2025-05-22)

### Refactor

- **customize**: improve code readability

## v4.8.0 (2025-05-20)

### Feat

- **cli**: add --tag-format argument to changelog command

## v4.7.2 (2025-05-18)

### Refactor

- **default**: capitalize all constants and remove unnecessary variable

## v4.7.1 (2025-05-16)

### Fix

- **bump**: don't fail if an invalid version tag is present (fix #1410) (#1418)

## v4.7.0 (2025-05-10)

### Feat

- **providers**: add support for `Cargo.lock`

### Refactor

- **tests**: increase verbosity of variables

## v4.6.3 (2025-05-07)

### Fix

- **changelog.py**: cross-platform path handling using os.path.join and modify the path linter and test parameter
- **changelog.py**: modify the CHANGELOG.md generated by cz bump --changelog to the right place

## v4.6.2 (2025-05-05)

### Fix

- **docs**: fix url link and table formatting in the customization docs (#1399)

## v4.6.1 (2025-05-05)

### Fix

- **commit**: use os.unlink to remove temp file

## v4.6.0 (2025-04-13)

### Feat

- **changelog**: expose commit parents' digests when processing commits
- **git**: add parents' digests in commit information

## v4.5.1 (2025-04-09)

### Fix

- print which tag is invalid

## v4.5.0 (2025-04-04)

### Feat

- **init**: set uv to default value if both pyproject.toml and uv.lock present

### Fix

- **commands/init**: add missing uv provider to "cz init"

## v4.4.1 (2025-03-02)

### Fix

- **tags**: fixes ImportError on Python >=3.11 (#1363) (#1364)

## v4.4.0 (2025-03-02)

### Feat

- **tags**: adds `legacy_tag_formats` and `ignored_tag_formats` settings

### Refactor

- **get_tag_regexes**: dedup tag regexes definition

## v4.3.0 (2025-02-28)

### Feat

- **providers**: add uv_provider

## v4.2.2 (2025-02-18)

### Fix

- **bump**: manual version bump if prerelease offset is configured

## v4.2.1 (2025-02-08)

### Fix

- **bump**: add debugging to bump

## v4.2.0 (2025-02-07)

### Feat

- draft of the --empty parameter

### Refactor

- **bump**: rename --empty as --allow-no-commit

## v4.1.1 (2025-01-26)

### Fix

- **get-next-bump**: add a test case
- **get-next-bump**: fix to permit usage of --get-next options even when update_changelog_on_bump is set to true

## v4.1.0 (2024-12-06)

### Feat

- **commit**: allow '-- --allow-empty' to create empty commits

## v4.0.0 (2024-11-26)

## v3.31.0 (2024-11-16)

### Feat

- **commitizen**: document '--' double dash in '--help'

### Fix

- **commit**: avoid warnings with 'always_signoff' configuration
- **commit**: resolve 'always_signoff' configuration and '-s' CLI issues

## v3.30.1 (2024-11-10)

### Refactor

- **cli**: replace magic number 0 with ExitCode.EXPECTED_EXIT
- **defaults**: disallow style as None
- **cz_customize**: return empty string for info, example, schema and schema_pattern if not provided

## v3.30.0 (2024-10-23)

### Feat

- **commands/commit**: add force-edit functionality after answering questions

### Refactor

- remove redundant return None

## v3.29.1 (2024-09-26)

### Fix

- **changelog**: Factorized TAG_FORMAT_REGEXES
- **changelog**: Handle tag format without version pattern
- **changelog**: handle custom tag_format in changelog generation

### Refactor

- Use format strings

## v3.29.0 (2024-08-11)

### Feat

- **bump**: add functionality to write the next version to stdout

## v3.28.0 (2024-07-17)

### Feat

- add argument to limit length of commit message in checks

## v3.27.0 (2024-05-22)

### Feat

- **config_files**: add support for "cz.toml" config file

## v3.26.2 (2024-05-22)

### Fix

- **base.py**: add encoding when open changlelog_file

## v3.26.1 (2024-05-22)

### Fix

- **cli/commands**: add description for subcommands

### Refactor

- **KNOWN_SCHEMES**: replace set comprehension for list comprehension
- **tests/commands**: move "other" tests for the correspondent file

## v3.26.0 (2024-05-18)

### Feat

- **ci/cd**: automates the generation of CLI screenshots

## v3.25.1 (2024-05-15)

### Refactor

- strip possessive from note about ci option

## v3.25.0 (2024-04-30)

### Feat

- add an argument to limit the length of commit message

### Fix

- strip the commit message for calculating length
- resolve test error by removing defaults

### Refactor

- **commands/commit**: replace comparison with chained comparison
- check the length in Commit instead of Commitizen

## v3.24.0 (2024-04-18)

### Feat

- **schemes**: adds support for SemVer 2.0 (dot in pre-releases) (fix #1025) (#1072)

## v3.23.0 (2024-04-18)

### Feat

- **bump**: `version_files` now support glob patterns (fix #1067) (#1070)

## v3.22.0 (2024-04-11)

### Feat

- **cli**: add config option to specify config file path

## v3.21.3 (2024-03-30)

### Refactor

- **defaults**: move cz_conventional_commit defaults out of defaults.py

## v3.21.2 (2024-03-30)

### Fix

- **commitizen/git.py,-tests/test_git.py**: Resolve tempfile path spaces issue in git commit function

## v3.21.1 (2024-03-30)

### Fix

- **command-init**: "cz init" should list existing tag in reverse order

## v3.21.0 (2024-03-30)

### Feat

- **commit**: add retry_after_failure config option and --no-retry flag

### Refactor

- **utils**: convert git project root to posix path for backup file name
- **commit**: use Optional[str] instead of str | None
- **commit**: remove unused tempfile import
- **git-hooks**: make git hooks use get_backup_file_path
- **utils**: move backup path creation to utils

## v3.20.0 (2024-03-19)

### Feat

- **changelog**: expose commits `sha1`, `author` and `author_email` in changelog tree (fix #987) (#1013)

## v3.19.0 (2024-03-19)

### Feat

- **changelog**: adds a `changelog_release_hook` called for each release in the changelog (#1018)

## v3.18.4 (2024-03-14)

### Fix

- **changelog**: include latest change when dry run and incremental

## v3.18.3 (2024-03-11)

### Fix

- **warnings**: all warnings should go to `stdout`

## v3.18.2 (2024-03-11)

### Fix

- **git**: force the default git locale on methods relying on parsing the output (#1012)

## v3.18.1 (2024-03-11)

### Fix

- **changelog**: changelog hook was not called on dry run

## v3.18.0 (2024-03-07)

### Feat

- **changelog**: `changelog_message_build_hook` can now generate multiple changelog entries from a single commit (#1003)

## v3.17.2 (2024-03-07)

### Fix

- **changelog**: ensure `changelog_message_builder_hook` can access and modify `change_type` (#1002)

## v3.17.1 (2024-03-07)

### Fix

- **bump**: pre and post bump hooks were failing when an increment was provided (fix #1004)

## v3.17.0 (2024-03-06)

### Feat

- **changelog**: `changelog_message_build_hook` can remove message by returning a falsy value

## v3.16.0 (2024-02-26)

### Feat

- **commands**: add bump --exact

### Fix

- **bump**: change --exact-increment to --increment-mode
- **bump**:  only get and validate commits if increment is not provided
-  Improve type annotations

## v3.15.0 (2024-02-17)

### Feat

- **bump**: functionality to add build-metadata to version string

## v3.14.1 (2024-02-04)

### Fix

- **bump**: remove unused method
- **scm**: only search tags that are reachable by the current commit

## v3.14.0 (2024-02-01)

### Feat

- properly bump versions between prereleases (#799)

## v3.13.0 (2023-12-03)

### Feat

- **commands-bump**: automatically create annotated tag if message is given
- add tag message argument to cli
- **git**: add get tag message function
- add custom message to annotated git tag

### Fix

- **test-bump-command**: typo in --annotated-tag option inside test
- **commitizen-git**: add quotes for tag message

### Refactor

- **commands-bump**: make changelog variable in 1 line
- **commands-bump**: cast str to bool

## v3.12.0 (2023-10-18)

### Feat

- **formats**: expose some new customizable changelog formats on the `commitizen.changelog_format` endpoint (Textile, AsciiDoc and RestructuredText)
- **template**: add `changelog --export-template` command
- **template**: allow to override the template from cli, configuration and plugins
- **cli.py**: Added support for extra git CLI args after -- separator for `cz commit` command

### Fix

- **filename**: ensure `file_name` can be passed to `changelog` from `bump` command

### Refactor

- **git.py**: Removed 'extra_args' from git.commit
- **extra_args**: Fixed broken code due to rebase and finalized tests
- Code Review - round 1 changes
- **Commit**: Added deprecation on git signoff mechanic

## v3.10.1 (2023-10-14)

### Fix

- **bump**: add bump support with custom type + scope + exclamation mark
- **bump**: version bumping

## v3.10.0 (2023-09-25)

### Feat

- Drop support for Python 3.7 (#858)

## v3.9.1 (2023-09-22)

### Fix

- **conf**: handle parse error when init (#856)

## v3.9.0 (2023-09-15)

### Feat

- **commands**: add arg of cz commit to execute git add

### Fix

- **tests**: modify the arg of commit from add to all
- **commitizen**: Modify the function of the arg a of commit from git add all to git add update

### Refactor

- **commitizen**: add return type hint of git add function

## v3.8.2 (2023-09-09)

### Refactor

- **provider**: split provider code and related tests into individual files for maintainability (#830)

## v3.8.1 (2023-09-08)

### Fix

- add sponsors to README

## v3.8.0 (2023-09-05)

### Feat

- **defaults.py**: add always_signoff config option for commits

## v3.7.1 (2023-09-04)

### Fix

- empty error on bump failure

## v3.7.0 (2023-08-26)

### Feat

- **provider**: add npm2 provider to update package.json, package-lock.json, and npm-shrinkwrap.json

### Fix

- **provider**: fix npm version provider to update package-lock.json and npm-shrinkwrap.json if they exist
- **provider**: fix npm provider to update package-lock.json and npm-shrinkwrap.json if they exist
- **test**: pass correct type to get_package_version tests
- **tests**: completed test coverage for npm2

## v3.6.0 (2023-08-01)

### Feat

- **changelog.py**: add encoding to get_metadata
- **unicode**: add unicode support

### Fix

- add missing `encoding` parameter
- **out.py**: `TextIOWrapper.reconfigure` typing
- correct type hinting
- use base config for encoding

### Refactor

- **defaults.py**: use variables in `DEFAULT_SETTINGS`

## v3.5.4 (2023-07-29)

### Refactor

- replace SemVer type literals by respective constants

## v3.5.3 (2023-07-15)

### Fix

- Treat $version the same as unset tag_format in ScmProvider

### Refactor

- Make tag_format properly default to $version

## v3.5.2 (2023-06-25)

### Fix

- **typing**: no_raise is declared as optional

## v3.5.1 (2023-06-24)

### Fix

- only use version tags when generating a changelog

## v3.5.0 (2023-06-23)

### Feat

- Add option in bump command to redirect git output to stderr

## v3.4.1 (2023-06-23)

### Fix

- **veresion_schemes**: import missing Self for python 3.11

## v3.4.0 (2023-06-20)

### Feat

- **version-schemes**: expose `version_schemes` as a `commitizen.scheme` endpoint.

## v3.3.0 (2023-06-13)

### Feat

- add support for cargo workspaces

## v3.2.2 (2023-05-11)

### Fix

- **init**: fix is_pre_commit_installed method

## v3.2.1 (2023-05-03)

### Fix

- add support for importlib_metadata 6

## v3.2.0 (2023-05-01)

### Feat

- **hooks**: add prepare-commit-msg and post-commit hooks
- **commit**: add --write-message-to-file option

### Fix

- **bump**: better match for change_type when finding increment
- **changelog**: breaking change on additional types for conventional commits
- **bump**: breaking changes on additional types for conventional commits
- improve errors message when empty .cz.json found
- **init**: poetry detection
- bump decli which is type hinted

### Refactor

- **commit**: change type of write_message_to_file to path

## v3.1.1 (2023-04-28)

### Fix

- bump changelog for prerelease without commits

## v3.1.0 (2023-04-25)

### Feat

- make `major_version_zero` customizable by third parties

## v3.0.1 (2023-04-23)

### Fix

- typo in hook

### Refactor

- set default_install_hook_types

## v3.0.0 (2023-04-23)

### BREAKING CHANGE

- Plugins are now exposed as `commitizen.plugin` entrypoints
- Python 3.6 is not officially supported anymore. Please migrate from 3.6 to 3.7 or greater.

### Feat

- **init**: add new settings
- add semver support through version provider new api (#686)
- **changelog**: add merge_prereleases flag
- **providers**: add a `scm` version provider
- **providers**: add support for some JSON-based version providers (NPM, Composer)
- **providers**: add support for some TOML-based versions (PEP621, Poetry, Cargo)
- **providers**: add a `commitizen.provider` endpoint for alternative versions providers
- **plugins**: Switch to an importlib.metadata.EntryPoint-based plugin loading

### Fix

- **init**: welcome message
- small corrections and clean up
- major version zero message
- update dependencies
- **commands/changelog**: use topological order for commit ordering
- **excepthook**: ensure traceback can only be a `TracebackType` or `None`

## v2.42.1 (2023-02-25)

### Fix

- **bump**: fixed environment variables in bump hooks

## v2.42.0 (2023-02-11)

### Feat

- **bump**: support prereleases with start offset

## v2.41.0 (2023-02-08)

### Feat

- **bump**: added support for running arbitrary hooks during bump

## v2.40.0 (2023-01-23)

### Feat

- **yaml_config**: add explicit_start for yaml output

## v2.39.1 (2022-12-31)

### Fix

- filter git diff from commit message

## v2.39.0 (2022-12-31)

### Feat

- **init**: allow user to select which type of pre commit hooks to install

### Fix

- **init**: space between `--hook-type` options
- **init**: report error when hook installation failed

### Refactor

- **init**: `_install_pre_commit_hook` raise error when failed

## v2.38.0 (2022-12-12)

### Feat

- **poetry**: relax packaging version

## v2.37.1 (2022-11-30)

### Fix

- **changelog**: allow rev range lookups without a tag format

## v2.37.0 (2022-10-28)

### Feat

- add major-version-zero option to support initial package development

## v2.36.0 (2022-10-28)

### Feat

- **scripts**: remove `venv/bin/`
- **scripts**: add error message to `test`

### Fix

- **scripts/test**: MinGW64 workaround
- **scripts/test**: use double-quotes
- **scripts**: pydocstyle and cz
- **bump.py**: use `sys.stdin.isatty()`
- **scripts**: use cross-platform POSIX
- **scripts**: use portable shebang
- **pythonpackage.yml**: undo indent reformatting
- **pythonpackage.yml**: use `bash`

## v2.35.0 (2022-09-23)

### Feat

- allow fixup! and squash! in commit messages

## v2.34.0 (2022-09-19)

### Feat

- **bump**: support optional manual version argument

### Fix

- **bump**: fix type hint
- **bump**: fix typos

## v2.33.1 (2022-09-16)

### Fix

- **bump.py**: `CHANGELOG.md` gets git added and committed correctly

## v2.33.0 (2022-09-15)

### Feat

- add functionality for dev-releases

## v2.32.7 (2022-09-14)

### Fix

- **README.md**: fix pre-commit install command

## v2.32.6 (2022-09-14)

### Fix

- **bump**: log git commit stderr and stdout during bump

## v2.32.5 (2022-09-10)

### Fix

- **command_changelog**: Fixed issue #561 cz bump could not find the latest version tag with custom tag_format

## v2.32.4 (2022-09-08)

### Refactor

- **bump**: Remove a redundant join call

## v2.32.3 (2022-09-07)

### Fix

- **bump**: Search for version number line by line

## v2.32.2 (2022-08-22)

### Fix

- **bump**: Support regexes containing colons

## v2.32.1 (2022-08-21)

### Fix

- **git**: Improves error checking in get_tags
- **git**: improves git error checking in get_commits

### Refactor

- **git**: test the git log parser behaves properly when the repository has no commits
- **changelog**: fixes logic issue made evident by latest fix(git) commit

## v2.32.0 (2022-08-21)

### Feat

- **pre-commit**: Add commitizen-branch hook

## v2.31.0 (2022-08-14)

### Feat

- new file

### Fix

- **pyproject.toml**: remove test added configurations
- **changelog**: use defaults.change_type_order in conventional commit
- capitalize types in default change_type_order

## v2.30.0 (2022-08-14)

### Feat

- Determine newline to write with Git

## v2.29.6 (2022-08-13)

### Fix

- **cmd**: improve character encoding detection for sub-commands

## v2.29.5 (2022-08-07)

### Fix

- **git**: use "git tag -v" return_code to check whether a tag is signed

## v2.29.4 (2022-08-05)

### Refactor

- **tool**: use charset_normalizer instead of chardet

## v2.29.3 (2022-08-02)

### Refactor

- **changelog**: removes unused code. duplicates are found in changelog_parser

## v2.29.2 (2022-07-27)

### Fix

- **bump**: send changelog to stdout when `dry-run` is paired with `changelog-to-stdout`

## v2.29.1 (2022-07-26)

### Fix

- **Check**: process empty commit message
- **ConventionalCommitsCz**: cz's schema validates the whole commit message now

### Refactor

- **Check**: remove the extra preprocessing of commit message file

## v2.29.0 (2022-07-22)

### Feat

- use chardet to get correct encoding
- **bump**: add signed tag support for bump command

### Fix

- avoid that pytest overrides existing gpg config
- **test**: set git to work with gpg

## v2.28.1 (2022-07-22)

### Fix

- **changelog**: skip non-compliant commit subjects when building changelog

## v2.28.0 (2022-07-03)

### Feat

- **bump**: make increment option case insensitive

## v2.27.1 (2022-05-22)

### Fix

- **pre-commit**: Use new --allow-abort option
- **pre-commit**: Confine hook to commit-msg stage
- **pre-commit**: Set min pre-commit to v1.4.3
- **pre-commit**: Don't require serial execution

## v2.27.0 (2022-05-16)

### Feat

- **bump**: let it respect pre-commit reformats when bumping

## v2.26.0 (2022-05-14)

### Feat

- **check**: Add --allow-abort option

## v2.25.0 (2022-05-10)

### Feat

- **changelog**: Improve whitespace in changelog

### Refactor

- **changelog**: Simplify incremental_build

## v2.24.0 (2022-04-15)

### Feat

- add --no-raise to avoid raising error codes

### Fix

- change error code for NoneIncrementExit

## v2.23.0 (2022-03-29)

### Feat

- **customize.py**: adding support for commit_parser, changelog_pattern, change_type_map

## v2.22.0 (2022-03-29)

### Feat

- **changelog**: add support for single version and version range

### Refactor

- speed up testing and wait for tags
- **git**: use date as a function in GitTag to easily patch

## v2.21.2 (2022-02-22)

### Fix

- remove type ignore

## v2.21.1 (2022-02-22)

### Refactor

- Switch to issue forms
- Switch to issue forms
- Switch to issue forms

## v2.21.0 (2022-02-17)

### Feat

- skip merge messages that start with Pull request

## v2.20.5 (2022-02-07)

### Fix

- Ignore packages that are not plugins

### Refactor

- iter_modules only accepts str

## v2.20.4 (2022-01-17)

### Fix

- **bump**: raise non zero error code when there's no eligible commit to bump

## v2.20.3 (2021-12-20)

### Fix

- **check**: filter out comment message when checking

## v2.20.2 (2021-12-14)

### Fix

- **poetry**: add typing-exteions to dev

## v2.20.1 (2021-12-14)

### Fix

- import TypedDict from type_extensions for backward compatibility

### Refactor

- **conventional_commits**: remove duplicate patterns and import from defaults
- **config**: add CzSettings and Questions TypedDict
- **defaults**: add Settings typeddict
- **defaults**: move bump_map, bump_pattern, commit_parser from defaults to ConventionalCommitsCz

## v2.20.0 (2021-10-06)

### Feat

- **cli.py**: add shortcut for signoff command
- add signoff parameter to commit command

## v2.19.0 (2021-09-27)

### Feat

- utility for showing system information

## v2.18.2 (2021-09-27)

### Fix

- **cli**: handle argparse different behavior after python 3.9

## v2.18.1 (2021-09-12)

### Fix

- **commit**: correct the stage checker before committing

## v2.18.0 (2021-08-13)

### Feat

- **prompt**: add keyboard shortcuts with config option

### Refactor

- **shortcuts**: move check for shortcut config setting to apply to any list select

## v2.17.13 (2021-07-14)

## v2.17.12 (2021-07-06)

### Fix

- **git.py**: ensure signed commits in changelog when git config log.showsignature=true

## v2.17.11 (2021-06-24)

### Fix

- correct indentation for json config for better readability

## v2.17.10 (2021-06-22)

### Fix

- add support for jinja2 v3

## v2.17.9 (2021-06-11)

### Fix

- **changelog**: generating changelog after a pre-release

## v2.17.8 (2021-05-28)

### Fix

- **changelog**: annotated tags not generating proper changelog

## v2.17.7 (2021-05-26)

### Fix

- **bump**: fix error due to bumping version file without eol through regex
- **bump**: fix offset error due to partially match

## v2.17.6 (2021-05-06)

### Fix

- **cz/conventional_commits**: optionally expect '!' right before ':' in schema_pattern

## v2.17.5 (2021-05-06)

## v2.17.4 (2021-04-22)

### Fix

- version update in a docker-compose.yaml file

## v2.17.3 (2021-04-19)

### Fix

- fix multiple versions bumps when version changes the string size

## v2.17.2 (2021-04-10)

### Fix

- **bump**: replace all occurrences that match regex
- **wip**: add test for current breaking change

## v2.17.1 (2021-04-08)

### Fix

- **commands/init**: fix toml config format error

## v2.17.0 (2021-04-02)

### Feat

- Support versions on random positions

## v2.16.0 (2021-03-08)

### Feat

- **bump**: send incremental changelog to stdout and bump output to stderr

## v2.15.3 (2021-02-26)

### Fix

- add utf-8 encode when write toml file

## v2.15.2 (2021-02-24)

### Fix

- **git**: fix get_commits deliminator

## v2.15.1 (2021-02-21)

### Fix

- **config**: change read mode from `r` to `rb`

## v2.15.0 (2021-02-21)

### Feat

- **changelog**: add support for multiline BREAKING paragraph

## v2.14.2 (2021-02-06)

### Fix

- **git**: handle the empty commit and empty email cases

## v2.14.1 (2021-02-02)

### Fix

- remove yaml warnings when using '.cz.yaml'

## v2.14.0 (2021-01-20)

### Feat

- **#271**: enable creation of annotated tags when bumping

## v2.13.0 (2021-01-01)

### Feat

- **#319**: add optional change_type_order

### Refactor

- raise an InvalidConfigurationError
- **#323**: address PR feedback
- move expected COMMITS_TREE to global

## v2.12.1 (2020-12-30)

### Fix

- read commit_msg_file with utf-8

## v2.12.0 (2020-12-30)

### Feat

- **deps**: Update and relax tomlkit version requirement

## v2.11.1 (2020-12-16)

### Fix

- **commit**: attach user info to backup for permission denied issue

## v2.11.0 (2020-12-10)

### Feat

- add yaml as a config option
- **config**: add support for the new class YAMLConfig at the root of the confi internal package
- **init**: add support for yaml config file at init

### Fix

- **YAMLConfig**: add a TypeError exception to handle in _parse_settings method

## v2.10.0 (2020-12-02)

### Feat

- **commitizen/cli**: add the integration with argcomplete

## v2.9.0 (2020-12-02)

### Feat

- **Init**: add the json config support as an option at Init
- **commitizen/config/json_config**: add json support for configuration

### Fix

- **json_config**: fix the emtpy_config_content method

## v2.8.2 (2020-11-21)

### Fix

- support `!` in cz check command

## v2.8.1 (2020-11-21)

### Fix

- prevent prerelease from creating a bump when there are no commits

## v2.8.0 (2020-11-15)

### Feat

- allow files-only to set config version and create changelog

## v2.7.0 (2020-11-14)

### Feat

- **bump**: add flag `--local-version` that supports bumping only the local version instead of the public

## v2.6.0 (2020-11-04)

### Feat

- **commands/bump**: add config option to create changelog on bump

## v2.5.0 (2020-11-04)

### Feat

- **commands/changelog**: add config file options for start_rev and incremental

## v2.4.2 (2020-10-26)

### Fix

- **init.py**: mypy error (types)
- **commands/bump**: Add NoneIncrementExit to fix git fatal error when creating existing tag

### Refactor

- **commands/bump**: Remove comment and changed ... for pass

## v2.4.1 (2020-10-04)

### Fix

- **cz_customize**: make schema_pattern customiziable through config for cz_customize

## v2.4.0 (2020-09-18)

### Feat

- **cz_check**: cz check can read commit message from pipe

## v2.3.1 (2020-09-07)

### Fix

- conventional commit schema

## v2.3.0 (2020-09-03)

### Feat

- **cli**: rewrite cli instructions to be more succinct about what they require

### Fix

- **cli**: add guideline for subject input
- **cli**: wrap the word enter with brackets

## v2.2.0 (2020-08-31)

### Feat

- **cz_check**: cz check can read from a string input

## v2.1.0 (2020-08-06)

### Feat

- **cz_check**: Add rev to all displayed ill-formatted commits
- **cz_check**: Update to show all ill-formatted commits

### Refactor

- **cz_check**: Refactor _get_commits to return GitCommit instead of dict

## v2.0.2 (2020-08-03)

### Fix

- **git**: use double quotation mark in get_tags

## v2.0.1 (2020-08-02)

### Fix

- **commands/changelog**: add exception message when failing to find an incremental revision
- **commands/bump**: display message variable properly

## v2.0.0 (2020-07-26)

### BREAKING CHANGE

- setup.cfg, .cz and .cz.cfg are no longer supported
- Use "cz version" instead
- "cz --debug" will no longer work
 #47

### Feat

- **init**: enable setting up pre-commit hook through "cz init"

### Fix

- add missing `pyyaml` dependency
- **cli**: make command required for commitizen

### Refactor

- **config**: drop "files" configure support. Please use "version_files" instead
- **config**: remove ini configuration support
- **cli**: remove "--version" argument

## v1.25.0 (2020-07-26)

### Feat

- **conventional_commits**: use and proper support for conventional commits v1.0.0

## v1.24.0 (2020-07-26)

### Feat

- add author and author_email to git commit

## v1.23.4 (2020-07-26)

### Refactor

- **changelog**: remove pkg_resources dependency

## v1.23.3 (2020-07-25)

### Fix

- **commands/bump**: use `return_code` in commands used by bump
- **commands/commit**: use return_code to raise commit error, not stderr

### Refactor

- **cmd**: add return code to Command

## v1.23.2 (2020-07-25)

### Fix

- **bump**: add changelog file into stage when running `cz bump --changelog`

## v1.23.1 (2020-07-14)

### Fix

- Raise NotAGitProjectError only in git related command

## v1.23.0 (2020-06-14)

### Feat

- **cli**: enable displaying all traceback for CommitizenException when --debug flag is used

### Refactor

- **exception**: rename MissingConfigError as MissingCzCustomizeConfigError
- **exception**: Rename CommitFailedError and TagFailedError with Bump prefix
- **commands/init**: add test case and remove unaccessible code
- **exception**: move output message related to exception into exception
- **exception**: implement message handling mechanism for CommitizenException
- **cli**: do not show traceback if the raised exception is CommitizenException
- introduce DryRunExit, ExpectedExit, NoCommandFoundError, InvalidCommandArgumentError
- use custom exception for error handling
- **error_codes**: remove unused NO_COMMIT_MSG error code

## v1.22.3 (2020-06-10)

## v1.22.2 (2020-05-29)

### Fix

- **changelog**: empty lines at the beginning of the CHANGELOG

## v1.22.1 (2020-05-23)

### Fix

- **templates**: remove trailing space in keep_a_changelog

## v1.22.0 (2020-05-13)

### Feat

- **changelog**: add support for `changelog_hook` when changelog finishes the generation
- **changelog**: add support for `message_hook` method
- **changelog**: add support for modifying the change_type in the title of the changelog

### Fix

- **changelog**: rename `message_hook` -> `changelog_message_builder_hook`

## v1.21.0 (2020-05-09)

### Feat

- **commands/bump**: add "--check-consistency" optional

## v1.20.0 (2020-05-06)

### Feat

- **bump**: add optional --no-verify argument for bump command

## v1.19.3 (2020-05-04)

### Fix

- **docs**: change old url woile.github.io to commitizen-tools.github.io
- **changelog**: generate today's date when using an unreleased_version

## v1.19.2 (2020-05-03)

### Fix

- **changelog**: sort the commits properly to their version

## v1.19.1 (2020-05-03)

### Fix

- **commands/check**: Show warning if no commit to check when running `cz check --rev-range`

### Refactor

- **cli**: add explicit category for deprecation warnings

## v1.19.0 (2020-05-02)

### Feat

- **changelog**: add support for any commit rule system
- **changelog**: add incremental flag
- **commands/changelog**: make changelog_file an option in config
- **commands/changelog**: exit when there is no commit exists
- **commands/changelog**: add --start-rev argument to `cz changelog`
- **changelog**: generate changelog based on git log
- **commands/changelog**: generate changelog_tree from all past commits
- **cz/conventinal_commits**: add changelog_map, changelog_pattern and implement process_commit
- **cz/base**: add default process_commit for processing commit message
- **changelog**: changelog tree generation from markdown

### Fix

- **git**: missing dependency removed
- **changelog**: check get_metadata for existing changelog file
- **cz/conventional_commits**: fix schema_pattern break due to rebase
- **changelog_template**: fix list format
- **commitizen/cz**: set changelog_map, changelog_pattern to none as default
- **commands/changelog**: remove --skip-merge argument
- **cli**: add changelog arguments

### Refactor

- **changelog**: use functions from changelog.py
- **changelog**: rename category to change_type to fit 'keep a changelog'
- **templates**: rename as "keep_a_changelog_template.j2"
- **templates**: remove unneeded __init__ file
- **cli**: reorder commands
- **templates**: move changelog_template from cz to templates
- **tests/utils**: move create_file_and_commit to tests/utils
- **commands/changelog**: remove redundant if statement
- **commands/changelog**: use jinja2 template instead of string concatenation to build changelog

## v1.18.3 (2020-04-22)

### Refactor

- **commands/init**: fix typo

## v1.18.2 (2020-04-22)

### Fix

- **git**: fix returned value for GitCommit.message when body is empty

### Refactor

- **git**: replace GitCommit.message code with one-liner

## v1.18.1 (2020-04-16)

### Fix

- **config**: display ini config deprecation warning only when commitizen config is inside

## v1.18.0 (2020-04-13)

### Feat

- **bump**: support for ! as BREAKING change in commit message

### Fix

- **cz/customize**: add error handling when customize detail is not set

### Refactor

- **cz/customize**: remove unused mypy ignore
- **mypy**: fix mypy check by checking version.pre exists
- **cz**: add type annotation to registry
- **commands/check**: fix type annotation
- **config/base**: use Dict to replace dict in base_config
- **cz/base**: fix config type used in base cz
- **cz**: add type annotation for each function in cz
- **config**: fix mypy warning for _conf

## v1.17.1 (2020-03-24)

### Fix

- **commands/check**: add help text for check command without argument

### Refactor

- **cli**: fix typo

## v1.17.0 (2020-03-15)

### Feat

- **commands/check**: add --rev-range argument for checking commits within some range

### Fix

- **bump**: fix bump find_increment error

### Refactor

- **cz/connventional_commit**: use \S to check scope
- **git**: remove unnecessary dot between git range
- **tests/bump**: use parameterize to group similliar tests

## v1.16.4 (2020-03-03)

### Fix

- **commands/init**: fix clean up file when initialize commitizen config

### Refactor

- **defaults**: split config files into long term support and deprecated ones

## v1.16.3 (2020-02-20)

### Fix

- replace README.rst with docs/README.md in config files

### Refactor

- **docs**: remove README.rst and use docs/README.md

## v1.16.2 (2020-02-01)

### Fix

- **commands/check**: add bump into valid commit message of convention commit pattern

## v1.16.1 (2020-02-01)

### Fix

- **pre-commit**: set pre-commit check stage to commit-msg

## v1.16.0 (2020-01-21)

### Feat

- **git**: get_commits default from first_commit

### Refactor

- **commands/bump**: rename parameter into bump_setting to distinguish bump_setting and argument
- **git**: rename get tag function to distinguish return str and GitTag
- **cmd**: reimplement how cmd is run
- **git**: Use GitCommit, GitTag object to store commit and git information
- **git**: make arguments other then start and end in get_commit keyword arguments
- **git**: Change get_commits into returning commits instead of lines of messages

## v1.15.1 (2020-01-20)

### Fix

- **cli**: fix --version not functional

### Refactor

- **tests/commands/bump**: use tmp_dir to replace self implemented tmp dir behavior
- **test_bump_command**: rename camel case variables
- **tests/commands/check**: use pytest fixture tmpdir replace self implemented contextmanager
- **test/commands/other**: replace unit test style mock with mocker fixture
- **tests/commands**: separate command unit tests into modules
- **tests/commands**: make commands related tests a module

## v1.15.0 (2020-01-20)

### Feat

- **config**: look up configuration in git project root
- **git**: add find_git_project_root

### Fix

- **git**: remove breakline in the return value of find_git_project_root

### Refactor

- **git**: make find_git_project_root return None if it's not a git project
- **config/base_config**: make set_key not implemented
- **error_codes**: move all the error_codes to a module
- **config**: replace string type path with pathlib.Path

## v1.14.2 (2020-01-14)

### Fix

- **github_workflow/pythonpublish**: use peaceiris/actions-gh-pages@v2 to publish docs

## v1.14.1 (2020-01-11)

### Fix

- **cli**: fix the way default handled for name argument
- **cli**: fix name cannot be overwritten through config in newly refactored config design

## v1.14.0 (2020-01-06)

### Feat

- **pre-commit-hooks**: add pre-commit hook

### Refactor

- **pre-commit-hooks**: add metadata for the check hook

## v1.13.1 (2019-12-31)

### Fix

- **github_workflow/pythonpackage**: set git config for unit testing
- **scripts/test**: ensure the script fails once the first failure happens

## v1.13.0 (2019-12-30)

### Feat

- add project version to command init

## v1.12.0 (2019-12-30)

### Feat

- new init command

## v1.10.3 (2019-12-29)

### Refactor

- **commands/bump**: use "version_files" internally
- **config**: set "files" to alias of "version_files"

## v1.10.2 (2019-12-27)

### Fix

- **config**: handle empty config file
- **config**: fix load global_conf even if it doesn't exist
- **config/ini_config**: replace outdated _parse_ini_settings with _parse_settings

### Refactor

- new config system where each config type has its own class
- **config**: add type annotation to config property
- **config**: fix wrongly type annotated functions
- **config/ini_config**: move deprecation warning into class initialization
- **config**: use add_path instead of directly assigning _path
- **all**: replace all the _settings invoke with settings.update
- **cz/customize**: remove unnecessary statement "raise NotImplementedError("Not Implemented yet")"
- **config**: move default settings back to defaults
- **config**: Make config a class and each type of config (e.g., toml, ini) a child class

## v1.10.1 (2019-12-10)

### Fix

- **cli**: overwrite "name" only when it's not given
- **config**: fix typo

## v1.10.0 (2019-11-28)

### Feat

- support for different commitizens in `cz check`
- **bump**: new argument --files-only

## v1.9.2 (2019-11-23)

### Fix

- **commands/check.py**: --commit-msg-file is now a required argument

## v1.9.1 (2019-11-23)

### Fix

- **cz/exceptions**: exception AnswerRequiredException not caught (#89)

## v1.9.0 (2019-11-22)

### Feat

- **Commands/check**: enforce the project to always use conventional commits
- **config**: add deprecation warning for loading config from ini files
- **cz/customize**: add jinja support to enhance template flexibility
- **cz/filters**: add required_validator and multiple_line_breaker
- **Commands/commit**: add ´--dry-run´ flag to the Commit command
- **cz/cz_customize**: implement info to support info and info_path
- **cz/cz_customize**: enable bump_pattern bump_map customization
- **cz/cz_customize**: implement customizable cz
- new 'git-cz' entrypoint

### Fix

- commit dry-run doesn't require staging to be clean
- **scripts**: add back the delete poetry prefix
- correct typo to spell "convention"
- removing folder in windows throwing a PermissionError
- **test_cli**: testing the version command

### Refactor

- **config**: remove has_pyproject which is no longer used
- **cz/customize**: make jinja2 a custom requirement. if not installed use string.Template instead
- **cz/utils**: rename filters as utils
- **cli**: add back --version and remove subcommand required constraint

## v1.8.0 (2019-11-12)

### Feat

- **cz**: add a base exception for cz customization
- **commands/commit**: abort commit if there is nothing to commit
- **git**: add is_staging_clean to check if there is any file in git staging

### Fix

- **commands/commit**: catch exception raised by customization cz
- **cli**: handle the exception that command is not given
- **cli**: enforce subcommand as required

### Refactor

- **cz/conventional_commit**: make NoSubjectException inherit CzException and add error message
- **command/version**: use out.write instead of out.line
- **command**: make version a command instead of an argument

## v1.7.0 (2019-11-08)

### Feat

- **config**: update style instead of overwrite
- **config**: parse style in config
- **commit**: make style configurable for commit command

### Fix

- **cz**: fix bug in BaseCommitizen.style
- **cz**: fix merge_style usage error
- **cz**: remove breakpoint

### Refactor

- **cz**: change the color of default style

## v1.6.0 (2019-11-05)

### Feat

- **commit**: new retry argument to execute previous commit again

## v1.5.1 (2019-06-04)

### Fix

- #28 allows poetry add on py36 envs

## v1.5.0 (2019-05-11)

### Feat

- **bump**: it is now possible to specify a pattern in the files attr to replace the version

## v1.4.0 (2019-04-26)

### Feat

- added argument yes to bump in order to accept questions

### Fix

- **bump**: handle commit and create tag failure

## v1.3.0 (2019-04-24)

### Feat

- **bump**: new commit message template

## v1.2.1 (2019-04-21)

### Fix

- **bump**: prefixes like docs, build, etc no longer generate a PATCH

## v1.2.0 (2019-04-19)

### Feat

- custom cz plugins now support bumping version

## v1.1.1 (2019-04-18)

### Fix

- **bump**: commit message now fits better with semver
- conventional commit 'breaking change' in body instead of title

### Refactor

- changed stdout statements
- **schema**: command logic removed from commitizen base
- **info**: command logic removed from commitizen base
- **example**: command logic removed from commitizen base
- **commit**: moved most of the commit logic to the commit command

## v1.1.0 (2019-04-14)

### Feat

- new working bump command
- create version tag
- update given files with new version
- **config**: new set key, used to set version to cfg
- support for pyproject.toml
- first semantic version bump implementation

### Fix

- removed all from commit
- fix config file not working

### Refactor

- added commands folder, better integration with decli

## v1.0.0 (2019-03-01)

### Refactor

- removed delegator, added decli and many tests

## 1.0.0b2 (2019-01-18)

## v1.0.0b1 (2019-01-17)

### Feat

- py3 only, tests and conventional commits 1.0

## v0.9.11 (2018-12-17)

### Fix

- **config**: load config reads in order without failing if there is no commitizen section

## v0.9.10 (2018-09-22)

### Fix

- parse scope (this is my punishment for not having tests)

## v0.9.9 (2018-09-22)

### Fix

- parse scope empty

## v0.9.8 (2018-09-22)

### Fix

- **scope**: parse correctly again

## v0.9.7 (2018-09-22)

### Fix

- **scope**: parse correctly

## v0.9.6 (2018-09-19)

### Fix

- **manifest**: included missing files

### Refactor

- **conventionalCommit**: moved filters to questions instead of message

## v0.9.5 (2018-08-24)

### Fix

- **config**: home path for python versions between 3.0 and 3.5

## v0.9.4 (2018-08-02)

### Feat

- **cli**: added version

## v0.9.3 (2018-07-28)

### Feat

- **committer**: conventional commit is a bit more intelligent now

## v0.9.2 (2017-11-11)

## v0.9.1 (2017-11-11)

### Fix

- **setup.py**: future is now required for every python version

## v0.9.0 (2017-11-08)

### Refactor

- python 2 support

## v0.8.6 (2017-11-08)

## v0.8.5 (2017-11-08)

## v0.8.4 (2017-11-08)

## v0.8.3 (2017-11-08)

## v0.8.2 (2017-10-08)

## v0.8.1 (2017-10-08)

## v0.8.0 (2017-10-08)

### Feat

- **cz**: jira smart commits

## v0.7.0 (2017-10-08)

### Refactor

- **cli**: renamed all to ls command
- **cz**: renamed angular cz to conventional changelog cz

## v0.6.0 (2017-10-08)

### Feat

- info command for angular

## v0.5.0 (2017-10-07)

## v0.4.0 (2017-10-07)

## v0.3.0 (2017-10-07)

## v0.2.0 (2017-10-07)

### Feat

- **config**: new loads from ~/.cz and working project .cz .cz.cfg and setup.cfg
- package discovery

### Refactor

- **cz_angular**: improved messages