Upstream

repomatic installs, configures and runs a long list of external tools and libraries. When one of them misbehaves, the fix goes upstream where possible, and into repomatic where it cannot wait. This page tracks that relationship: code contributed back, workarounds provided, issues reported, and features declined.

A dependency that a sibling project consumes more directly is tracked on that project’s page: click-extra for Click, Cloup and python-tabulate, and meta-package-manager for Nuitka and the package managers it wraps.

Code contributed upstream

Pull requests authored by repomatic’s maintainer and merged into upstream projects.

arrow

• #246 - Fix overzealous time truncation in span_range()

awesome-lint

repomatic lints awesome lists with it:

• #127 - Fix matching of opening curly quote in description

• #123 - Forbid License, Licence and Contribute sections

• #118 - Allow for a Footnotes section at the end of an Awesome list

• #111 - Fix location matching of contributing.md and code-of-conduct.md files

• #102 - Allow .github directory to contain contribution guidelines

• #101 - Check and enforce quotes with punctuations

gitignore.io

• #17 - Ignore rope files

lychee-action

• #253 - Fix variable name

• #197 - Add *.rst glob pattern to defaults

mdformat-deflist

• #5 - Allow mdit-py-plugins v0.4

mdformat-gfm

• #28 - Removes cap on mdit-py-plugins dependency

mdformat-myst

• #28 - Remove cap on mdit-py-plugins version

mdformat-pelican

• #11 - Fix link renderer conflict with mdformat-gfm 1.0.0 and other plugins

• #6 - Fix module import

mdformat-pyproject

• #22 - Modernize typing

• #21 - Fix typos and update docs

• #20 - Makes .mdformat.toml take precedence

• #19 - Fix mdformat 1.0.0 compatibility

mdformat-recover-urls

• #2 - Fix compatibility with mdformat-doc

mdformat-simple-breaks

• #6 - Add missing description

• #5 - Defer typing imports

• #4 - Fix compatibility with mdformat 1.0.0

pipdeptree

pipdeptree drew repomatic’s dependency graph until uv export --format cyclonedx1.5 replaced it:

• #201 - Unique IDs in Mermaid not conflicting with reserved keywords

• #200 - Quote Mermaid node and edge labels

• #196 - Fix mermaid option

• #195 - Implements Mermaid output

• #189 - Make the output of the dot format deterministic and stable

• #65 - Pre-filter Dependency Tree before Rendering

sphinx

• #13163 - Always print tracebacks in logs when Sphinx encounters an internal error

sphinx-autodoc-typehints

• #687 - Show version in error tracebacks

sphinxcontrib-mermaid

• #118 - Do not fail on empty class diagram generation

Upstreamed from repomatic

Issues found while building repomatic and resolved upstream. Where repomatic carried a workaround in the meantime, the entry says what it was and when it went away.

• bump-my-version#331 - 1.1.1 broke the replace command on [[tool.bumpversion.files]] entries that do not apply. repomatic held bump-my-version at 1.1.0 until a later release fixed it.

• lychee#1930 - lychee read its configuration only from its own file, so repomatic translated [tool.lychee] into that file. Since 0.24.0 (lychee#2104), lychee reads the section from pyproject.toml itself, and repomatic no longer translates it.

• mdformat-myst#45 / mdformat-myst#46 - mdformat-myst depended on mdformat-frontmatter, which made it incompatible with mdformat 1.0.0. #46 replaced that dependency with mdformat-front-matters. repomatic ran mdformat-myst from its master branch, then from a fork, until a release carried the change.

• mdformat-pelican#3 / mdformat-pelican#4 - mdformat-pelican and mdformat-gfm could not run together, also reported as mdformat-gfm#38. repomatic depended on a personal fork that carried the fix, then on unreleased upstream, then on the release that shipped it.

• mdformat-web#5 - The HTML formatter added an extra doctype to html code blocks. repomatic ran a patched mdformat-web from June 2023 until 0.2.0 shipped the fix.

• tomlrt#171 - Table.section() dropped standalone comments and inline-array padding from the source document. repomatic rebuilt each section with a helper to keep them, and removed the helper once tomlrt 2.2.4 fixed the clone path.

• zizmor#1664 - The template-injection audit failed on a multiline YAML block. repomatic turned the audit off until zizmor 1.23.0 fixed it, then turned it back on.

Also reported while building repomatic, and closed upstream:

• setup-python#807 - Feature request: Do not fail when caching on non-Python repositories

• ruff#9186 - docstring code formatter: add a --docstring-code-format parameter to ruff format CLI

• ruff#2857 - Add --target-version pyXX option to CLI

• uv#8774 - Equivalent command to check-wheel-contents

• uv#8770 - CLI reported by uv run on Windows is not found on invocation

