Fix(deps): Pin setuptools<82 to retain pkg_resources module 37/143437/1
authorMatthew Watkins <mwatkins@linuxfoundation.org>
Tue, 3 Mar 2026 15:03:01 +0000 (15:03 +0000)
committerMatthew Watkins <mwatkins@linuxfoundation.org>
Tue, 3 Mar 2026 15:03:57 +0000 (15:03 +0000)
commit7e928ca01901d4f39b1ef7dacc233343527345b0
treecdfae12ca58ab13d765c3e25c2ecc68beb9bec7e
parent67ae5439e52bf07878996898722601b5abce6eab
Fix(deps): Pin setuptools<82 to retain pkg_resources module

Setuptools v82.0.0 removed the bundled pkg_resources module entirely.
This breaks RTD builds because sphinxcontrib-blockdiag (and
sphinxcontrib-seqdiag via blockdiag) import pkg_resources at the
module level, causing:

  ModuleNotFoundError: No module named 'pkg_resources'

Pin setuptools>=65.0.0,<82 in the docs requirements and example
templates to ensure pkg_resources remains available at build time.
Both sphinxcontrib-blockdiag and sphinxcontrib-seqdiag are
unmaintained (last released 2020) and cannot be patched upstream.

Long-term, these diagram extensions should be replaced with
actively maintained alternatives that use importlib.metadata.

Issue-ID: CIMAN-33
Change-Id: I3c5a81ee8ba562d7f0a06c1abc59015ca9003ba3
Signed-off-by: Matthew Watkins <mwatkins@linuxfoundation.org>
docs/requirements-docs.txt
examples/sphinx/master/requirements-docs.txt
examples/sphinx/release/requirements-docs.txt