Fix(deps): Pin setuptools<82 to retain pkg_resources 07/143507/1 master
authorMatthew Watkins <mwatkins@linuxfoundation.org>
Thu, 5 Mar 2026 11:31:47 +0000 (11:31 +0000)
committerMatthew Watkins <mwatkins@linuxfoundation.org>
Thu, 5 Mar 2026 11:31:47 +0000 (11:31 +0000)
commit8f4e008ab156a59eeed994ef27bf653b8c45925a
tree3c0cf44ad9faa57f4cfe993074c3261a0877878a
parent25d64a9283cd8975c273c55287dee46e9c8ad42a
Fix(deps): Pin setuptools<82 to retain pkg_resources

Setuptools v82.0.0 removed the bundled pkg_resources module.
This breaks RTD builds because sphinxcontrib-redoc imports
pkg_resources at the module level, causing:

  ModuleNotFoundError: No module named 'pkg_resources'

Pin setuptools>=65.0.0,<82 in docs requirements and tox.ini
to ensure pkg_resources remains available at build time.

The sphinxcontrib-redoc extension is unmaintained (last released
2020) but is actively used to generate OpenAPI/ReDoc pages for
all Policy component APIs. Replacing it requires a separate
migration effort.

Issue-ID: CIMAN-33
Co-Authored-By: Claude <noreply@anthropic.com>
Change-Id: I95c147913567caaf8f5070b61465c9db7cae64b5
Signed-off-by: Matthew Watkins <mwatkins@linuxfoundation.org>
docs/requirements-docs.txt
docs/tox.ini