repomatic 7.3.0__tar.gz → 7.4.0__tar.gz

{repomatic-7.3.0 → repomatic-7.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: repomatic
-Version: 7.3.0
+Version: 7.4.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
@@ -46,10 +46,11 @@ Classifier: Typing :: Typed
 Requires-Dist: arrow>=1.3
 Requires-Dist: backports-strenum>=1 ; python_full_version < '3.11'
 Requires-Dist: boltons>=25
-Requires-Dist: click-extra>=8.5
+Requires-Dist: click-extra>=8.8
 Requires-Dist: extra-platforms>=12.0.2
 Requires-Dist: packaging>=17
 Requires-Dist: py-walk>=0.3.1
+Requires-Dist: pyelftools>=0.33
 Requires-Dist: pyproject-metadata>=0.9
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: tomlrt>=1.7.6
@@ -58,7 +59,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.3.0
+Project-URL: Download, https://github.com/kdeldycke/repomatic/releases/tag/v7.4.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
@@ -153,7 +154,3 @@ Check these projects to get real-life examples of usage and inspiration:
 - ![GitHub stars](https://img.shields.io/github/stars/kdeldycke/extra-platforms?label=%E2%AD%90&style=flat-square) [Extra Platforms](https://github.com/kdeldycke/extra-platforms) - Detect platforms and group them by family.
 
 Send a PR to add your project if you use repomatic.
-
-## Development
-
-See `claude.md` for development commands, code style, testing guidelines, and design principles.

repomatic-7.4.0/pyproject.toml

@@ -0,0 +1,337 @@
+[build-system]
+build-backend = "uv_build"
+requires = ["uv-build>=0.12"]
+
+[project]
+name = "repomatic"
+version = "7.4.0"
+description = "🏭 Automate repository maintenance, releases, and CI/CD workflows"
+readme = "readme.md"
+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",
+]
+license = "GPL-2.0-or-later"
+license-files = ["license"]
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Framework :: Sphinx",
+    "Intended Audience :: Developers",
+    "Operating System :: MacOS :: MacOS X",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: BSD :: FreeBSD",
+    "Operating System :: POSIX :: BSD :: NetBSD",
+    "Operating System :: POSIX :: BSD :: OpenBSD",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Unix Shell",
+    "Topic :: Documentation :: Sphinx",
+    "Topic :: File Formats :: JSON",
+    "Topic :: Security",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Compilers",
+    "Topic :: Software Development :: Documentation",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Version Control :: Git",
+    "Topic :: System :: Archiving :: Packaging",
+    "Topic :: System :: Installation/Setup",
+    "Topic :: System :: Shells",
+    "Topic :: System :: Software Distribution",
+    "Topic :: Terminals",
+    "Topic :: Text Processing :: Markup :: HTML",
+    "Topic :: Text Processing :: Markup :: Markdown",
+    "Topic :: Utilities",
+    "Typing :: Typed",
+]
+dependencies = [
+    "arrow>=1.3",
+    "backports-strenum>=1; python_version<'3.11'",
+    "boltons>=25",
+    "click-extra>=8.8",
+    "extra-platforms>=12.0.2",
+    "packaging>=17",
+    "py-walk>=0.3.1",
+    "pyelftools>=0.33",
+    "pyproject-metadata>=0.9",
+    "pyyaml>=6.0.3",
+    "tomlrt>=1.7.6",
+    "vt-py>=0.18",
+    "wcmatch>=10",
+]
+
+[[project.authors]]
+name = "Kevin Deldycke"
+email = "kevin@deldycke.com"
+
+[project.urls]
+Changelog = "https://github.com/kdeldycke/repomatic/blob/main/changelog.md"
+Documentation = "https://kdeldycke.github.io/repomatic"
+Download = "https://github.com/kdeldycke/repomatic/releases/tag/v7.4.0"
+Funding = "https://github.com/sponsors/kdeldycke"
+Homepage = "https://github.com/kdeldycke/repomatic"
+Issues = "https://github.com/kdeldycke/repomatic/issues"
+Repository = "https://github.com/kdeldycke/repomatic"
+
+[project.scripts]
+repomatic = "repomatic.__main__:main"
+
+[dependency-groups]
+test = [
+    "coverage[toml]>=7.11",
+    "pytest>=9",
+    "pytest-cov>=4",
+    "pytest-github-actions-annotate-failures>=0.2",
+    "pytest-randomly>=3",
+    "pytest-xdist[psutil]>=3.7",
+]
+docs = [
+    "click-extra[sphinx]",
+    "furo>=2025.9.25",
+    "myst-parser>=5.1",
+    "sphinx>=8",
+    "sphinx-autodoc-typehints>=2.4",
+    "sphinx-copybutton>=0.5.2",
+    "sphinx-datatables>=1",
+    "sphinx-design>=0.6",
+    "sphinxcontrib-mermaid>=1.2.3",
+    "sphinxext-opengraph>=0.13",
+]
+typing = [
+    "backports-strenum>=1",
+    "types-boltons>=25.0.0.20250822",
+    "types-docutils>=0.22.3.20251115",
+    "types-pyyaml>=6.0.12.9",
+]
+
+[tool.uv]
+required-version = ">=0.12"
+exclude-newer = "1 week"
+
+[tool.uv.dependency-groups.docs]
+requires-python = ">= 3.14"
+
+[tool.uv.exclude-newer-package]
+click-extra = "2026-08-02T00:00:00Z"
+extra-platforms = "2026-07-28T00:00:00Z"
+repomatic = "0 day"
+
+[tool.uv.build-backend]
+module-root = ""
+
+[tool.nuitka]
+copyright = "Kevin Deldycke <kevin@deldycke.com> and contributors. Distributed under GPL-2.0-or-later license."
+file-description = "🏭 Automate repository maintenance, releases, and CI/CD workflows"
+file-version = "7.4.0"
+include-data-dir = ["repomatic/data/awesome_template=repomatic/data/awesome_template"]
+include-data-files = ["repomatic/templates/*.md=repomatic/templates/"]
+include-package-data = ["click_extra"]
+linux-icon = "docs/assets/icon.png"
+macos-app-icon = "docs/assets/icon.icns"
+product-name = "Repomatic"
+product-version = "7.4.0"
+windows-icon-from-ico = "docs/assets/icon.ico"
+
+[tool.ruff]
+preview = true
+fix = true
+unsafe-fixes = false
+show-fixes = true
+
+[tool.ruff.format]
+docstring-code-format = true
+
+[tool.ruff.lint]
+extend-select = ["PLW1514"]
+ignore = [
+    "D400",
+    "ERA001",
+    "LOG015",
+]
+future-annotations = true
+
+[tool.ruff.lint.isort]
+combine-as-imports = true
+
+[tool.typos.default]
+extend-ignore-re = [
+    "(?s)<!-- typos:off -->.*?<!-- typos:on -->",
+    '\{qeury\}',
+    'base32 "[0-9a-z]{52}"',
+]
+extend-ignore-identifiers-re = [
+    "certifi",
+    "nwo",
+    "vulnerabilit",
+    "WARNIN",
+]
+
+[tool.typos.default.extend-identifiers]
+Github = "GitHub"
+IOS = "iOS"
+Javascript = "JavaScript"
+MacOS = "macOS"
+PNGs = "PNGs"
+PyPi = "PyPI"
+Typescript = "TypeScript"
+
+[tool.typos.default.extend-words]
+astroid = "astroid"
+oject = "oject"
+PNGs = "PNGs"
+sur = "sur"
+
+[tool.mypy]
+mypy_path = "docs"
+check_untyped_defs = true
+warn_redundant_casts = true
+warn_unused_ignores = true
+warn_return_any = true
+warn_unreachable = true
+pretty = true
+warn_unused_configs = true
+
+[[tool.mypy.overrides]]
+module = [
+    "py_walk.*",
+    "sphinxcontrib.mermaid",
+    "vt",
+]
+ignore_missing_imports = true
+
+[tool.pytest]
+addopts = [
+    "--durations=10",
+    "--cov",
+    "--cov-report=term",
+    "--numprocesses=auto",
+    "--import-mode=importlib",
+]
+markers = ["once: Tests that only need to run once, not across the full CI matrix."]
+testpaths = ["tests"]
+xfail_strict = true
+
+[tool.coverage.run]
+branch = true
+source = ["repomatic"]
+
+[tool.coverage.report]
+precision = 2
+
+[tool.bumpversion]
+current_version = "7.4.0"
+parse = '(?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(\.dev(?P<dev>\d+))?'
+serialize = [
+    "{major}.{minor}.{patch}.dev{dev}",
+    "{major}.{minor}.{patch}",
+]
+ignore_missing_files = true
+allow_dirty = true
+
+[tool.bumpversion.parts.dev]
+optional_value = "release"
+values = [
+    "0",
+    "release",
+]
+
+[[tool.bumpversion.files]]
+glob = "./**/__init__.py"
+ignore_missing_version = true
+
+[[tool.bumpversion.files]]
+filename = "./pyproject.toml"
+regex = true
+search = '(?m)^version = "{current_version}"'
+replace = 'version = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "./pyproject.toml"
+search = "releases/tag/v{current_version}"
+replace = "releases/tag/v{new_version}"
+
+[[tool.bumpversion.files]]
+filename = "./pyproject.toml"
+ignore_missing_version = true
+serialize = ["{major}.{minor}.{patch}"]
+search = '-version = "{current_version}"'
+replace = '-version = "{new_version}"'
+
+[[tool.bumpversion.files]]
+filename = "./changelog.md"
+search = "## [`{current_version}` (unreleased)]("
+replace = "## [`{new_version}` (unreleased)]("
+
+[[tool.bumpversion.files]]
+filename = "./citation.cff"
+regex = true
+search = "(?m)^version: {current_version}"
+replace = "version: {new_version}"
+
+[[tool.bumpversion.files]]
+filename = "./citation.cff"
+regex = true
+search = 'date-released: \d{{4}}-\d{{2}}-\d{{2}}'
+replace = "date-released: {utcnow:%Y-%m-%d}"
+
+[tool.lychee]
+exclude = [
+    "^https://github.com/.+/issues/[0-9]+#issuecomment-.*$",
+    "^https://github.com/.+/releases/.+/download/.*$",
+    "^https://doi.org/.+/zenodo.*$",
+    'bitdefender\.com',
+    'archive\.ph',
+    '^https://www\.npmjs\.com/package/.*$',
+    '^https://www\.virustotal\.com/gui/.*$',
+    '^https://star-history\.com/.*$',
+    'githubstatus\.com',
+    '^file://.*/docs/[\w.-]+\.md#',
+]
+exclude_path = ["repomatic/templates/"]
+
+[tool.repomatic]
+abandoned-versions = [
+    "4.1.0",
+    "4.6.1",
+    "4.7.0",
+    "4.8.0",
+    "5.0.0",
+    "6.0.0",
+    "6.18.0",
+]
+exclude = ["workflows"]
+pypi-package-history = [
+    "gha-utils",
+    "repokit",
+]
+
+[tool.repomatic.changelog]
+archive-location = "./docs/changelog-archive.md"
+
+[tool.repomatic.manpages]
+script = "repomatic.cli:repomatic"

