workflow fixes

.github/workflows/tests.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        python-version: [3.8, 3.9]
+        python-version: [3.8, 3.9, 3.11]
         os: [ubuntu-latest, macos-latest]
 
     steps:

Makefile

@@ -64,10 +64,10 @@ coverage: ## check code coverage quickly with the default Python
 	coverage html
 	$(BROWSER) htmlcov/index.html
 
-# .PHONY: docs
-# docs: clean-docs ## generate Sphinx HTML documentation, including API docs
-# 	sphinx-apidoc --separate --no-toc -o docs/api/ endata
-# 	$(MAKE) -C docs html
+.PHONY: docs
+docs: clean-docs ## generate Sphinx HTML documentation, including API docs
+	sphinx-apidoc --separate --no-toc -o docs/api/ endata
+	$(MAKE) -C docs html
 
 .PHONY: view-docs
 view-docs: docs ## view docs in browser

setup.py

@@ -51,15 +51,15 @@
     "pip>=9.0.1",
     "watchdog>=0.8.3",
     # docs
-    # "m2r2>=0.2.0",
-    # "Sphinx>=4.0.2,<6.0.0",
-    # "sphinx_rtd_theme>=0.2.4,<0.5",
-    # "autodocsumm>=0.1.10",
+    "m2r2>=0.2.0",
+    "Sphinx>=4.0.2,<6.0.0",
+    "sphinx_rtd_theme>=0.2.4,<0.5",
+    "autodocsumm>=0.1.10",
     # style check
     "flake8>=3.7.7",
-    # "isort>=4.3.4",
+    "isort>=4.3.4",
     # fix style issues
-    # "autoflake>=1.2",
+    "autoflake>=1.2",
     "autopep8>=1.4.3",
     # distribute on PyPI
     "twine>=1.10.0",
@@ -84,6 +84,12 @@
     extras_require={
         "test": tests_require,
         "dev": development_requires + tests_require,
+        "docs": [
+            "m2r2>=0.2.0",
+            "Sphinx>=4.0.2,<6.0.0",
+            "sphinx_rtd_theme>=0.2.4,<0.5",
+            "autodocsumm>=0.1.10",
+        ],
     },
     install_package_data=True,
     install_requires=install_requires,

tox.ini

@@ -24,7 +24,7 @@ allowlist_externals = /usr/bin/env
 
 [testenv:docs]
 skipsdist = true
-extras = dev
+extras = docs
 commands =
     /usr/bin/env make docs
 allowlist_externals = /usr/bin/env