Skip to content

Fix docs build: pin setuptools<81 so pkg_resources remains available#260

Merged
chrisyamas merged 1 commit into
mainfrom
fix-docs-build-pin-setuptools-below-81
May 11, 2026
Merged

Fix docs build: pin setuptools<81 so pkg_resources remains available#260
chrisyamas merged 1 commit into
mainfrom
fix-docs-build-pin-setuptools-below-81

Conversation

@chrisyamas

Copy link
Copy Markdown
Contributor

Pull Request

Follow-up to #258. Adding setuptools to docs/requirements.txt was not enough to unblock the docs build on Python 3.14: pip resolved setuptools to version 82.0.1, which no longer bundles the pkg_resources module. Since mike<2.0 (still pinned in this repo) imports pkg_resources on startup, the build continues to fail with ModuleNotFoundError: No module named 'pkg_resources'.

Pinning setuptools<81 keeps the install on a setuptools release line that still ships pkg_resources, which is the smallest change that unblocks the existing mike<2.0 pin. A larger follow-up could upgrade mike to a 2.x release that no longer depends on pkg_resources, but that is out of scope here.

This is not a spec change, so the spec-change checklist does not apply.

By contributing to this project, all contributors certify to the Developer Certificate of Origin in CONTRIBUTING.md.

@chrisyamas chrisyamas requested a review from a team as a code owner May 11, 2026 12:16
@github-actions

Copy link
Copy Markdown
Contributor

@chrisyamas chrisyamas requested a review from jlstpaul May 11, 2026 12:23
@chrisyamas chrisyamas merged commit 23e5975 into main May 11, 2026
5 checks passed
@chrisyamas chrisyamas deleted the fix-docs-build-pin-setuptools-below-81 branch May 11, 2026 14:36
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.

2 participants