[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Author: pre-commit-ci[bot]

vcs-versioning/src/vcs_versioning/_version_schemes_towncrier.py

@@ -3,7 +3,7 @@
 This version scheme analyzes changelog fragments in the changelog.d/ directory
 to determine the appropriate version bump:
 - Major bump: if 'removal' fragments are present
-- Minor bump: if 'feature' or 'deprecation' fragments are present  
+- Minor bump: if 'feature' or 'deprecation' fragments are present
 - Patch bump: if only 'bugfix', 'doc', or 'misc' fragments are present
 
 Falls back to guess-next-dev if no fragments are found.
@@ -12,10 +12,13 @@
 from __future__ import annotations
 
 import logging
-import os
 from pathlib import Path
 
-from ._version_schemes import ScmVersion, guess_next_dev_version, guess_next_simple_semver
+from ._version_schemes import (
+    ScmVersion,
+    guess_next_dev_version,
+    guess_next_simple_semver,
+)
 
 log = logging.getLogger(__name__)
 
@@ -27,104 +30,106 @@
 ALL_FRAGMENT_TYPES = MAJOR_FRAGMENT_TYPES | MINOR_FRAGMENT_TYPES | PATCH_FRAGMENT_TYPES
 
 
-def _find_fragments(root: Path, changelog_dir: str = "changelog.d") -> dict[str, list[str]]:
+def _find_fragments(
+    root: Path, changelog_dir: str = "changelog.d"
+) -> dict[str, list[str]]:
     """Find and categorize changelog fragments.
-    
+
     Args:
         root: Root directory to search from
         changelog_dir: Name of the changelog directory
-        
+
     Returns:
         Dictionary mapping fragment types to lists of fragment filenames
     """
     fragments: dict[str, list[str]] = {ftype: [] for ftype in ALL_FRAGMENT_TYPES}
-    
+
     changelog_path = root / changelog_dir
     if not changelog_path.exists():
         log.debug("No changelog directory found at %s", changelog_path)
         return fragments
-    
+
     for entry in changelog_path.iterdir():
         if not entry.is_file():
             continue
-        
+
         # Skip template, README, and .gitkeep files
         if entry.name in ("template.md", "README.md", ".gitkeep"):
             continue
-            
+
         # Fragment naming: {number}.{type}.md
         parts = entry.name.split(".")
         if len(parts) >= 2:
             fragment_type = parts[1]
             if fragment_type in ALL_FRAGMENT_TYPES:
                 fragments[fragment_type].append(entry.name)
                 log.debug("Found %s fragment: %s", fragment_type, entry.name)
-    
+
     return fragments
 
 
 def _determine_bump_type(fragments: dict[str, list[str]]) -> str | None:
     """Determine version bump type from fragments.
-    
+
     Returns:
         'major', 'minor', 'patch', or None if no fragments found
     """
     # Check for any fragments at all
     total_fragments = sum(len(files) for files in fragments.values())
     if total_fragments == 0:
         return None
-    
+
     # Major bump if any removal fragments
     if any(fragments[ftype] for ftype in MAJOR_FRAGMENT_TYPES):
         return "major"
-    
+
     # Minor bump if any feature/deprecation fragments
     if any(fragments[ftype] for ftype in MINOR_FRAGMENT_TYPES):
         return "minor"
-    
+
     # Patch bump for other fragments
     if any(fragments[ftype] for ftype in PATCH_FRAGMENT_TYPES):
         return "patch"
-    
+
     return None
 
 
 def version_from_fragments(version: ScmVersion) -> str:
     """Version scheme that determines version from towncrier fragments.
-    
+
     This is the main entry point registered as a setuptools_scm version scheme.
-    
+
     Args:
         version: ScmVersion object from VCS
-        
+
     Returns:
         Formatted version string
     """
     # If we're exactly on a tag, return it
     if version.exact:
         return version.format_with("{tag}")
-    
+
     # Try to find the root directory (where changelog.d/ should be)
     # The config object should have the root
     root = Path(version.config.absolute_root)
-    
+
     log.debug("Analyzing fragments in %s", root)
-    
+
     # Find and analyze fragments
     fragments = _find_fragments(root)
     bump_type = _determine_bump_type(fragments)
-    
+
     if bump_type is None:
         log.debug("No fragments found, falling back to guess-next-dev")
         return guess_next_dev_version(version)
-    
+
     log.info("Determined version bump type from fragments: %s", bump_type)
-    
+
     # Determine the next version based on bump type
     if bump_type == "major":
         # Major bump: increment major version, reset minor and patch to 0
         from . import _modify_version
-        
+
         def guess_next_major(v: ScmVersion) -> str:
             tag_version = _modify_version.strip_local(str(v.tag))
             parts = tag_version.split(".")
@@ -134,16 +139,21 @@ def guess_next_major(v: ScmVersion) -> str:
             # Fallback to bump_dev
             bumped = _modify_version._bump_dev(tag_version)
             return bumped if bumped is not None else f"{tag_version}.dev0"
-        
+
         return version.format_next_version(guess_next_major)
-    
+
     elif bump_type == "minor":
         # Minor bump: use simplified semver with MINOR retention
         from ._version_schemes import SEMVER_MINOR
-        return version.format_next_version(guess_next_simple_semver, retain=SEMVER_MINOR)
-    
+
+        return version.format_next_version(
+            guess_next_simple_semver, retain=SEMVER_MINOR
+        )
+
     else:  # patch
         # Patch bump: use simplified semver with PATCH retention
         from ._version_schemes import SEMVER_PATCH
-        return version.format_next_version(guess_next_simple_semver, retain=SEMVER_PATCH)
 
+        return version.format_next_version(
+            guess_next_simple_semver, retain=SEMVER_PATCH
+        )

vcs-versioning/testing_vcs/test_version_scheme_towncrier.py

@@ -243,7 +243,9 @@ def test_determine_bump_type_patch_mixed() -> None:
     assert _determine_bump_type(fragments) == "patch"
 
 
-def test_version_from_fragments_exact(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_exact(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test version scheme when exactly on a tag."""
     version = ScmVersion(
         tag=Version("1.2.3"),
@@ -256,7 +258,9 @@ def test_version_from_fragments_exact(changelog_dir: Path, config: _config.Confi
     assert result == "1.2.3"
 
 
-def test_version_from_fragments_no_fragments(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_no_fragments(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test version scheme with no fragments falls back to guess-next-dev."""
     version = ScmVersion(
         tag=Version("1.2.3"),
@@ -270,7 +274,9 @@ def test_version_from_fragments_no_fragments(changelog_dir: Path, config: _confi
     assert result.startswith("1.2.4.dev5")
 
 
-def test_version_from_fragments_major_bump(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_major_bump(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test version scheme with removal fragments (major bump)."""
     (changelog_dir / "1.removal.md").write_text("Remove old API")
 
@@ -285,7 +291,9 @@ def test_version_from_fragments_major_bump(changelog_dir: Path, config: _config.
     assert result.startswith("2.0.0.dev5")
 
 
-def test_version_from_fragments_minor_bump(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_minor_bump(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test version scheme with feature fragments (minor bump)."""
     (changelog_dir / "1.feature.md").write_text("Add new feature")
 
@@ -300,7 +308,9 @@ def test_version_from_fragments_minor_bump(changelog_dir: Path, config: _config.
     assert result.startswith("1.3.0.dev5")
 
 
-def test_version_from_fragments_patch_bump(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_patch_bump(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test version scheme with bugfix fragments (patch bump)."""
     (changelog_dir / "1.bugfix.md").write_text("Fix bug")
 
@@ -315,7 +325,9 @@ def test_version_from_fragments_patch_bump(changelog_dir: Path, config: _config.
     assert result.startswith("1.2.4.dev5")
 
 
-def test_version_from_fragments_precedence(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_precedence(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test that removal > feature > bugfix precedence works."""
     # Add all three types - removal should win
     (changelog_dir / "1.removal.md").write_text("Remove API")
@@ -334,7 +346,9 @@ def test_version_from_fragments_precedence(changelog_dir: Path, config: _config.
     assert result.startswith("2.0.0.dev5")
 
 
-def test_version_from_fragments_minor_over_patch(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_minor_over_patch(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test that feature takes precedence over bugfix."""
     (changelog_dir / "1.feature.md").write_text("Add feature")
     (changelog_dir / "2.bugfix.md").write_text("Fix bug")
@@ -351,7 +365,9 @@ def test_version_from_fragments_minor_over_patch(changelog_dir: Path, config: _c
     assert result.startswith("1.3.0.dev5")
 
 
-def test_version_from_fragments_deprecation_is_minor(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_deprecation_is_minor(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test that deprecation triggers a minor bump."""
     (changelog_dir / "1.deprecation.md").write_text("Deprecate method")
 
@@ -366,7 +382,9 @@ def test_version_from_fragments_deprecation_is_minor(changelog_dir: Path, config
     assert result.startswith("1.3.0.dev5")
 
 
-def test_version_from_fragments_doc_is_patch(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_doc_is_patch(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test that doc changes trigger a patch bump."""
     (changelog_dir / "1.doc.md").write_text("Update docs")
 
@@ -381,7 +399,9 @@ def test_version_from_fragments_doc_is_patch(changelog_dir: Path, config: _confi
     assert result.startswith("1.2.4.dev5")
 
 
-def test_version_from_fragments_misc_is_patch(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_misc_is_patch(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test that misc changes trigger a patch bump."""
     (changelog_dir / "1.misc.md").write_text("Refactor")
 
@@ -396,7 +416,9 @@ def test_version_from_fragments_misc_is_patch(changelog_dir: Path, config: _conf
     assert result.startswith("1.2.4.dev5")
 
 
-def test_version_from_fragments_major_from_0_x(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_major_from_0_x(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test major bump from 0.x version."""
     (changelog_dir / "1.removal.md").write_text("Remove API")
 
@@ -411,7 +433,9 @@ def test_version_from_fragments_major_from_0_x(changelog_dir: Path, config: _con
     assert result.startswith("1.0.0.dev5")
 
 
-def test_version_from_fragments_minor_from_0_x(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_minor_from_0_x(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test minor bump from 0.x version."""
     (changelog_dir / "1.feature.md").write_text("Add feature")
 
@@ -426,7 +450,9 @@ def test_version_from_fragments_minor_from_0_x(changelog_dir: Path, config: _con
     assert result.startswith("0.6.0.dev5")
 
 
-def test_version_from_fragments_missing_changelog_dir(config: _config.Configuration) -> None:
+def test_version_from_fragments_missing_changelog_dir(
+    config: _config.Configuration,
+) -> None:
     """Test version scheme when changelog.d directory doesn't exist."""
     version = ScmVersion(
         tag=Version("1.2.3"),
@@ -440,7 +466,9 @@ def test_version_from_fragments_missing_changelog_dir(config: _config.Configurat
     assert result.startswith("1.2.4.dev5")
 
 
-def test_version_from_fragments_dirty(changelog_dir: Path, config: _config.Configuration) -> None:
+def test_version_from_fragments_dirty(
+    changelog_dir: Path, config: _config.Configuration
+) -> None:
     """Test version scheme with dirty working directory."""
     (changelog_dir / "1.feature.md").write_text("Add feature")