• uv#5185 - Feature request: option to not update uv.lock file

• uv#4762 - uv pip install --all-extras . fail to locate pyproject.toml

• uv#1481 - uv pip install cannot fetch requirement file from remote URL

• bump-my-version#410 - Unlock dependency on click 8.4.1

• bump-my-version#300 - Nuitka-compilation fails with: PydanticUndefinedAnnotation: name 'SCMInfo' is not defined

• bump-my-version#148 - Read configuration from remote URL

• bump-my-version#145 - Add support for ignore_missing_files global option in configuration file

• bump-my-version#117 - Empty string replacement (--replace "") is interpreted as absence of parameter

• bump-my-version#38 - Ignore missing files

• bump-my-version#35 - Date-based search and replace

• bump-my-version#34 - Traceback on --search parameter with plain string

• bump-my-version#25 - --no-configured-files should not update current_version

• bump-my-version#19 - Decouple search & replace from version bump

• bump-my-version#15 - Get current version

• labelmaker#126 - No global on-rename-clash parameter

• labelmaker#125 - Multiple file support in labelmaker apply

• mdformat-admon#15 - Latest mdformat-admon and mdformat-gfm conflicts

• mdformat-deflist#7 - Uncap mdformat < 0.8.0 requirement

• mdformat-deflist#4 - Latest mdformat-deflist and mdformat-admon conflicts

• mdformat-gfm#27 - Latest mdformat-gfm and mdformat-admon conflicts

• mdformat-myst#43 - Replace dependency of mdformat-tables to mdformat-gfm

• mdformat-pyproject#18 - Uncap mdformat < 1.dev0 requirement

• mdformat-simple-breaks#3 - Uncap mdformat < 0.8.0 requirement

• mdformat-toc#19 - mdformat-toc forces URL-encoding of non-ASCII characters

• Nuitka#3449 - Why does nuitka reports x86_64 architecture on windows-11-arm runner?

• pipdeptree#188 - Graph stability: random order in Graphiz content

• tomlrt#172 - Reassigning a section relocates its AoT children to the end of the document

Addressed by repomatic

Issues still open or unfixed upstream. repomatic provides the solution.

GitHub Actions

The reusable workflows work around a set of GitHub Actions limitations. The GitHub Actions limitations table lists each one, its status and the mechanism that addresses it.

PyPI

• warehouse#11096 - Trusted publishing: Support for GitHub reusable workflows: the publish-pypi job stays in each repository’s own release.yaml, so the OIDC claim names the file that the repository registered as its Trusted Publisher.

• warehouse#1388 - 404 for registered package with no release and warehouse#9536 - Unable to get a consistent view of existing/changed packages from the various APIs: PyPI’s JSON API answers 404 for some registered projects. repomatic does not read that 404 as proof that a package is missing.

Tool configuration in pyproject.toml

repomatic run translates a [tool.X] section into the native configuration file of a tool that cannot read pyproject.toml:

• actionlint#623 - Support configuration in [tool.actionlint] section of pyproject.toml

• biome#9239 (discussion)

• gitleaks#2066 - Support configuration from pyproject.toml

• zizmor#322 (discussion comment)

• mdformat#432 - Option to specify path to configuration file and mdformat#562 - Add --config option to specify explicit configuration file path: mdformat finds its configuration only by discovery, so repomatic writes a temporary .mdformat.toml for the run and deletes it after.

Markdown formatting

repomatic post-processes the output of mdformat to undo two mdformat-myst rewrites, and changes one mdformat default:

• mdformat-myst#21 - myst formatting directive with only 1 parameter: mdformat-myst turns :key: value directive options into a YAML block. repomatic restores the field list. The open fix is mdformat-myst#49.

• mdformat-myst#13 - colon fence syntax is broken by escape character: mdformat-myst escapes :::{name} colon fences. repomatic removes the escape. The open fixes are mdformat-myst#36 and mdformat-myst#48.

• mdformat#312 - Needless URL encoding of link destinations: repomatic turns off URL validation and bundles mdformat-recover-urls, which decodes percent-encoded non-ASCII characters back.

Awesome lists

• mdformat-toc#17 - Feature request: ignore specific Headings / mdformat-toc#20: mdformat-toc cannot leave a heading out of the table of contents, and awesome-lint forbids some entries there. The fix-awesome-toc command deletes them.

Python formatting

• ruff#7414 - Formatter: wrap comments (E501): Ruff does not wrap long comments. The format-python job also runs autopep8, limited to that one fix.

Shell formatting

• sh#1203 - zsh: support inline loop syntax: shfmt cannot parse some Zsh constructs, so repomatic keeps Zsh files away from it.

Workflow linting

• actionlint#711 - Support the new $/ self-repository uses: syntax / actionlint#732: actionlint rejects the $/ self-repository syntax of GitHub. repomatic’s workflows call their own reusable workflows through workspace-relative ./ paths instead.

