repomatic 7.1.0__tar.gz → 7.2.0__tar.gz

{repomatic-7.1.0 → repomatic-7.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repomatic
-Version: 7.1.0
+Version: 7.2.0
 Summary: 🏭 Automate repository maintenance, releases, and CI/CD workflows
 Keywords: changelog-formatter,dependabot-alternative,github-actions,github-labels,github-workflow,gitignore,mailmap,mypy,nuitka,python-automation,release-automation,repository-automation,repository-management,reusable-workflows,software-factory,sphinx-doc,typo,uv,workflow-reusable
 Author: Kevin Deldycke
@@ -58,7 +58,7 @@ Requires-Dist: wcmatch>=10
 Requires-Python: >=3.10
 Project-URL: Changelog, https://github.com/kdeldycke/repomatic/blob/main/changelog.md
 Project-URL: Documentation, https://kdeldycke.github.io/repomatic
-Project-URL: Download, https://github.com/kdeldycke/repomatic/releases/tag/v7.1.0
+Project-URL: Download, https://github.com/kdeldycke/repomatic/releases/tag/v7.2.0
 Project-URL: Funding, https://github.com/sponsors/kdeldycke
 Project-URL: Homepage, https://github.com/kdeldycke/repomatic
 Project-URL: Issues, https://github.com/kdeldycke/repomatic/issues

{repomatic-7.1.0 → repomatic-7.2.0}/pyproject.toml

@@ -1,11 +1,11 @@
 [build-system]
 build-backend = "uv_build"
-requires = [ "uv-build>=0.9" ]
+requires = [ "uv-build>=0.9,<0.12" ]
 
 [project]
 # Docs: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
 name = "repomatic"
-version = "7.1.0"
+version = "7.2.0"
 description = "🏭 Automate repository maintenance, releases, and CI/CD workflows"
 readme = "readme.md"
 keywords = [
@@ -122,7 +122,7 @@ dependencies = [
 ]
 urls.Changelog = "https://github.com/kdeldycke/repomatic/blob/main/changelog.md"
 urls.Documentation = "https://kdeldycke.github.io/repomatic"
-urls.Download = "https://github.com/kdeldycke/repomatic/releases/tag/v7.1.0"
+urls.Download = "https://github.com/kdeldycke/repomatic/releases/tag/v7.2.0"
 urls.Funding = "https://github.com/sponsors/kdeldycke"
 urls.Homepage = "https://github.com/kdeldycke/repomatic"
 urls.Issues = "https://github.com/kdeldycke/repomatic/issues"
@@ -206,7 +206,7 @@ exclude-newer = "1 week"
 # `exclude-newer`, returning the package to the normal cooldown. repomatic is
 # pinned to git main (no PyPI release to freeze), so it keeps a permanent
 # "0 day" span.
-exclude-newer-package = { click-extra = "2026-07-10T00:00:00Z", repomatic = "0 day" }
+exclude-newer-package = { repomatic = "0 day" }
 # Package is at root level, not in "./src/".
 build-backend.module-root = ""
 
@@ -219,7 +219,7 @@ copyright = "Kevin Deldycke <kevin@deldycke.com> and contributors. Distributed u
 file-description = "🏭 Automate repository maintenance, releases, and CI/CD workflows"
 # Numeric only: Nuitka rejects PEP 440 .devN suffixes. Kept in sync with the
 # package version by the dedicated [tool.bumpversion] rule that strips the suffix.
-file-version = "7.1.0"
+file-version = "7.2.0"
 include-data-dir = [
   "repomatic/data/awesome_template=repomatic/data/awesome_template",
 ]
@@ -237,7 +237,7 @@ include-package-data = [ "click_extra" ]
 linux-icon = "docs/assets/icon.png"
 macos-app-icon = "docs/assets/icon.icns"
 product-name = "Repomatic"
-product-version = "7.1.0"
+product-version = "7.2.0"
 windows-icon-from-ico = "docs/assets/icon.ico"
 
 [tool.ruff]
@@ -276,7 +276,14 @@ default.extend-identifiers = { Github = "GitHub", IOS = "iOS", Javascript = "Jav
 # False positives.
 default.extend-words = { astroid = "astroid", oject = "oject", PNGs = "PNGs" }
 # Skip content between <!-- typos:off --> and <!-- typos:on --> markers.
-default.extend-ignore-re = [ "(?s)<!-- typos:off -->.*?<!-- typos:on -->" ]
+default.extend-ignore-re = [
+  "(?s)<!-- typos:off -->.*?<!-- typos:on -->",
+  # `{qeury}` is the intentional-typo example in the typos tool's own docs_notes
+  # guidance (tool_runner.py), which recommends downstream projects guard such
+  # examples and encoded hashes from the unattended fix-typos pull request.
+  "\\{qeury\\}",
+  'base32 "[0-9a-z]{52}"',
+]
 default.extend-ignore-identifiers-re = [
   # error: `certifi` should be `certify`, `certifies`, `certified`
   #     ╭▸ ./docs/assets/dependencies.mmd:184:11
@@ -344,7 +351,7 @@ run.source = [ "repomatic" ]
 report.precision = 2
 
 [tool.bumpversion]
-current_version = "7.1.0"
+current_version = "7.2.0"
 # Parse versions with an optional .devN suffix (PEP 440).
 parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)(\\.dev(?P<dev>\\d+))?"
 serialize = [
@@ -399,9 +406,13 @@ search = "## [`{current_version}` (unreleased)]("
 replace = "## [`{new_version}` (unreleased)]("
 
 [[tool.bumpversion.files]]
-# Update the version in the citation file.
+# Update the version in the citation file. Anchored to a line start (regex) so
+# it does not also match the `cff-version:` schema field, which would otherwise
+# be overwritten with the package version on every bump as soon as the two
+# values coincide once.
 filename = "./citation.cff"
-search = "version: {current_version}"
+regex = true
+search = "(?m)^version: {current_version}"
 replace = "version: {new_version}"
 
 [[tool.bumpversion.files]]

{repomatic-7.1.0 → repomatic-7.2.0}/repomatic/__init__.py

@@ -17,5 +17,5 @@
 
 from __future__ import annotations
 
-__version__ = "7.1.0"
-__git_tag_sha__ = "8d3bdd26cb0a91c422f1b7210cb978ba75865822"
+__version__ = "7.2.0"
+__git_tag_sha__ = "7336863d9f3f5faea26f887211f3f745dc963fb5"

{repomatic-7.1.0 → repomatic-7.2.0}/repomatic/broken_links.py

@@ -21,7 +21,7 @@ GitHub issue. Sphinx linkcheck parsing detects broken auto-generated links
 (intersphinx, autodoc, type annotations) that Lychee cannot see because they
 only exist in the rendered HTML output.
 
-Issue lifecycle management is delegated to {mod}`~repomatic.issue`.
+Issue lifecycle management is delegated to {mod}`~repomatic.github.issue`.
 """
 
 from __future__ import annotations

{repomatic-7.1.0 → repomatic-7.2.0}/repomatic/cache.py

@@ -55,6 +55,31 @@ from extra_platforms import is_macos, is_windows
 
 from .config import load_repomatic_config
 
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+    from collections.abc import Callable
+    from typing import Any
+
+
+def _atomic_write(dest: Path, prefix: str, write: Callable[[Path], object]) -> None:
+    """Write *dest* atomically: temp file in the target directory, then rename.
+
+    The rename is atomic on POSIX (same-filesystem rename) and safe on Windows
+    (`Path.replace` overwrites atomically). *write* receives the temp path and
+    fills it (its return value is ignored, so `write_text`/`write_bytes` pass
+    straight through); partial writes are cleaned up on any failure.
+    """
+    dest.parent.mkdir(parents=True, exist_ok=True)
+    fd, tmp = tempfile.mkstemp(dir=dest.parent, prefix=prefix, suffix=".tmp")
+    try:
+        os.close(fd)
+        write(Path(tmp))
+        Path(tmp).replace(dest)
+    except BaseException:
+        # Clean up partial writes on any failure.
+        Path(tmp).unlink(missing_ok=True)
+        raise
+
 
 @dataclass(frozen=True)
 class CacheEntry:
@@ -235,17 +260,8 @@ def store_binary(
     :return: Path to the cached binary.
     """
     dest = cached_binary_path(name, version, platform_key, source.name)
-    dest.parent.mkdir(parents=True, exist_ok=True)
 
-    # Atomic write: temp file in same directory, then rename.
-    fd, tmp = tempfile.mkstemp(
-        dir=dest.parent,
-        prefix=f".{source.name}.",
-        suffix=".tmp",
-    )
-    try:
-        os.close(fd)
-        tmp_path = Path(tmp)
+    def fill(tmp_path: Path) -> None:
         shutil.copy2(source, tmp_path)
         tmp_path.chmod(0o755)
         # copy2 preserves the source mtime, which for a binary extracted from
@@ -254,12 +270,8 @@ def store_binary(
         # auto_purge() call below, before this store even returns. Stamp the
         # store time instead.
         os.utime(tmp_path)
-        tmp_path.replace(dest)
-    except BaseException:
-        # Clean up partial writes on any failure.
-        Path(tmp).unlink(missing_ok=True)
-        raise
 
+    _atomic_write(dest, f".{source.name}.", fill)
     logging.debug("Cached %s %s for %s at %s.", name, version, platform_key, dest)
     auto_purge()
     return dest
@@ -322,30 +334,14 @@ def clear_cache(
     if not bin_root.is_dir():
         return 0, 0
 
-    cutoff = time.time() - (max_age_days * 86400) if max_age_days is not None else None
-    files_deleted = 0
-    bytes_freed = 0
-
-    for entry in cache_info():
-        if tool is not None and entry.tool != tool:
-            continue
-        if cutoff is not None and entry.mtime >= cutoff:
-            continue
-        logging.debug("Purging cached binary: %s", entry.path)
-        try:
-            bytes_freed += entry.size
-            entry.path.unlink()
-            # Remove the .sha256 sidecar if present.
-            sidecar = entry.path.with_suffix(entry.path.suffix + ".sha256")
-            if sidecar.is_file():
-                sidecar.unlink()
-            files_deleted += 1
-        except OSError:
-            logging.debug("Failed to remove %s.", entry.path)
-
-    # Prune empty parent directories up to bin_root.
-    _prune_empty_dirs(bin_root)
-    return files_deleted, bytes_freed
+    return _purge(
+        cache_info(),
+        bin_root,
+        keep=lambda entry: (
+            (tool is not None and entry.tool != tool) or _is_fresh(entry, max_age_days)
+        ),
+        sidecars=True,
+    )
 
 
 # ---------------------------------------------------------------------------
@@ -405,20 +401,7 @@ def store_response(
     """
     dest = _http_dir() / namespace / f"{key}.json"
     try:
-        dest.parent.mkdir(parents=True, exist_ok=True)
-        fd, tmp = tempfile.mkstemp(
-            dir=dest.parent,
-            prefix=".response.",
-            suffix=".tmp",
-        )
-        try:
-            os.close(fd)
-            tmp_path = Path(tmp)
-            tmp_path.write_bytes(data)
-            tmp_path.replace(dest)
-        except BaseException:
-            Path(tmp).unlink(missing_ok=True)
-            raise
+        _atomic_write(dest, ".response.", lambda tmp_path: tmp_path.write_bytes(data))
     except OSError:
         logging.debug("Failed to cache HTTP response: %s/%s.", namespace, key)
         return None
@@ -478,25 +461,14 @@ def clear_http_cache(
     if not http_root.is_dir():
         return 0, 0
 
-    cutoff = time.time() - (max_age_days * 86400) if max_age_days is not None else None
-    files_deleted = 0
-    bytes_freed = 0
-
-    for entry in http_cache_info():
-        if namespace is not None and entry.namespace != namespace:
-            continue
-        if cutoff is not None and entry.mtime >= cutoff:
-            continue
-        logging.debug("Purging cached response: %s", entry.path)
-        try:
-            bytes_freed += entry.size
-            entry.path.unlink()
-            files_deleted += 1
-        except OSError:
-            logging.debug("Failed to remove %s.", entry.path)
-
-    _prune_empty_dirs(http_root)
-    return files_deleted, bytes_freed
+    return _purge(
+        http_cache_info(),
+        http_root,
+        keep=lambda entry: (
+            (namespace is not None and entry.namespace != namespace)
+            or _is_fresh(entry, max_age_days)
+        ),
+    )
 
 
 # ---------------------------------------------------------------------------
@@ -528,20 +500,11 @@ def store_config(
     """
     dest = _config_dir() / tool_name / filename
     try:
-        dest.parent.mkdir(parents=True, exist_ok=True)
-        fd, tmp = tempfile.mkstemp(
-            dir=dest.parent,
-            prefix=f".{filename}.",
-            suffix=".tmp",
+        _atomic_write(
+            dest,
+            f".{filename}.",
+            lambda tmp_path: tmp_path.write_text(content, encoding="UTF-8"),
         )
-        try:
-            os.close(fd)
-            tmp_path = Path(tmp)
-            tmp_path.write_text(content, encoding="UTF-8")
-            tmp_path.replace(dest)
-        except BaseException:
-            Path(tmp).unlink(missing_ok=True)
-            raise
     except OSError:
         logging.debug("Failed to cache config for %s.", tool_name)
         return None
@@ -592,21 +555,64 @@ def clear_config_cache(
     if not config_root.is_dir():
         return 0, 0
 
+    return _purge(
+        config_cache_info(),
+        config_root,
+        keep=lambda entry: tool is not None and entry.tool != tool,
+    )
+
+
+def _is_fresh(
+    entry: CacheEntry | HttpCacheEntry | ConfigCacheEntry,
+    max_age_days: int | None,
+) -> bool:
+    """Whether *entry* is younger than the age cutoff.
+
+    A `None` cutoff keeps nothing: age-unfiltered clears delete every entry
+    the caller's other filters matched.
+    """
+    if max_age_days is None:
+        return False
+    return entry.mtime >= time.time() - max_age_days * 86400
+
+
+def _purge(
+    entries: list[CacheEntry] | list[HttpCacheEntry] | list[ConfigCacheEntry],
+    root: Path,
+    *,
+    keep: Callable[[Any], bool],
+    sidecars: bool = False,
+) -> tuple[int, int]:
+    """Delete the cache *entries* not spared by the *keep* predicate.
+
+    Shared delete loop behind {func}`clear_cache`, {func}`clear_http_cache`,
+    and {func}`clear_config_cache`. Empty parent directories under *root* are
+    pruned afterwards.
+
+    :param entries: Candidate entries from one of the `*_cache_info()` listers.
+    :param root: The cache subtree the entries live in.
+    :param keep: Entries for which this returns `True` are left untouched.
+    :param sidecars: Also remove each entry's `.sha256` sidecar (binary cache).
+    :return: Tuple of (files_deleted, bytes_freed).
+    """
     files_deleted = 0
     bytes_freed = 0
-
-    for entry in config_cache_info():
-        if tool is not None and entry.tool != tool:
+    for entry in entries:
+        if keep(entry):
             continue
-        logging.debug("Purging cached config: %s", entry.path)
+        logging.debug("Purging cache entry: %s", entry.path)
         try:
             bytes_freed += entry.size
             entry.path.unlink()
+            if sidecars:
+                sidecar = entry.path.with_suffix(entry.path.suffix + ".sha256")
+                if sidecar.is_file():
+                    sidecar.unlink()
             files_deleted += 1
         except OSError:
             logging.debug("Failed to remove %s.", entry.path)
 
-    _prune_empty_dirs(config_root)
+    _prune_empty_dirs(root)
     return files_deleted, bytes_freed
 
 

{repomatic-7.1.0 → repomatic-7.2.0}/repomatic/changelog.py

@@ -102,7 +102,7 @@ of this code *and* adding a new dependency — more complexity, not less.
 Related modules
 ^^^^^^^^^^^^^^^
 
-- `release_prep.py` orchestrates the full release preparation
+- `prepare_release.py` orchestrates the full release preparation
   across changelog, citation, and workflow files, delegating
   changelog operations to this module.
 - `metadata.py` handles version bump eligibility checks and
@@ -124,6 +124,7 @@ from packaging.version import Version
 
 from .git_ops import get_all_version_tags, get_tag_date
 from .github.actions import AnnotationLevel, emit_annotation
+from .github.pr_body import render_template
 from .github.releases import (
     GitHubRelease,
     GitHubReleasesUnavailable,
@@ -292,9 +293,6 @@ class Changelog:
         if not self.current_version:
             return self.content.rstrip()
 
-        # Lazy import to avoid circular dependency: pr_body → metadata → changelog.
-        from .github.pr_body import render_template
-
         elements = self.decompose_version(self.current_version)
 
         # Idempotent: skip if an unreleased section already exists.
@@ -350,9 +348,6 @@ class Changelog:
         if not self.current_version:
             return False
 
-        # Lazy import to avoid circular dependency: pr_body → metadata → changelog.
-        from .github.pr_body import render_template
-
         elements = self.decompose_version(self.current_version)
         if not elements.version:
             return False
@@ -488,9 +483,6 @@ class Changelog:
                 lower_version = v
                 break
 
-        # Lazy import to avoid circular dependency: pr_body → metadata → changelog.
-        from .github.pr_body import render_template
-
         compare_base = f"v{lower_version}" if lower_version else "v0.0.0"
         elements = VersionElements(
             compare_url=f"{repo_url}/compare/{compare_base}...v{version}",
@@ -687,8 +679,6 @@ def build_release_admonition(
         links.append(f"[{GITHUB_LABEL}]({github_url})")
     if not links:
         return ""
-    # Lazy import to avoid circular dependency: pr_body → metadata → changelog.
-    from .github.pr_body import render_template
 
     platforms = " and ".join(links)
     verb = FIRST_AVAILABLE_VERB if first_on_all else AVAILABLE_VERB
@@ -718,8 +708,6 @@ def build_unavailable_admonition(
         names.append(GITHUB_LABEL)
     if not names:
         return ""
-    # Lazy import to avoid circular dependency: pr_body → metadata → changelog.
-    from .github.pr_body import render_template
 
     platforms = " and ".join(names)
     return render_template(
@@ -1133,9 +1121,6 @@ def lint_changelog_dates(
     # decomposing and re-rendering an already-correct section is a
     # no-op.
     if fix:
-        # Lazy import to avoid circular dependency: pr_body → metadata → changelog.
-        from .github.pr_body import render_template
-
         for version, _date in releases:
             elements = changelog.decompose_version(version)
 
@@ -1235,3 +1220,48 @@ def lint_changelog_dates(
     if fix and modified:
         return 0
     return 1 if has_mismatch else 0
+
+
+def build_expected_body(
+    changelog: Changelog,
+    version: str,
+    *,
+    admonition_override: str | None = None,
+) -> str:
+    """Build the expected release body from the changelog.
+
+    Decomposes the changelog section into discrete elements and renders
+    them through the `github-releases` template. This allows the
+    GitHub release body to include a different subset of elements than
+    the `release-notes` template used for `changelog.md` entries.
+
+    :param changelog: Parsed changelog instance.
+    :param version: Version string (e.g. `1.2.3`).
+    :param admonition_override: If provided, replaces the
+        `availability_admonition` from the changelog. Used by
+        `release_notes_with_admonition` to inject a pre-computed
+        admonition at release time.
+    :return: The rendered release body, or empty string if the
+        version has no changelog section.
+    """
+    elements = changelog.decompose_version(version)
+    if (
+        not elements.changes
+        and not elements.availability_admonition
+        and not elements.development_warning
+        and not elements.editorial_admonition
+        and not elements.yanked_admonition
+    ):
+        return ""
+
+    if admonition_override is not None:
+        elements.availability_admonition = admonition_override
+    # Extract tag range from compare URL (e.g. "v1.1.0...v2.0.0").
+    tag_range = (
+        elements.compare_url.rsplit("/compare/", 1)[-1] if elements.compare_url else ""
+    )
+    return render_template(
+        "github-releases",
+        **asdict(elements),
+        tag_range=tag_range,
+    )