#9941 PRCI fails on AzurePipeline.freeipa (Docs) due to module absense
Closed: fixed by rjeffman. Opened by kororland.

Hi Team!

In my PR https://github.com/freeipa/freeipa/pull/8165 I'm getting AzurePipeline.freeipa Docs is failing after 2 minutes with module error:

Successfully built sphinxcontrib-plantuml
Installing collected packages: mistune, ifaddr, urllib3, typing-extensions, sphinxcontrib-serializinghtml, sphinxcontrib-qthelp, sphinxcontrib-jsmath, sphinxcontrib-htmlhelp, sphinxcontrib-devhelp, sphinxcontrib-applehelp, soupsieve, snowballstemmer, six, qrcode, Pygments, pycparser, pyasn1, pillow, packaging, netaddr, MarkupSafe, lxml, imagesize, idna, docutils, dnspython, charset_normalizer, certifi, babel, alabaster, wheel, requests, pyasn1-modules, m2r2, Jinja2, cffi, beautifulsoup4, accessible-pygments, sphinx, cryptography, sphinxcontrib-plantuml, pydata-sphinx-theme, jwcrypto, sphinx-book-theme
Successfully installed Jinja2-3.1.6 MarkupSafe-3.0.3 Pygments-2.19.2 accessible-pygments-0.0.5 alabaster-0.7.16 babel-2.18.0 beautifulsoup4-4.14.3 certifi-2026.1.4 cffi-2.0.0 charset_normalizer-3.4.4 cryptography-46.0.4 dnspython-2.8.0 docutils-0.18.1 idna-3.11 ifaddr-0.2.0 imagesize-1.4.1 jwcrypto-1.5.6 lxml-6.0.2 m2r2-0.3.2 mistune-0.8.4 netaddr-1.3.0 packaging-26.0 pillow-12.1.0 pyasn1-0.6.2 pyasn1-modules-0.4.2 pycparser-3.0 pydata-sphinx-theme-0.15.4 qrcode-8.2 requests-2.32.5 six-1.17.0 snowballstemmer-3.0.1 soupsieve-2.8.3 sphinx-7.3.7 sphinx-book-theme-1.1.4 sphinxcontrib-applehelp-2.0.0 sphinxcontrib-devhelp-2.0.0 sphinxcontrib-htmlhelp-2.1.0 sphinxcontrib-jsmath-1.0.1 sphinxcontrib-plantuml-0.31 sphinxcontrib-qthelp-2.0.0 sphinxcontrib-serializinghtml-2.0.0 typing-extensions-4.15.0 urllib3-2.6.3 wheel-0.46.3
make: Leaving directory '/__w/1/s/doc'
Build documentation
make: Entering directory '/__w/1/s/doc'
Running Sphinx v7.3.7
Extension error:
Could not import extension m2r2 (exception: No module named 'pkg_resources')
make: *** [Makefile:24: html] Error 2
make: Leaving directory '/__w/1/s/doc'
##[error]Bash exited with code '2'.
Finishing: Build documentation

Metadata Update from @frenaud:
- Issue assigned to frenaud

The issue is in m2r2, already reported here and fixed with this commit.

The patch is available in m2r2 version 0.3.4

Metadata Update from @frenaud:
- Custom field on_review adjusted to https://github.com/freeipa/freeipa/pull/8170

master:

  • a5e04cf6cc0c0bdcc0ac9f27f54b451fd1db5b5e Doc: remove the constraint on docutils version

ipa-4-13:

  • bad124add6fb0fe3f8708291aedea43d318cf75b Doc: remove the constraint on docutils version

ipa-4-12:

  • 574d9a7a2f70ae597967c544375f6c2d712c7bfc Doc: remove the constraint on docutils version

Metadata Update from @rjeffman:
- Issue close_status updated to: fixed
- Issue status updated to: Closed (was: Open)

ipa-4-11:

  • e3ae2410cb158562bccceba37c6d4c57ec9348db Read The Docs: use ubuntu-24.04 instead of ubuntu-20.04
  • 77205c1d41dca971748702b8c2827b916aba9ae8 Doc: remove the constraint on docutils version
  • efe1776b5dc937c46ae6d3e3e71ded30e32cc435 Sphinx doc: skip pkg_resources import

ipa-4-10:

  • 40ed750a42f0f18dca3ab5a435102e2b451f48d4 Read The Docs: use ubuntu-24.04 instead of ubuntu-20.04
  • 383ef05ac39258d14567233895c7500850f08b22 Doc: remove the constraint on docutils version
  • 2a14d0a839560c2773f745622072ab93733420d2 Sphinx doc: skip pkg_resources import

ipa-4-9:

  • d1b9242a4b7b6f2cd7b8a1115008b80573125384 Read The Docs: use ubuntu-24.04 instead of ubuntu-20.04
  • 5d9f92eedbb8891666e2c25842cf1bdedb495280 Doc: remove the constraint on docutils version
  • 0a55ad8a07766fef2a95635d39aa00ab3f06bfdf Sphinx doc: skip pkg_resources import
  • 2971c6a4ff96bd73567f3d7a63b72c54407d7869 ipasphinx: Correct import of progress_message for Sphinx 6.1.0+
Metadata