Test matrix

• uv#12906 - uv installs x86_64 Python on arm64 Windows: tests.yaml forces a native ARM64 interpreter on the Windows ARM64 runner, which would otherwise test an emulated x86_64 Python.

Nuitka binary builds

Nuitka integration details the workaround for each of these:

• Nuitka#3879 - --main-entry-point doesn’t populate the _main_module and _main_paths internal state and Nuitka#4024 - --main-entry-point whose CLI name matches its package builds a binary that fails at startup: repomatic compiles a __main__.py entry point as its package directory, with --python-flag=-m.

• Nuitka#3909 - With --project the [tool.nuitka] section of pyproject.toml is ignored and Nuitka#4025 - --project refuses to build over a py.typed and over a dependency’s package data: Nuitka 4.2 reads [tool.nuitka] only under --project, a mode repomatic cannot use, so the tool runner turns the section into command-line flags. Nuitka#2136 asked for the same support earlier.

• Nuitka#3994 - --include-data-dir package dangling symlinks: silent on Linux, FileNotFoundError in macOS signing: the tool runner stages a copy of the data directory with no symlinks before it calls Nuitka.

• Nuitka#3996 - ccache never hits across CI machines: the release workflow writes base_dir into ccache.conf.

• Nuitka#3997 - Tool downloads are fetched and executed without integrity verification: the macOS builds turn ccache off, which keeps its unverified download out of the build.

Dependency cooldowns

• uv#20995 - Allow sharing exclude-newer-package across workspaces: file reference, env var, or repo-level config: uv has no configuration or environment knob for --exclude-newer-package, so repomatic adds the exemption to every frozen command line. Glob exemptions (uv#20788) or pin-based bypasses (uv#19864, uv#18921) would also remove the need.

• uv#18792 - Prune stale exclude-newer-package entries on uv lock: repomatic removes the stale entries itself after it relocks.

Dependency graph

• mermaid#4182 - click cannot be used for node IDs: a Mermaid keyword breaks a graph when used as a node ID. repomatic keeps keywords out of the node IDs of its dependency graph, as pipdeptree#201 does upstream.

Dependency choices

Two dependencies stand in for a feature that a preferred library lacks:

• whenever#277 (discussion): whenever has no humanizer, so repomatic uses arrow for its human-readable times.

• wcmatch#226 - Possibly add a gitignore parser: wcmatch cannot read .gitignore files, so repomatic also depends on py-walk.

Issue reporting

• create-issue-from-file#298 - Avoid creating duplicate issues: the action opens a new issue on every run. repomatic manages the issues its jobs open, so a new run does not duplicate them.

Documentation

• furo#921 (discussion): Furo shows no icons in toctree entries. repomatic’s documentation adds them with CSS.

Declined by upstream

Pull requests and features that upstream maintainers rejected.

• mypy#13294 - Auto-detect minimal Python for --python-version option: repomatic derives --python-version from requires-python when it runs mypy.

• pyupgrade#688 - Auto-detect minimal Python version: repomatic computed the minimal Python version from requires-python while it still ran pyupgrade.

• sh#1268 - Support configuration in [tool.shfmt] section of pyproject.toml: shfmt reads its style from .editorconfig only, so repomatic has no [tool.shfmt] section.

Open upstream

Pull requests and issues still pending upstream.

• awesome-lint#229 - Fix false positives in balanced-punctuation

• bump-my-version#146 - Non-matching glob patterns don’t raise FileNotFoundError

• lychee#2249 - Recognize {#id} heading anchors in --include-fragments: closed by lychee#2250, which no stable release carries yet.

• lychee#1772 - Suggest alternative frontend services from LibRedirect

• mdformat-myst#25 - Block attributes formatting introduce extra empty line

• mdformat-web#8 - format_xml drops comments and the XML declaration: since 0.2.0, formatting an xml code block deletes its comments and its <?xml ...?> declaration. repomatic pins mdformat-web 0.2.0, so the format-markdown job applies that loss to every xml block it formats.

  Todo

  When sync-tool-versions moves the mdformat-web pin past 0.2.0, run the reproducer from hukkin/mdformat-web#8 through repomatic run mdformat. Then update this entry to match the result.

• Nuitka#3998 - enableCcache overwrites a user-set CCACHE_SLOPPINESS, unlike CCACHE_DIR which is honored

• MyST-Parser#1151 - Cross-reference to an explicit target emits a false-positive myst.xref_missing warning

• ruff#19421 - Failure to create cache key on invalid symlink

• sphinx#14623 - todolist produce duplicate titles for admonitions

• sphinx-design#304 - Implements vertical tabs

• typos#998 - False positive: hda → had