From: Matthew Watkins Date: Thu, 5 Mar 2026 11:31:47 +0000 (+0000) Subject: Fix(deps): Pin setuptools<82 to retain pkg_resources X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=8f4e008ab156a59eeed994ef27bf653b8c45925a;p=policy%2Fparent.git 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 Change-Id: I95c147913567caaf8f5070b61465c9db7cae64b5 Signed-off-by: Matthew Watkins --- diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt index 9726e54e..5c02f34c 100644 --- a/docs/requirements-docs.txt +++ b/docs/requirements-docs.txt @@ -1,3 +1,4 @@ +setuptools>=65.0.0,<82 sphinx>=7.1.2 sphinx-rtd-theme>=2.0.0 sphinxcontrib-mermaid>=1.0.0 diff --git a/docs/tox.ini b/docs/tox.ini index c3c2aca0..57d67414 100644 --- a/docs/tox.ini +++ b/docs/tox.ini @@ -6,7 +6,7 @@ skipsdist = true [testenv:docs] basepython = python3.13 deps = - setuptools>=65.0.0 + setuptools>=65.0.0,<82 -r{toxinidir}/requirements-docs.txt -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master commands = @@ -19,7 +19,7 @@ allowlist_externals = [testenv:docs-linkcheck] basepython = python3.13 deps = - setuptools>=65.0.0 + setuptools>=65.0.0,<82 -r{toxinidir}/requirements-docs.txt -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master commands = @@ -28,7 +28,7 @@ commands = [testenv:docs-spellcheck] basepython = python3.13 deps = - setuptools>=65.0.0 + setuptools>=65.0.0,<82 -r{toxinidir}/requirements-docs.txt -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master commands =