no-mistakes(ci): Fixed PR-caused code issues by restoring the public commitizen.bump.find_increment compatibility shim in commitizen/bump.py, adding focused regression coverage in tests/test_bump_find_increment.py, and protecting the MkDocs snippet block in docs/customization/python_class.md from blacken-docs rewrites so pre-commit/CI formatting passes. Verified with uv run pytest tests/test_bump_find_increment.py tests/commands/test_documented_python_class_examples.py -q, uv run ruff check ..., uv run mypy ..., uv run --no-sync prek run --all-files, uv run --no-sync poe cover, and uv run --no-sync mkdocs build. Note: the full local poe ci sequence still stops at commit-history validation for existing no-mistakes(...) commit subjects, which is a non-file-change issue outside this code fix

Author: bearomorphism

commitizen/bump.py

@@ -4,16 +4,37 @@
 import re
 from glob import iglob
 from string import Template
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, cast
 
 from commitizen.defaults import BUMP_MESSAGE
 from commitizen.exceptions import CurrentVersionNotFoundError
 from commitizen.git import smart_open
+from commitizen.version_increment import VersionIncrement
 
 if TYPE_CHECKING:
-    from collections.abc import Generator, Iterable
+    from collections.abc import Generator, Iterable, Mapping
 
-    from commitizen.version_schemes import VersionProtocol
+    from commitizen.git import GitCommit
+    from commitizen.version_schemes import Increment, VersionProtocol
+
+
+def find_increment(
+    commits: list[GitCommit], regex: str, increments_map: Mapping[str, object]
+) -> Increment | None:
+    """Preserve the legacy bump helper as a compatibility shim.
+
+    This public helper remains available for integrations importing
+    ``commitizen.bump.find_increment`` while delegating the real increment
+    comparison and extraction logic to ``VersionIncrement``.
+    """
+    increment = VersionIncrement.get_highest_by_messages(
+        (commit.message for commit in commits),
+        regex,
+        increments_map,
+    )
+    if increment == VersionIncrement.NONE:
+        return None
+    return cast("Increment", str(increment))
 
 
 def update_version_in_files(

docs/customization/python_class.md

@@ -106,9 +106,11 @@ keeps the example executable while still overriding the bump rules. The module
 below is the same file exercised by Commitizen's test suite and type-checked by
 mypy.
 
+<!-- blacken-docs:off -->
 ```python title="cz_docs_only.py"
 --8<-- "docs/examples/cz_docs_only.py"
 ```
+<!-- blacken-docs:on -->
 
 Package and install `cz_docs_only.py` just like the earlier `cz_jira.py`
 example, and expose it through the same `commitizen.plugin` entry point group,

tests/test_bump_find_increment.py

@@ -0,0 +1,40 @@
+"""Regression tests for the public ``commitizen.bump.find_increment`` helper."""
+
+from commitizen import bump
+from commitizen.cz.conventional_commits import ConventionalCommitsCz
+from commitizen.git import GitCommit
+
+
+def test_find_increment_keeps_public_api_behavior() -> None:
+    """The compatibility shim still returns the highest named increment."""
+    # Arrange
+    commits = [
+        GitCommit(rev="test", title="fix: correct typo"),
+        GitCommit(rev="test", title="feat(api): add endpoint"),
+    ]
+
+    # Act
+    increment = bump.find_increment(
+        commits,
+        regex=ConventionalCommitsCz.bump_pattern,
+        increments_map=ConventionalCommitsCz.bump_map,
+    )
+
+    # Assert
+    assert increment == "MINOR"
+
+
+def test_find_increment_supports_custom_none_mapping() -> None:
+    """A matched custom rule can still opt out of bumping entirely."""
+    # Arrange
+    commits = [GitCommit(rev="test", title="docs: expand usage guide")]
+
+    # Act
+    increment = bump.find_increment(
+        commits,
+        regex=r"^(docs)",
+        increments_map={"docs": None},
+    )
+
+    # Assert
+    assert increment is None