build: build docs using sphinx directly

instead of setuptools build_sphinx, which has been removed https://opendev.org/openstack/pbr/compare/5.11.1...6.0.0
openedx · Oct 3, 2024 · 31d87fe · 31d87fe
1 parent dcb7373
commit 31d87fe
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 7 deletions.
diff --git a/Makefile b/Makefile
@@ -28,8 +28,8 @@ clean: ## Remove generated byte code, coverage reports, and build artifacts
 	rm -fr dist/
 	rm -fr *.egg-info
 
-docs: ## generate Sphinx HTML documentation
-	python setup.py build_sphinx
+docs-html: ## generate Sphinx HTML documentation
+	make -C docs html
 
 dev_requirements: ## Install Dev Requirements
 	pip install -qr requirements/pip.txt

diff --git a/tox.ini b/tox.ini
@@ -23,14 +23,15 @@ commands =
     make test_quality
 
 [testenv:docs]
+allowlist_externals =
+    make
 deps =
-    setuptools
-    -r{toxinidir}/requirements/dev.txt
-commands = 
-    python setup.py build_sphinx
+    -r{toxinidir}/requirements/docs.txt
+commands =
+    make docs-html
 
 [testenv:check_keywords]
-whitelist_externals =
+allowlist_externals =
     make
 deps =
     -r{toxinidir}/requirements/dev.txt