python-semantic-release 9.11.0__py3-none-any.whl → 9.12.0__py3-none-any.whl

{python_semantic_release-9.11.0.dist-info → python_semantic_release-9.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python-semantic-release
-Version: 9.11.0
+Version: 9.12.0
 Summary: Automatic Semantic Versioning for Python projects
 Author-email: Rolf Erik Lekang <me@rolflekang.com>
 License: MIT

{python_semantic_release-9.11.0.dist-info → python_semantic_release-9.12.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-semantic_release/__init__.py,sha256=LEC1ip68ktnt2B2_mfEccE2nj03qrqGgPstNujJ3cBo,1229
+semantic_release/__init__.py,sha256=fxw583b6ABCDlk6pC_P4cyeIArzuHA6rwYTigF1nq-U,1229
 semantic_release/__main__.py,sha256=blPn7CMpuSe4Z-GBIDv0QA0OEDTMGU-7edsLRkkhPR4,120
 semantic_release/const.py,sha256=Z1o2QNh60wSLeF-_1TemMBjU3ZXbV0XghnUFsbTVfOs,831
 semantic_release/enums.py,sha256=D5B_reQGGKQQT22HO5PUtvn2Bok3fkht6TfJtXkmAUg,1020
@@ -6,13 +6,13 @@ semantic_release/errors.py,sha256=rco5-lwz_0JbJrDsQWmTvT_l3bA3HFkeTmBiZfvCx-Q,27
 semantic_release/gitproject.py,sha256=izWc4NLdUzAwxGG_fJeqqHW9ivSrPcWBzSaOijQx4f8,8564
 semantic_release/helpers.py,sha256=d1jOX0SNyqPc_3wr14xR25FfpqhMd4Ev7MNBOWlScc0,5581
 semantic_release/changelog/__init__.py,sha256=Bg6Xe5Vt32rWoMscW-hd4sUwiZqzWmsg4CD1EhMesMY,262
-semantic_release/changelog/context.py,sha256=aRlYnAvwg4Jchz6EYkbWyTcuwqJeCZd-lNA0Hh5Zv5Q,3268
-semantic_release/changelog/release_history.py,sha256=9gJxqOKPF9HjmOdXW-k-dWbe2YGWxqZEOWSSef-qwoE,7050
-semantic_release/changelog/template.py,sha256=FfA5-6sWh3bYQ5sEK4fR414_WNxm3TPUXghqak_9eyk,5989
+semantic_release/changelog/context.py,sha256=iZPm49yWiU4sezckZFuBRTrTn9MlkLQBJKNQ87NjZTs,5031
+semantic_release/changelog/release_history.py,sha256=8RU6A4FMgWwwjndOO4WKjbSzPWgVsYbdcZol1xUPnfo,7815
+semantic_release/changelog/template.py,sha256=J1YJDI_SnXtBbTxoahN0NaVVHN7grOFghLwE9wDjxik,5685
 semantic_release/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-semantic_release/cli/changelog_writer.py,sha256=tvUtUFfxP4mKHLfWiC2yGrdCNMtUHQrpFxfdNpGTam4,8630
+semantic_release/cli/changelog_writer.py,sha256=oCqsAZPIjv4vXxnm5p49dUUx1mlnE93cg9ma8aR40NY,8673
 semantic_release/cli/cli_context.py,sha256=23eyV6KWIpUckUSWILEd7t9dixp-QCY5-kGZnyucEYY,4114
-semantic_release/cli/config.py,sha256=-u6zXCEPMxUjI3CTukSzOvrHyWlZwrOyDRj4bJx8oeQ,30070
+semantic_release/cli/config.py,sha256=0btSbu5KKFZ3HFqR_-WDyToWXljfv1EOuBjBqwwFJcc,30654
 semantic_release/cli/const.py,sha256=haTpNlJifrtbwICwF1u0MNyB0kDsqGUsfM2zwuDu4RM,162
 semantic_release/cli/github_actions_output.py,sha256=VYIOb5x5h8eEJdSlXM_mkhT9xXtYi-RgxvnoM7iUn8s,2288
 semantic_release/cli/masking_filter.py,sha256=DxqjiJyABlzwwwZ1r8JGQpb6QrF00StJFm0-2-s5Fv0,3071
@@ -20,15 +20,15 @@ semantic_release/cli/util.py,sha256=FyXaBkeL7nXKjy3X9rQLEwvn7p46xPekp2V8Z-5MVrk,
 semantic_release/cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 semantic_release/cli/commands/changelog.py,sha256=kVHcGdfud74-M6hjWf1PS6l95gD4yUlu3CZGBkCt7aY,3765
 semantic_release/cli/commands/generate_config.py,sha256=2xZOu3NpyhBp0pWr7d8ugKl_kjqQgpSsSMHq5wHTfrE,1699
-semantic_release/cli/commands/main.py,sha256=kqO8bZw9Nv6T5QkIl53zzmH2rd4LuLoA8agweH0VYPY,4022
+semantic_release/cli/commands/main.py,sha256=OhcVrdRVKpDhvZxEfzPMmApZspPDFFFFZ02liFJ6tiA,3998
 semantic_release/cli/commands/publish.py,sha256=SZQlIewvqyIC14dkIIVVFetE0tPsKbO1cUyxnZsicrw,2845
 semantic_release/cli/commands/version.py,sha256=4ZfF2zbwnSNlVewfyXI1UrlvxJJFSI3A3xGo6Vg8CC0,24270
 semantic_release/commit_parser/__init__.py,sha256=cv5HFBdw7OJd4Laj4Ex8ZZ5Tml8GwXgQcXW6Pasr2Ao,615
 semantic_release/commit_parser/_base.py,sha256=t-Z9ALgAe7aZpYXz1mk3Fe-uAvipgKdNrq4Okg_WW9c,3026
-semantic_release/commit_parser/angular.py,sha256=AbclYVP_aX_WKpwBCN7SCyJ3-aYf-SVOT4O5TOBLVwI,4857
-semantic_release/commit_parser/emoji.py,sha256=M6zgqsXqegLK5FxZGyfsOPM3vOsJkPKVAjnGATOhwa4,3452
-semantic_release/commit_parser/scipy.py,sha256=AH_GeMZ9hWiNQTL78bovpQy7mBeobGpUk5Shzyxxm6c,5951
-semantic_release/commit_parser/tag.py,sha256=SAop9INQvKOwktNmVypKFngd6xHmY_XZrLUWChUjz84,3353
+semantic_release/commit_parser/angular.py,sha256=qB05SVI6bHapPArNeZ1rUrEmnhGRv463iN8rHL4kWZ0,4904
+semantic_release/commit_parser/emoji.py,sha256=foN7wVDW1Lv7A_cR4mq4X2aas17IEwTgQ8xjUXduN8k,3830
+semantic_release/commit_parser/scipy.py,sha256=p7Ox0GJGtJ3jKroDDW55Iu1Ma2089VegESRcagwDwJw,6028
+semantic_release/commit_parser/tag.py,sha256=4uwIKBqUM2SE6UTGIw-a7B6Jg1OONXmGwXsTyL3yZBA,3490
 semantic_release/commit_parser/token.py,sha256=BB4ZCyt753CCaBFF95cQ4sFm6Au96wpO0YyTAWdcOvE,1609
 semantic_release/commit_parser/util.py,sha256=vLcVDErZrExM55jMffos0hyMbNVQoJ-PeeVDG1Ej51I,730
 semantic_release/data/templates/angular/release_notes.md.j2,sha256=ftg0pFkmGYlb9UH2waSLc6neC8rPMMCqblJaQeq4vTg,46
@@ -61,10 +61,10 @@ semantic_release/version/algorithm.py,sha256=ofx_bIWq6ptJVr-ekI11IzxzDEctDKFiVwa
 semantic_release/version/declaration.py,sha256=f6Ld7hIhrqvDrRBapJHr-KDimuyo-4IG8009Zu9BIgU,7357
 semantic_release/version/translator.py,sha256=P1noIsVBn8u6zNOFjG0xKYOWapxqf_PHSMvMeLJ9kXg,3050
 semantic_release/version/version.py,sha256=6PCtSbLP88U1daoxnCwHc--YguZo4waGNLqJ5JfeczE,14175
-python_semantic_release-9.11.0.dist-info/AUTHORS.rst,sha256=XOReVvpymEFUPsS2QPH97jlfJBVrxwS2eu8-jVAe4gk,230
-python_semantic_release-9.11.0.dist-info/LICENSE,sha256=NE85nszX252sdQdu0xgS9qwfYES0k8qS6gW3uO4jRGE,1083
-python_semantic_release-9.11.0.dist-info/METADATA,sha256=gFIbSJMZJhDR8gHc42q-KBJ-rPBRIi7PTv3D-vfBc58,3521
-python_semantic_release-9.11.0.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
-python_semantic_release-9.11.0.dist-info/entry_points.txt,sha256=6bS6euSagjerp7onDtfI9_ZpczWreZF3gjHfGAegkbo,123
-python_semantic_release-9.11.0.dist-info/top_level.txt,sha256=qYA24nyg3eP-ti5UW7Vuj2aXVmM0wqVHx4mREdRZNAA,17
-python_semantic_release-9.11.0.dist-info/RECORD,,
+python_semantic_release-9.12.0.dist-info/AUTHORS.rst,sha256=XOReVvpymEFUPsS2QPH97jlfJBVrxwS2eu8-jVAe4gk,230
+python_semantic_release-9.12.0.dist-info/LICENSE,sha256=NE85nszX252sdQdu0xgS9qwfYES0k8qS6gW3uO4jRGE,1083
+python_semantic_release-9.12.0.dist-info/METADATA,sha256=khksbjRrUdoB-zz8b6j6RoLqbNjtgPbRTCpzm8bOULs,3521
+python_semantic_release-9.12.0.dist-info/WHEEL,sha256=eOLhNAGa2EW3wWl_TU484h7q1UNgy0JXjjoqKoxAAQc,92
+python_semantic_release-9.12.0.dist-info/entry_points.txt,sha256=6bS6euSagjerp7onDtfI9_ZpczWreZF3gjHfGAegkbo,123
+python_semantic_release-9.12.0.dist-info/top_level.txt,sha256=qYA24nyg3eP-ti5UW7Vuj2aXVmM0wqVHx4mREdRZNAA,17
+python_semantic_release-9.12.0.dist-info/RECORD,,

semantic_release/__init__.py

@@ -24,7 +24,7 @@ from semantic_release.version import (
     tags_and_versions,
 )
 
-__version__ = "9.11.0"
+__version__ = "9.12.0"
 
 __all__ = [
     "CommitParser",

semantic_release/changelog/context.py

@@ -82,14 +82,19 @@ def make_changelog_context(
             *hvcs_client.get_changelog_context_filters(),
             read_file,
             convert_md_to_rst,
+            autofit_text_width,
         ),
     )
 
 
 def read_file(filepath: str) -> str:
     try:
+        if not filepath:
+            raise FileNotFoundError("No file path provided")  # noqa: TRY301
+
         with Path(filepath).open(newline=os.linesep) as rfd:
             return rfd.read()
+
     except FileNotFoundError as err:
         logging.warning(err)
         return ""
@@ -112,3 +117,51 @@ def convert_md_to_rst(md_content: str) -> str:
         rst_content = pattern.sub(replacement, rst_content)
 
     return rst_content
+
+
+def autofit_text_width(text: str, maxwidth: int = 100, indent_size: int = 0) -> str:
+    """Format the description text to fit within a specified width"""
+    input_text = text.strip()
+
+    if len(input_text) <= maxwidth:
+        # If the text is already within the maxwidth, return immediately
+        return input_text
+
+    indent = " " * indent_size
+    formatted_description = []
+
+    # Re-format text to fit within the maxwidth
+    for paragraph in input_text.split("\n\n"):
+        formatted_paragraph = []
+
+        # Split the paragraph into words with no empty strings
+        words = list(
+            filter(
+                None, paragraph.replace("\r", "").replace("\n", " ").strip().split(" ")
+            )
+        )
+
+        # Initialize the line for each paragraph
+        line = words[0]
+        next_line = ""
+
+        for word in words[1:]:
+            # Check if the current line + the next word (and a space) will fit within the maxwidth
+            # If it does, then update the current line
+            next_line = f"{line} {word}"
+            if len(next_line) <= maxwidth:
+                line = next_line
+                continue
+
+            # Add the current line to the paragraph and start a new line
+            formatted_paragraph.append(line)
+            line = f"{indent}{word}"
+
+        # Store the last line in the paragraph since it hasn't reached the maxwidth yet
+        formatted_paragraph.append(line)
+
+        #
+        formatted_description.append(str.join("\n", formatted_paragraph))
+
+    # Print the formatted description
+    return str.join("\n\n", formatted_description).strip()

semantic_release/changelog/release_history.py

@@ -8,6 +8,7 @@ from typing import TYPE_CHECKING, TypedDict
 from git.objects.tag import TagObject
 
 from semantic_release.commit_parser import ParseError
+from semantic_release.enums import LevelBump
 from semantic_release.version.algorithm import tags_and_versions
 
 if TYPE_CHECKING:
@@ -58,20 +59,11 @@ class ReleaseHistory:
         # we place the key-value mapping type_ to ParseResult as before.
         # We do this until we encounter a commit which another tag matches.
 
-        is_commit_released = False
         the_version: Version | None = None
 
         for commit in repo.iter_commits("HEAD", topo_order=True):
-            # mypy will be happy if we make this an explicit string
-            commit_message = str(commit.message)
-
-            parse_result = commit_parser.parse(commit)
-            commit_type = (
-                "unknown" if isinstance(parse_result, ParseError) else parse_result.type
-            )
-            log.debug("commit has type %s", commit_type)
-
-            log.debug("checking if commit %s matches any tags", commit.hexsha)
+            # Determine if we have found another release
+            log.debug("checking if commit %s matches any tags", commit.hexsha[:7])
             t_v = tag_sha_2_version_lookup.get(commit.hexsha, None)
 
             if t_v is None:
@@ -82,7 +74,6 @@ class ReleaseHistory:
                 # we have found the latest commit introduced by this tag
                 # so we create a new Release entry
                 log.debug("found commit %s for tag %s", commit.hexsha, tag.name)
-                is_commit_released = True
 
                 # tag.object is a Commit if the tag is lightweight, otherwise
                 # it is a TagObject with additional metadata about the tag
@@ -110,27 +101,55 @@ class ReleaseHistory:
 
                 released.setdefault(the_version, release)
 
-            if any(pat.match(commit_message) for pat in exclude_commit_patterns):
-                log.debug(
-                    "Skipping excluded commit %s (%s)",
-                    commit.hexsha,
-                    commit_message.replace("\n", " ")[:20],
+            # mypy will be happy if we make this an explicit string
+            commit_message = str(commit.message)
+
+            log.info(
+                "parsing commit [%s] %s",
+                commit.hexsha[:8],
+                commit_message.replace("\n", " ")[:54],
+            )
+            parse_result = commit_parser.parse(commit)
+            commit_type = (
+                "unknown" if isinstance(parse_result, ParseError) else parse_result.type
+            )
+
+            has_exclusion_match = any(
+                pattern.match(commit_message) for pattern in exclude_commit_patterns
+            )
+
+            commit_level_bump = (
+                LevelBump.NO_RELEASE
+                if isinstance(parse_result, ParseError)
+                else parse_result.bump
+            )
+
+            # Skip excluded commits except for any commit causing a version bump
+            # Reasoning: if a commit causes a version bump, and no other commits
+            # are included, then the changelog will be empty. Even if ther was other
+            # commits included, the true reason for a version bump would be missing.
+            if has_exclusion_match and commit_level_bump == LevelBump.NO_RELEASE:
+                log.info(
+                    "Excluding commit [%s] %s",
+                    commit.hexsha[:8],
+                    commit_message.replace("\n", " ")[:50],
                 )
                 continue
 
-            if not is_commit_released:
-                log.debug("adding commit %s to unreleased commits", commit.hexsha)
+            if the_version is None:
+                log.info(
+                    "[Unreleased] adding '%s' commit(%s) to list",
+                    commit.hexsha[:8],
+                    commit_type,
+                )
                 unreleased[commit_type].append(parse_result)
                 continue
 
-            if the_version is None:
-                raise RuntimeError("expected a version to be found")
-
-            log.debug(
-                "adding commit %s with type %s to release section for %s",
-                commit.hexsha,
-                commit_type,
+            log.info(
+                "[%s] adding '%s' commit(%s) to release",
                 the_version,
+                commit_type,
+                commit.hexsha[:8],
             )
 
             released[the_version]["elements"][commit_type].append(parse_result)

semantic_release/changelog/template.py

@@ -92,7 +92,6 @@ class ComplexDirectorySandboxedEnvironment(SandboxedEnvironment):
         return str(PurePosixPath(parent).parent / template)
 
 
-# pylint: disable=redefined-outer-name
 def recursive_render(
     template_dir: Path,
     environment: Environment,
@@ -103,13 +102,8 @@ def recursive_render(
         (Path(root), file)
         for root, _, files in os.walk(template_dir)
         for file in files
-        # we slice relpath.parts[1:] to allow the top-level
-        # template folder to have a dot prefix.
-        # e.g. to permit ".github/psr-templates" to contain the templates,
-        # rather than enforcing a top-level, non-hidden directory
         if not any(
-            elem.startswith(".")
-            for elem in Path(root).relative_to(template_dir).parts[1:]
+            elem.startswith(".") for elem in Path(root).relative_to(template_dir).parts
         )
         and not file.startswith(".")
     ):

semantic_release/cli/changelog_writer.py

@@ -12,6 +12,7 @@ from importlib_resources import files
 import semantic_release
 from semantic_release.changelog.context import (
     ReleaseNotesContext,
+    autofit_text_width,
     make_changelog_context,
 )
 from semantic_release.changelog.template import environment, recursive_render
@@ -245,7 +246,7 @@ def generate_release_notes(
         hvcs_type=hvcs_client.__class__.__name__.lower(),
         version=release["version"],
         release=release,
-        filters=(*hvcs_client.get_changelog_context_filters(),),
+        filters=(*hvcs_client.get_changelog_context_filters(), autofit_text_width),
     ).bind_to_environment(
         # Use a new, non-configurable environment for release notes -
         # not user-configurable at the moment

semantic_release/cli/commands/main.py

@@ -19,7 +19,7 @@ from semantic_release.cli.util import rprint
 #     pass
 
 
-FORMAT = "[%(name)s] %(levelname)s %(module)s.%(funcName)s: %(message)s"
+FORMAT = "[%(module)s.%(funcName)s] %(message)s"
 
 
 class Cli(click.MultiCommand):

semantic_release/cli/config.py

@@ -370,6 +370,22 @@ class RawConfig(BaseModel):
             )
         return found_path
 
+    @field_validator("commit_parser", mode="after")
+    @classmethod
+    def tag_commit_parser_deprecation_warning(cls, val: str) -> str:
+        if val == "tag":
+            log.warning(
+                str.join(
+                    " ",
+                    [
+                        "The legacy 'tag' parser is deprecated and will be removed in v11.",
+                        "Recommend swapping to our emoji parser (higher-compatibility)",
+                        "or switch to another supported parser.",
+                    ],
+                )
+            )
+        return val
+
     @field_validator("build_command_env", mode="after")
     @classmethod
     def remove_whitespace(cls, val: list[str]) -> list[str]:

semantic_release/commit_parser/angular.py

@@ -19,11 +19,11 @@ from semantic_release.enums import LevelBump
 if TYPE_CHECKING:
     from git.objects.commit import Commit
 
-log = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 def _logged_parse_error(commit: Commit, error: str) -> ParseError:
-    log.debug(error)
+    logger.debug(error)
     return ParseError(commit, error=error)
 
 
@@ -35,7 +35,7 @@ LONG_TYPE_NAMES = {
     "chore": "chores",
     "docs": "documentation",
     "feat": "features",
-    "fix": "fixes",
+    "fix": "bug fixes",
     "perf": "performance improvements",
     "refactor": "refactoring",
     "style": "code style",
@@ -131,12 +131,15 @@ class AngularCommitParser(CommitParser[ParseResult, AngularParserOptions]):
             level_bump = LevelBump.PATCH
         else:
             level_bump = self.options.default_bump_level
-            log.debug(
+            logger.debug(
                 "commit %s introduces a level bump of %s due to the default_bump_level",
-                commit.hexsha,
+                commit.hexsha[:8],
                 level_bump,
             )
-        log.debug("commit %s introduces a %s level_bump", commit.hexsha, level_bump)
+
+        logger.debug(
+            "commit %s introduces a %s level_bump", commit.hexsha[:8], level_bump
+        )
 
         return ParsedCommit(
             bump=level_bump,

semantic_release/commit_parser/emoji.py

@@ -89,6 +89,17 @@ class EmojiCommitParser(CommitParser[ParseResult, EmojiParserOptions]):
             level_bump = LevelBump.MINOR
         elif primary_emoji in self.options.patch_tags:
             level_bump = LevelBump.PATCH
+        else:
+            level_bump = self.options.default_bump_level
+            logger.debug(
+                "commit %s introduces a level bump of %s due to the default_bump_level",
+                commit.hexsha[:8],
+                level_bump,
+            )
+
+        logger.debug(
+            "commit %s introduces a %s level_bump", commit.hexsha[:8], level_bump
+        )
 
         # All emojis will remain part of the returned description
         descriptions = parse_paragraphs(message)

semantic_release/commit_parser/scipy.py

@@ -59,11 +59,11 @@ from semantic_release.enums import LevelBump
 if TYPE_CHECKING:
     from git.objects.commit import Commit
 
-log = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 
 def _logged_parse_error(commit: Commit, error: str) -> ParseError:
-    log.debug(error)
+    logger.debug(error)
     return ParseError(commit, error=error)
 
 
@@ -165,17 +165,19 @@ class ScipyCommitParser(CommitParser[ParseResult, ScipyParserOptions]):
                 level_bump = self.options.tag_to_level.get(
                     tag, self.options.default_level_bump
                 )
-                log.debug(
-                    "commit %s introduces a %s level_bump", commit.hexsha, level_bump
+                logger.debug(
+                    "commit %s introduces a %s level_bump",
+                    commit.hexsha[:8],
+                    level_bump,
                 )
                 break
         else:
             # some commits may not have a tag, e.g. if they belong to a PR that
             # wasn't squashed (for maintainability) ignore them
             section, level_bump = "None", self.options.default_level_bump
-            log.debug(
-                "commit %s introduces a level bump of %s due to the default_bump_level",
-                commit.hexsha,
+            logger.debug(
+                "commit %s introduces a level bump of %s due to the default bump level",
+                commit.hexsha[:8],
                 level_bump,
             )
 
@@ -185,9 +187,9 @@ class ScipyCommitParser(CommitParser[ParseResult, ScipyParserOptions]):
         ]
         if migration_instructions:
             level_bump = LevelBump.MAJOR
-            log.debug(
-                "commit %s upgraded to a %s level_bump due to migration_instructions",
-                commit.hexsha,
+            logger.debug(
+                "commit %s upgraded to a %s level bump due to included migration instructions",
+                commit.hexsha[:8],
                 level_bump,
             )
 

semantic_release/commit_parser/tag.py

@@ -11,7 +11,7 @@ from semantic_release.commit_parser.token import ParsedCommit, ParseError, Parse
 from semantic_release.commit_parser.util import breaking_re, parse_paragraphs
 from semantic_release.enums import LevelBump
 
-log = logging.getLogger(__name__)
+logger = logging.getLogger(__name__)
 
 re_parser = re.compile(r"(?P<subject>[^\n]+)" + r"(:?\n\n(?P<text>.+))?", re.DOTALL)
 
@@ -23,7 +23,7 @@ class TagParserOptions(ParserOptions):
 
 
 def _logged_parse_error(commit: Commit, error: str) -> ParseError:
-    log.debug(error)
+    logger.debug(error)
     return ParseError(commit, error=error)
 
 
@@ -87,12 +87,16 @@ class TagCommitParser(CommitParser[ParseResult, TagParserOptions]):
         if breaking_descriptions:
             level = "breaking"
             level_bump = LevelBump.MAJOR
-            log.debug(
-                "commit %s upgraded to a %s level_bump due to breaking_descriptions",
-                commit.hexsha,
+            logger.debug(
+                "commit %s upgraded to a %s level_bump due to included breaking descriptions",
+                commit.hexsha[:8],
                 level_bump,
             )
 
+        logger.debug(
+            "commit %s introduces a %s level_bump", commit.hexsha[:8], level_bump
+        )
+
         return ParsedCommit(
             bump=level_bump,
             type=level,