repomatic-7.3.0/pyproject.toml → repomatic-7.4.0/pyproject.toml.orig

@@ -1,11 +1,18 @@
 [build-system]
 build-backend = "uv_build"
-requires = [ "uv-build>=0.9,<0.12" ]
+# uv-build is intentionally left uncapped. uv warns on build that the sdist
+# could break on a future breaking uv-build release, but repomatic is pure
+# Python with none of the packaging edge cases that warning guards against (no
+# compiled extensions, no GPU/CUDA targets). Flexibility is preferred here:
+# repomatic runs across the ecosystem, where uv versions drift between projects,
+# and a hard ceiling risks a chicken-and-egg deadlock when one project's uv
+# moves ahead of repomatic's next release.
+requires = [ "uv-build>=0.12" ]
 
 [project]
 # Docs: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
 name = "repomatic"
-version = "7.3.0"
+version = "7.4.0"
 description = "🏭 Automate repository maintenance, releases, and CI/CD workflows"
 readme = "readme.md"
 keywords = [
@@ -84,16 +91,21 @@ dependencies = [
   "backports-strenum>=1; python_version<'3.11'",
   # boltons 25.0.0 dropped Python 3.9, matching our requires-python >= 3.10.
   "boltons>=25",
-  # click-extra 8.5 ships the `python:render` `:mirror:` regions and extends
-  # `refresh-directives` to refresh them (update_mirror_blocks), with the
-  # fence-aware scanner that stops `update-docs` phase 4 from rewriting
-  # examples nested in code fences. 8.5 also carries the
-  # `make_schema_callable(warn_unknown=...)` unknown-key warning
-  # `load_repomatic_config` opts into, and the `click_extra.sphinx.
-  # myst_docstrings` extension `docs/conf.py` loads (absorbed from
-  # `repomatic.myst_docstrings`). (8.3 brought the `click:config` directive
-  # and `schema_field_infos()` that `configuration.md` and `show-config` use.)
-  "click-extra>=8.5",
+  # click-extra 8.8.0 is the floor: repomatic delegates to the utilities absorbed
+  # there — `format_size` (byte sizes in the image and cache reports), the
+  # `parse_duration`/`parse_friendly_duration`/`parse_iso8601_duration` family
+  # (uv cooldown spans in `uv.py`/`version_sync.py`), `prep_path`/`is_stdout`
+  # (CLI `--output` handling), and `config_table_to_flags` (tool flag
+  # translation). Earlier floors remain in play: `binaries_page` imports
+  # `click_extra.blocks` (`replace_region`, 8.7.1) to splice the binaries page
+  # chart region; `OperationTrail` and `resolve_jobs` (8.6.0) render the `sync-*`
+  # resolve trail; the `{matrix}` newest-first default (8.6.0) backs the committed
+  # Python-compatibility table in `docs/install.md`; the `python:render`
+  # `:mirror:` regions (8.5) drive the `update-docs` phase 4 refresh, and
+  # `click_extra.sphinx.myst_docstrings` (8.5, absorbed from
+  # `repomatic.myst_docstrings`) is loaded by `docs/conf.py`; `click:config`
+  # and `schema_field_infos()` (8.3) back `configuration.md` and `show-config`.
+  "click-extra>=8.8",
   # extra-platforms 12.0.2 reimplemented is_macos() with sys.platform, avoiding
   # the platform.platform() shell-out to ``cmd /c ver`` on Windows that broke
   # under patched subprocess in tests and triggered a CPython 3.10.x bug.
@@ -105,6 +117,11 @@ dependencies = [
   # XXX Replace py-walk with wcmatch once the latter supports gitignore files:
   # https://github.com/facelessuser/wcmatch/issues/226
   "py-walk>=0.3.1",
+  # pyelftools parses the ELF headers of compiled binaries, so verify-binary can
+  # check architectures and glibc floors natively, inside manylinux containers,
+  # without installing exiftool. 0.33 is the first release to declare
+  # requires-python (>= 3.10, matching ours); earlier ones carry no guard.
+  "pyelftools>=0.33",
   # pyproject-metadata 0.9 added PEP 639 (license expressions) and PEP 685 (extras
   # normalization); our StandardMetadata.from_pyproject() call benefits from these.
   "pyproject-metadata>=0.9",
@@ -128,7 +145,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.3.0"
+urls.Download = "https://github.com/kdeldycke/repomatic/releases/tag/v7.4.0"
 urls.Funding = "https://github.com/sponsors/kdeldycke"
 urls.Homepage = "https://github.com/kdeldycke/repomatic"
 urls.Issues = "https://github.com/kdeldycke/repomatic/issues"
@@ -191,14 +208,15 @@ typing = [
 ]
 
 [tool.uv]
-# Pin uv to the 0.11 series so every contributor and CI runner resolves
-# uv.lock with the same resolver. astral-sh/setup-uv reads this automatically
-# (its `version` input defaults to the pyproject value), and uv enforces it on
-# every local invocation. Together with sync-uv-lock discarding cosmetic-only
-# re-locks (see repomatic.uv.sync_uv_lock), this stops uv.lock from
-# ping-ponging between machines that re-spell equivalent markers differently.
-# Bump the ceiling once a new uv minor has regenerated the lock.
-required-version = ">=0.11.23,<0.12"
+# Floor uv at the minimum resolver repomatic relies on, with no upper bound.
+# astral-sh/setup-uv reads this automatically (its `version` input defaults to
+# the pyproject value) and installs the newest uv satisfying it, so CI and
+# contributors move forward without a manual ceiling bump each minor (a hard
+# upper cap breaks every machine the day the next uv minor lands, since uv
+# self-updates). uv.lock stays stable across minors because sync-uv-lock
+# discards a re-lock that only re-spells equivalent markers (see
+# repomatic.uv.sync_uv_lock).
+required-version = ">=0.12"
 # Docs group requires Python >= 3.14 for recent MyST-Parser and click-extra features.
 dependency-groups.docs = { requires-python = ">= 3.14" }
 # Cooldown period: 7-day buffer before using newly released packages.
@@ -212,7 +230,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-24T00:00:00Z", repomatic = "0 day" }
+exclude-newer-package = { click-extra = "2026-08-02T00:00:00Z", extra-platforms = "2026-07-28T00:00:00Z", repomatic = "0 day" }
 # Package is at root level, not in "./src/".
 build-backend.module-root = ""
 
@@ -225,7 +243,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.3.0"
+file-version = "7.4.0"
 include-data-dir = [
   "repomatic/data/awesome_template=repomatic/data/awesome_template",
 ]
@@ -243,7 +261,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.3.0"
+product-version = "7.4.0"
 windows-icon-from-ico = "docs/assets/icon.ico"
 
 [tool.ruff]
@@ -281,7 +299,7 @@ lint.future-annotations = true
 [tool.typos]
 default.extend-identifiers = { Github = "GitHub", IOS = "iOS", Javascript = "JavaScript", MacOS = "macOS", PNGs = "PNGs", PyPi = "PyPI", Typescript = "TypeScript" }
 # False positives.
-default.extend-words = { astroid = "astroid", oject = "oject", PNGs = "PNGs" }
+default.extend-words = { astroid = "astroid", oject = "oject", PNGs = "PNGs", sur = "sur" }
 # Skip content between <!-- typos:off --> and <!-- typos:on --> markers.
 default.extend-ignore-re = [
   "(?s)<!-- typos:off -->.*?<!-- typos:on -->",
@@ -343,11 +361,18 @@ addopts = [
   "--cov",
   "--cov-report=term",
   "--numprocesses=auto",
+  # Import test modules via importlib instead of prepending their root dir to
+  # sys.path. Avoids "import file mismatch" collection errors when an installed
+  # copy of the package coexists with the source tree, as in distro builds.
+  "--import-mode=importlib",
 ]
 # https://docs.pytest.org/en/latest/customize.html#pyproject-toml
 markers = [
   "once: Tests that only need to run once, not across the full CI matrix.",
 ]
+# Restrict collection to the test suite, so pytest never descends into the
+# package or an installed copy of it in dual-copy builds.
+testpaths = [ "tests" ]
 # Make sure tests that are expected to fail do not resurrect and start working all of a sudden.
 xfail_strict = true
 
@@ -358,7 +383,7 @@ run.source = [ "repomatic" ]
 report.precision = 2
 
 [tool.bumpversion]
-current_version = "7.3.0"
+current_version = "7.4.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 = [
@@ -475,4 +500,9 @@ abandoned-versions = [
 ]
 changelog.archive-location = "./docs/changelog-archive.md"
 exclude = [ "workflows" ]
+# Render the Click command tree as roff `.1` files and attach a
+# `repomatic-manpages.tar.gz` asset to every GitHub release. The script target
+# mirrors `click_extra_manpages` in `docs/conf.py`, so the release tarball and
+# the HTML docs site stay in lockstep.
+manpages.script = "repomatic.cli:repomatic"
 pypi-package-history = [ "gha-utils", "repokit" ]

{repomatic-7.3.0 → repomatic-7.4.0}/readme.md

@@ -86,7 +86,3 @@ Check these projects to get real-life examples of usage and inspiration:
 - ![GitHub stars](https://img.shields.io/github/stars/kdeldycke/extra-platforms?label=%E2%AD%90&style=flat-square) [Extra Platforms](https://github.com/kdeldycke/extra-platforms) - Detect platforms and group them by family.
 
 Send a PR to add your project if you use repomatic.
-
-## Development
-
-See `claude.md` for development commands, code style, testing guidelines, and design principles.

{repomatic-7.3.0 → repomatic-7.4.0}/repomatic/__init__.py

@@ -17,5 +17,5 @@
 
 from __future__ import annotations
 
-__version__ = "7.3.0"
-__git_tag_sha__ = "2b89c62f0953d8ef59d0d023085a9323f6c32f1d"
+__version__ = "7.4.0"
+__git_tag_sha__ = "730a6caca5226f9b3c80c238504310c5dad86993"

{repomatic-7.3.0 → repomatic-7.4.0}/repomatic/binaries_page.py

@@ -55,6 +55,7 @@ import json
 import logging
 from pathlib import Path
 
+from click_extra.blocks import replace_region
 from packaging.version import InvalidVersion, Version
 
 from .binary import NUITKA_BUILD_TARGETS
@@ -96,10 +97,34 @@ warning tint; from one engine in ten upward, the release deserves a
 false-positive submission round (see the `/av-false-positive` skill).
 """
 
-PAGE_END_MARKER = "<!-- binaries-end -->"
+LEGACY_PAGE_END_MARKER = "<!-- binaries-end -->"
+"""Oldest closing marker, migrated to {data}`PAGE_END_MARKER` on first touch."""
+
+LEGACY_PAGE_START_MARKERS = (
+    "<!-- binaries-start -->",
+    "<!-- binaries-chart-start -->",
+)
+"""Superseded opening markers, migrated to {data}`PAGE_START_MARKER` on first touch.
+
+Two generations precede the current bare open: the original
+`<!-- binaries-start -->`, then the `<!-- binaries-chart-start -->` of the
+short-lived `-start`/`-end` pair. Both collapse to {data}`PAGE_START_MARKER`, so
+a page written by any past version refreshes cleanly.
+"""
+
+PAGE_REGION = "binaries-chart"
+"""Region name spliced by {func}`click_extra.blocks.replace_region`.
+
+The generated chart lives between the `<!-- binaries-chart -->` and
+`<!-- binaries-chart-end -->` markers that {data}`PAGE_START_MARKER` and
+{data}`PAGE_END_MARKER` spell out, following click-extra's
+`<!-- name --> / <!-- name-end -->` marker grammar with `name` = this value.
+"""
+
+PAGE_END_MARKER = f"<!-- {PAGE_REGION}-end -->"
 """Closing marker of the generated chart region in the binaries page."""
 
-PAGE_START_MARKER = "<!-- binaries-start -->"
+PAGE_START_MARKER = f"<!-- {PAGE_REGION} -->"
 """Opening marker of the generated chart region in the binaries page."""
 
 PAGE_TEMPLATE = """\
@@ -111,15 +136,17 @@ orphan: true
 
 All standalone executables published by this repository, one row per binary, newest release first. The version links to its GitHub release, the platform to the direct binary download, and the VirusTotal cell to the file's public analysis.
 
+Each target's minimum OS requirement (glibc floor on Linux, deployment target on macOS) and the distributions it opens execution to are documented in the [repomatic binaries page](https://kdeldycke.github.io/repomatic/binaries.html#minimum-os-requirements).
+
 Compiled Python binaries are regularly flagged by heuristic antivirus engines, so every release is submitted to [VirusTotal](https://www.virustotal.com/): this seeds vendor databases with the new signatures and keeps false positives in check. The VirusTotal cell tracks those false positives: a green check marks binaries no engine flags, and flagged binaries show the share of engine verdicts flagging them, snapshotted minutes after publication and before false-positive reports get processed. The live analysis behind the link supersedes it.
 
 ## Development builds
 
 Fresh binaries are compiled from every push to the default branch by the [release workflow]({repo_url}/actions/workflows/release.yaml). To try the latest development build: open the most recent successful run and download the artifact matching your platform (a GitHub account is required, and the binary comes wrapped in a zip). The same builds are also attached to a rolling dev pre-release, a draft only visible to repository maintainers.
 
-<!-- binaries-start -->
+<!-- binaries-chart -->
 
-<!-- binaries-end -->
+<!-- binaries-chart-end -->
 
 ## Catalog
 
@@ -427,8 +454,11 @@ def update_binaries_page(page_path: Path, chart_section: str, repo_slug: str) ->
 
     A missing page is created (with parent directories) from
     {data}`PAGE_TEMPLATE`. On an existing page only the region between
-    {data}`PAGE_START_MARKER` and {data}`PAGE_END_MARKER` is replaced,
-    leaving all surrounding prose untouched.
+    {data}`PAGE_START_MARKER` and {data}`PAGE_END_MARKER` is replaced by
+    {func}`click_extra.blocks.replace_region`, leaving all surrounding prose
+    untouched. Pages carrying any {data}`LEGACY_PAGE_START_MARKERS` open or the
+    {data}`LEGACY_PAGE_END_MARKER` close are migrated to the current markers in
+    the same pass.
 
     :param page_path: Path to the Markdown page.
     :param chart_section: Rendered chart from {func}`render_chart_section`,
@@ -443,20 +473,21 @@ def update_binaries_page(page_path: Path, chart_section: str, repo_slug: str) ->
     original = None
     if page_path.exists():
         original = page_path.read_text(encoding="UTF-8")
-        if PAGE_START_MARKER not in original or PAGE_END_MARKER not in original:
+        # Migrate pages written before the marker grammar aligned on
+        # click-extra's bare `<!-- name -->` open.
+        text = original
+        for legacy_open in LEGACY_PAGE_START_MARKERS:
+            text = text.replace(legacy_open, PAGE_START_MARKER)
+        text = text.replace(LEGACY_PAGE_END_MARKER, PAGE_END_MARKER)
+        if PAGE_START_MARKER not in text or PAGE_END_MARKER not in text:
             raise ValueError(
                 f"{page_path} lacks the {PAGE_START_MARKER} / {PAGE_END_MARKER} "
                 "markers, refusing to overwrite it."
             )
-        text = original
     else:
         text = PAGE_TEMPLATE.replace("{repo_url}", f"https://github.com/{repo_slug}")
 
-    before, rest = text.split(PAGE_START_MARKER, 1)
-    _, after = rest.split(PAGE_END_MARKER, 1)
-    section = chart_section.strip()
-    between = f"\n\n{section}\n\n" if section else "\n\n"
-    new_text = before + PAGE_START_MARKER + between + PAGE_END_MARKER + after
+    new_text = replace_region(text, PAGE_REGION, chart_section.strip())
 
     if new_text == original:
         logging.info(f"Binaries page {page_path} already up to date.")