fix(cmd-version): fix handling of multiple prerelease token variants & git flow merges (python-semantic-release#1120)

* refactor: define a custom logging level of silly

* fix(version): remove some excessive log msgs from debug to silly level

* test(fixtures): refactor builder functions for version file updates

* test(fixtures): adjust build command to handle versions w/ build metadata

* test(fixtures): fix gitflow repo that included an invalid build metadata string

* test(fixtures): fix major_on_zero setting in repos to match expected behavior

* test(cmd-version): add test cases to run an example repo rebuild w/ psr

* test(cmd-version): enable git flow repo rebuild w/ psr test cases

* fix(cmd-version): handle multiple prerelease token variants properly

  In the case where there are alpha and beta releases, we must only
  consider the previous beta release even if alpha releases exist
  due to merging into beta release only branches which have no changes
  considerable changes from alphas but must be marked otherwise.

  Resolves: python-semantic-release#789

* fix(cmd-version): fix version determination algorithm to capture commits across merged branches

* perf(cmd-version): refactor version determination algorithm for accuracy & speed

* test(algorithm): refactor test to match new function signature

* style(algorithm): drop unused functions & imports

* test(algorithm): adapt test case for new DFS commit traversal implementation

Author: codejedi365

src/semantic_release/cli/commands/main.py

@@ -15,6 +15,7 @@
 from semantic_release.cli.config import GlobalCommandLineOptions
 from semantic_release.cli.const import DEFAULT_CONFIG_FILE
 from semantic_release.cli.util import rprint
+from semantic_release.enums import SemanticReleaseLogLevels
 
 # if TYPE_CHECKING:
 #     pass
@@ -108,7 +109,15 @@ def main(
     """
     console = Console(stderr=True)
 
-    log_level = [logging.WARNING, logging.INFO, logging.DEBUG][verbosity]
+    log_levels = [
+        SemanticReleaseLogLevels.WARNING,
+        SemanticReleaseLogLevels.INFO,
+        SemanticReleaseLogLevels.DEBUG,
+        SemanticReleaseLogLevels.SILLY,
+    ]
+
+    log_level = log_levels[verbosity]
+
     logging.basicConfig(
         level=log_level,
         format=FORMAT,
@@ -123,7 +132,7 @@ def main(
     logger = logging.getLogger(__name__)
     logger.debug("logging level set to: %s", logging.getLevelName(log_level))
 
-    if log_level == logging.DEBUG:
+    if log_level <= logging.DEBUG:
         globals.debug = True
 
     if noop:

src/semantic_release/enums.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import logging
 from enum import IntEnum, unique
 
 
@@ -37,3 +38,32 @@ def from_string(cls, val: str) -> LevelBump:
         >>> LevelBump.from_string("minor") == LevelBump.MINOR
         """
         return cls[val.upper().replace("-", "_")]
+
+
+class SemanticReleaseLogLevels(IntEnum):
+    """IntEnum representing the log levels used by semantic-release."""
+
+    FATAL = logging.FATAL
+    CRITICAL = logging.CRITICAL
+    ERROR = logging.ERROR
+    WARNING = logging.WARNING
+    INFO = logging.INFO
+    DEBUG = logging.DEBUG
+    SILLY = 5
+
+    def __str__(self) -> str:
+        """
+        Return the level name rather than 'SemanticReleaseLogLevels.<level>'
+        E.g.
+        >>> str(SemanticReleaseLogLevels.DEBUG)
+        'DEBUG'
+        >>> str(SemanticReleaseLogLevels.CRITICAL)
+        'CRITICAL'
+        """
+        return self.name.upper()
+
+
+logging.addLevelName(
+    SemanticReleaseLogLevels.SILLY,
+    str(SemanticReleaseLogLevels.SILLY),
+)