Describe the bug
The distutils module has been removed from the standard library in python 3.12 in favour of the
setuptools package providing and maintaining the module. See PEP 632 - Deprecate distutils module for why it has been removed.
As a consequence, the build script for the docs now fails when using python 3.12
To Reproduce
Using python 3.12 to create a venv, install the requirements.txt and run the build script results in an error for a missing distutils module.
I personally use uv as a tool to manage python venvs and dependencies.
$ uv venv
$ uv pip install -r requirements.txt
$ source .venv/bin/activate
$ ./build.sh
Running Sphinx v8.1.3
loading translations [en]... done
making output directory... done
Extension error:
Could not import extension pydata_sphinx_theme (exception: No module named 'distutils')
make: *** [Makefile:38: html] Error 2
Expected behavior
I expect to be able to build the documentation successfully using python 3.12.
Additional context
A simple fix is adding the setuptools package with version >= 48.0.0 (when distutils was added) to the requirements.txt.
Describe the bug
The
distutilsmodule has been removed from the standard library in python 3.12 in favour of thesetuptoolspackage providing and maintaining the module. See PEP 632 - Deprecate distutils module for why it has been removed.As a consequence, the build script for the docs now fails when using python 3.12
To Reproduce
Using python 3.12 to create a venv, install the requirements.txt and run the build script results in an error for a missing
distutilsmodule.I personally use
uvas a tool to manage python venvs and dependencies.Expected behavior
I expect to be able to build the documentation successfully using python 3.12.
Additional context
A simple fix is adding the
setuptoolspackage with version >= 48.0.0 (when distutils was added) to therequirements.txt.