Upgrade sphinx dependency, adjust docs setup to account for api changes

Author: olzhasar-reef

doc/source/conf.py

@@ -210,4 +210,6 @@
 ]
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'https://docs.python.org/': None}
+intersphinx_mapping = {'python': ('https://docs.python.org/', None)}
+
+coverage_statistics_to_report = False

noxfile.py

@@ -54,11 +54,7 @@ def _detect_python_nox_id() -> str:
     print(f'CI job mode; using provided interpreter only; PYTHON_VERSIONS={PYTHON_VERSIONS!r}')
 
 PYTHON_DEFAULT_VERSION = next(
-    (
-        version
-        for version in reversed(PYTHON_VERSIONS)
-        if not version.lower().startswith('pypy')
-    ),
+    (version for version in reversed(PYTHON_VERSIONS) if not version.lower().startswith('pypy')),
     PYTHON_VERSIONS[-1],
 )
 
@@ -233,8 +229,8 @@ def doc_cover(session):
     session.run('cat', report_file, external=True)
 
     with open('build/coverage/python.txt') as fd:
-        # If there is no undocumented files, the report should have only 2 lines (header)
-        if sum(1 for _ in fd) != 2:
+        # If there is no undocumented files, the report should have only 3 lines (header)
+        if sum(1 for _ in fd) != 3:
             session.error('sphinx coverage has failed')
 
 

pyproject.toml

@@ -72,7 +72,7 @@ release = [
 ]
 doc = [
     "sadisplay>=0.4.9",
-    "sphinx>=5.3.0, <6",
+    "sphinx>=7.4.7, <8",
     "sphinx-autobuild>=2021.3.14",
     "sphinx-rtd-theme>=2.0.0",
     "sphinx-autodoc-typehints>=1.23.0",