diff --git a/source/isaaclab/changelog.d/vidurv-fix-docs-build-extra.rst b/source/isaaclab/changelog.d/vidurv-fix-docs-build-extra.rst new file mode 100644 index 000000000000..b85d7acc07ac --- /dev/null +++ b/source/isaaclab/changelog.d/vidurv-fix-docs-build-extra.rst @@ -0,0 +1,6 @@ +Fixed +^^^^^ + +* Fixed the ``isaaclab -d`` / ``./isaaclab.sh -d`` documentation build failing with + ``No module named sphinx``. The command resolved its environment from the ``test`` extra, + which does not provide the Sphinx toolchain; it now uses the ``dev`` extra that declares it. diff --git a/source/isaaclab/isaaclab/cli/commands/misc.py b/source/isaaclab/isaaclab/cli/commands/misc.py index d456ee20ca50..21d727cc993d 100644 --- a/source/isaaclab/isaaclab/cli/commands/misc.py +++ b/source/isaaclab/isaaclab/cli/commands/misc.py @@ -100,7 +100,7 @@ def command_build_docs() -> None: "run", "--isolated", "--extra", - "test", + "dev", "--", "python", "-m", diff --git a/source/isaaclab/test/cli/test_misc_commands.py b/source/isaaclab/test/cli/test_misc_commands.py index c193918b847c..06d5c8a359b0 100644 --- a/source/isaaclab/test/cli/test_misc_commands.py +++ b/source/isaaclab/test/cli/test_misc_commands.py @@ -24,8 +24,8 @@ def test_new_runs_template_generator_directly(): run_python_command.assert_called_once_with(cli_script, ["--help"]) -def test_build_docs_runs_sphinx_with_the_uv_test_extra(): - """The docs command must build through UV instead of an unpinned pip install.""" +def test_build_docs_runs_sphinx_with_the_uv_dev_extra(): + """The docs command must use the UV extra that provides Sphinx.""" docs_dir = misc.ISAACLAB_ROOT / "docs" output_dir = docs_dir / "_build" / "current" @@ -41,7 +41,7 @@ def test_build_docs_runs_sphinx_with_the_uv_test_extra(): "run", "--isolated", "--extra", - "test", + "dev", "--", "python", "-m",