Skip to content

apidocs: build with a pinned pydoctor via uvx - #181

Merged
rr- merged 1 commit into
mainfrom
rework/50-docs-uvx
Nov 6, 2026
Merged

rr- merged 1 commit into
mainfrom
rework/50-docs-uvx

Conversation

@rr-

@rr- rr- commented Nov 6, 2026

Copy link
Copy Markdown
Owner

The docs dependency group put pydoctor, and through it Twisted, in the shared uv.lock. Because the project still supports Python 3.8, the lock kept old versions, and Dependabot raised 8 Twisted alerts against it.

The docs are now built with uvx --python 3.12 --from 'pydoctor==25.10.1', in the apidocs workflow and in just docs. The flags are unchanged. The docs group is gone from pyproject.toml, and uv.lock no longer has pydoctor or Twisted. The version is pinned in two places: PYDOCTOR_VERSION in the workflow env: and pydoctor_version in the justfile.

A local build gives the same set of files and the same two pydoctor warnings as before.

The docs dependency group put pydoctor and Twisted in the shared
uv.lock. Since the project still supports Python 3.8, the lock kept
old versions there and Dependabot kept raising Twisted alerts.

Run pydoctor 25.10.1 through uvx on Python 3.12 instead, both in the
apidocs workflow and in `just docs`, and drop the docs group.
@rr- rr- self-assigned this Nov 6, 2026
@rr-
rr- merged commit 1f43a95 into main Nov 6, 2026
26 checks passed
@rr-
rr- deleted the rework/50-docs-uvx branch November 6, 2026 23:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant