doc: fix docs

Author: FelixAbrahamsson

docs/source/conf.py

@@ -24,10 +24,13 @@
 
 # The full version, including alpha/beta/rc tags
 # release = '0.1.0'
-from pkg_resources import get_distribution, DistributionNotFound
+# NB: alias the import — a bare `version` in this module's namespace would be
+# picked up by Sphinx as the `version` config value (a function), crashing the
+# inventory dump.
+from importlib.metadata import version as _get_version, PackageNotFoundError
 try:
-    release = get_distribution('kw6').version
-except DistributionNotFound:
+    release = _get_version('kw6')
+except PackageNotFoundError:
     pass
 
 
@@ -39,7 +42,6 @@
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.autosummary',
-    'recommonmark',
     'sphinx.ext.viewcode',
     'sphinx_rtd_theme',
 ]

docs/source/requirements.txt

@@ -1,35 +1,6 @@
-alabaster==0.7.12
-Babel==2.8.0
-certifi==2020.6.20
-chardet==3.0.4
-commonmark==0.9.1
-docutils==0.16
-flake8==3.8.3
-idna==2.10
-imagesize==1.2.0
-Jinja2==2.11.2
-MarkupSafe==1.1.1
-mccabe==0.6.1
-numpy==1.19.2
-packaging==20.4
-Pillow==7.2.0
-pycodestyle==2.6.0
-pydantic==1.6.1
-pyflakes==2.2.0
-Pygments==2.7.1
-pyparsing==2.4.7
-pytz==2020.1
-recommonmark==0.6.0
-requests==2.24.0
-six==1.15.0
-snowballstemmer==2.0.0
-Sphinx==3.2.1
-sphinx-rtd-theme==0.5.0
-sphinxcontrib-applehelp==1.0.2
-sphinxcontrib-devhelp==1.0.2
-sphinxcontrib-htmlhelp==1.0.3
-sphinxcontrib-jsmath==1.0.1
-sphinxcontrib-qthelp==1.0.3
-sphinxcontrib-serializinghtml==1.1.4
-tqdm==4.54.1
-urllib3==1.25.10
+# Install the package itself so autodoc can import kw6 and its dependencies
+# (numpy, Pillow, pydantic) resolve to current wheels on the docs Python.
+.
+
+sphinx>=7,<9
+sphinx-rtd-theme>=2