feat(bump): add retry_bump_after_failure default and docs

Author: EkinDeveci1907

commitizen/defaults.py

@@ -91,6 +91,7 @@ class Settings(TypedDict, total=False):
     "ignored_tag_formats": [],
     "bump_message": None,  # bumped v$current_version to $new_version
     "retry_after_failure": False,
+    "retry_bump_after_failure": False,
     "allow_abort": False,
     "allowed_prefixes": [
         "Merge",

docs/config/bump.md

@@ -126,6 +126,17 @@ prerelease_offset = 1
 !!! note
     Under some circumstances, a prerelease cannot start with `0`-for example, in embedded projects where individual characters are encoded as bytes. You can specify an offset from which to start counting.
 
+## `retry_bump_after_failure`
+
+when set to `true`, `cz bump` is equivalent to `cz bump --retry`. If the bump commit fails the first time (for example because a pre-commit hook reformatted a file), it is retried once. The retry only happens when the changelog is also updated (`--changelog` or `update_changelog_on_bump = true`).
+
+If not specified, defaults to `false`.
+
+```toml title="pyproject.toml"
+[tool.commitizen]
+retry_bump_after_failure = true
+```
+
 ## `tag_format`
 
 See [`--tag-format`](../commands/bump.md#-tag-format).

docs/config/configuration_file.md

@@ -235,7 +235,7 @@ Key configuration categories include:
 - **Version Management**: `version`, `version_provider`, `version_scheme`, `version_files`
 - **Tagging**: `tag_format`, `legacy_tag_formats`, `ignored_tag_formats`, `gpg_sign`, `annotated_tag`
 - **Changelog**: `changelog_file`, `changelog_format`, `changelog_incremental`, `update_changelog_on_bump`
-- **Bumping**: `bump_message`, `major_version_zero`, `prerelease_offset`, `pre_bump_hooks`, `post_bump_hooks`
+- **Bumping**: `bump_message`, `major_version_zero`, `prerelease_offset`, `pre_bump_hooks`, `post_bump_hooks`, `retry_bump_after_failure`
 - **Commit Validation**: `allowed_prefixes`, `message_length_limit`, `allow_abort`, `retry_after_failure`
 - **Customization**: `customize`, `style`, `use_shortcuts`, `template`, `extras`
 

tests/test_conf.py

@@ -85,6 +85,7 @@
     "ignored_tag_formats": [],
     "bump_message": None,
     "retry_after_failure": False,
+    "retry_bump_after_failure": False,
     "allow_abort": False,
     "allowed_prefixes": [
         "Merge",
@@ -126,6 +127,7 @@
     "ignored_tag_formats": [],
     "bump_message": None,
     "retry_after_failure": False,
+    "retry_bump_after_failure": False,
     "allow_abort": False,
     "allowed_prefixes": [
         "Merge",