Test against newer Sphinx versions.

Author: domdfcoding

.github/workflows/python_ci.yml

@@ -30,11 +30,11 @@ jobs:
         config:
           - {python-version: "3.7", testenvs: "py37-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3},py37-docutils{0.16,0.17,0.18},build", experimental: False}
           - {python-version: "3.8", testenvs: "py38-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1},py38-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.9", testenvs: "py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py39-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.10", testenvs: "py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py310-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.11", testenvs: "py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py311-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.12", testenvs: "py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py312-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.13", testenvs: "py313-sphinx{6.2,7.0,7.1,7.2},py313-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.9", testenvs: "py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4},py39-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.10", testenvs: "py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1},py310-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.11", testenvs: "py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py311-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.12", testenvs: "py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py312-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.13", testenvs: "py313-sphinx{6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py313-docutils{0.16,0.17,0.18},build", experimental: False}
 
     steps:
       - name: Checkout 🛎️

.github/workflows/python_ci_linux.yml

@@ -31,11 +31,11 @@ jobs:
         config:
           - {python-version: "3.7", testenvs: "py37-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3},py37-docutils{0.16,0.17,0.18},build", experimental: False}
           - {python-version: "3.8", testenvs: "py38-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1},py38-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.9", testenvs: "py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py39-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.10", testenvs: "py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py310-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.11", testenvs: "py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py311-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.12", testenvs: "py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py312-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.13", testenvs: "py313-sphinx{6.2,7.0,7.1,7.2},py313-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.9", testenvs: "py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4},py39-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.10", testenvs: "py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1},py310-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.11", testenvs: "py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py311-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.12", testenvs: "py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py312-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.13", testenvs: "py313-sphinx{6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py313-docutils{0.16,0.17,0.18},build", experimental: False}
 
     steps:
       - name: Checkout 🛎️

.github/workflows/python_ci_macos.yml

@@ -30,11 +30,11 @@ jobs:
         config:
           - {python-version: "3.7", os-ver: "13", testenvs: "py37-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3},py37-docutils{0.16,0.17,0.18},build", experimental: False}
           - {python-version: "3.8", os-ver: "14", testenvs: "py38-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1},py38-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.9", os-ver: "14", testenvs: "py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py39-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.10", os-ver: "14", testenvs: "py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py310-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.11", os-ver: "14", testenvs: "py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py311-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.12", os-ver: "14", testenvs: "py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2},py312-docutils{0.16,0.17,0.18},build", experimental: False}
-          - {python-version: "3.13", os-ver: "14", testenvs: "py313-sphinx{6.2,7.0,7.1,7.2},py313-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.9", os-ver: "14", testenvs: "py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4},py39-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.10", os-ver: "14", testenvs: "py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1},py310-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.11", os-ver: "14", testenvs: "py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py311-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.12", os-ver: "14", testenvs: "py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py312-docutils{0.16,0.17,0.18},build", experimental: False}
+          - {python-version: "3.13", os-ver: "14", testenvs: "py313-sphinx{6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2},py313-docutils{0.16,0.17,0.18},build", experimental: False}
 
     steps:
       - name: Checkout 🛎️

repo_helper.yml

@@ -25,12 +25,30 @@ python_versions:
      - 7.0
      - 7.1
      - 7.2
+     - 7.3
+     - 7.4
+     - 8.0
+     - 8.1
+     - 8.2
   3.8:
    matrix_exclude:
     sphinx:
      - 7.2
+     - 7.3
+     - 7.4
+     - 8.0
+     - 8.1
+     - 8.2
   3.9:
+   matrix_exclude:
+    sphinx:
+     - 8.0
+     - 8.1
+     - 8.2
   "3.10":
+   matrix_exclude:
+    sphinx:
+     - 8.2
   "3.11":
   "3.12":
    matrix_exclude:
@@ -87,10 +105,17 @@ third_party_version_matrix:
     - 7.0
     - 7.1
     - 7.2
+    - 7.3
+    - 7.4
+    - 8.0
+    - 8.1
+    - 8.2
   docutils:
     - 0.16
     - 0.17
     - 0.18
+    # - 0.19
+    # - 0.20
 
 classifiers:
  - 'Development Status :: 3 - Alpha'
@@ -104,5 +129,5 @@ classifiers:
 mypy_deps:
  - types-docutils
 
-tox_unmanaged:
- - testenv
+exclude_files:
+ - tox

tests/requirements.txt

@@ -1,10 +1,11 @@
 coincidence>=0.2.0
 coverage>=5.1
 coverage-pyver-pragma>=0.2.1
+defusedxml>=0.7.1
 domdf-python-tools>=3.1.0
 importlib-metadata>=3.6.0
 pytest>=6.0.0
 pytest-cov>=2.8.1
 pytest-randomly>=3.7.0
 pytest-timeout>=1.4.2
-sphinx-toolbox[testing]>=2.17.0
+sphinx-toolbox[testing]>=4.0.0

tests/test_output.py

@@ -16,7 +16,7 @@
 def doc_root(tmp_pathplus: PathPlus) -> None:
 	doc_root = tmp_pathplus.parent / "test-html-section"
 	doc_root.maybe_make()
-	(doc_root / "conf.py").write_clean("extensions = ['html_section']")
+	(doc_root / "conf.py").write_clean("extensions = ['html_section']\nproject='Python'\nauthor='unknown'")
 
 	shutil.copy2(PathPlus(__file__).parent / "index.rst", doc_root / "index.rst")
 
@@ -47,6 +47,10 @@ def test_html_output(app: Sphinx, html_regression: HTMLRegressionFixture):
 			div["src"] = div["src"].split("?v=")[0]
 			print(div["src"])
 
+	for meta in cast(List[Dict], page.find_all("meta")):
+		if meta.get("content", '') == "width=device-width, initial-scale=0.9, maximum-scale=0.9":
+			meta.extract()  # type: ignore[attr-defined]
+
 	html_regression.check(page, jinja2=True)
 
 

tests/test_output_/test_html_output.html

@@ -24,7 +24,6 @@
   </script>{% if sphinx_version >= (5, 2) %}
   <script src="_static/sphinx_highlight.js">
   </script>{% endif %}
-  <meta content="width=device-width, initial-scale=0.9, maximum-scale=0.9" name="viewport"/>
  </head>
  <body>
   <div class="document">
@@ -61,7 +60,9 @@ <h2>
        <p>
         This section’s heading shouldn’t be present at all.
        </p>
-      </{% if docutils_version >= (0, 17) %}section{% else %}div{% endif %}>
+      </{% if docutils_version >= (0, 17) %}section{% else %}div{% endif %}>{% if sphinx_version >= (8, 1) %}
+      <div class="clearer">
+      </div>{% endif %}
      </div>
     </div>
    </div>

tests/test_sphinx_version.py

@@ -0,0 +1,13 @@
+# stdlib
+import os
+import re
+
+# 3rd party
+import sphinx
+
+
+def test_sphinx_version_against_tox():
+	m = re.match(r"py.*-sphinx(\d)\.(\d)", os.getenv("TOX_ENV_NAME", ''))
+	if m is not None:
+		target_version = tuple(map(int, m.groups()))
+		assert target_version == sphinx.version_info[:2]

tox.ini

@@ -18,17 +18,16 @@
 #     * coverage:run
 #     * coverage:report
 #     * check-wheel-contents
-#     * pytest
 
 [tox]
 envlist =
     py37-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3}
     py38-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1}
-    py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py313-sphinx{6.2,7.0,7.1,7.2}
+    py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4}
+    py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1}
+    py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2}
+    py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2}
+    py313-sphinx{6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2}
     py37-docutils{0.16,0.17,0.18}
     py38-docutils{0.16,0.17,0.18}
     py39-docutils{0.16,0.17,0.18}
@@ -50,11 +49,11 @@ requires =
 test =
     py37-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3}
     py38-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1}
-    py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}
-    py313-sphinx{6.2,7.0,7.1,7.2}
+    py39-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4}
+    py310-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1}
+    py311-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2}
+    py312-sphinx{4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2}
+    py313-sphinx{6.2,7.0,7.1,7.2,7.3,7.4,8.0,8.1,8.2}
     py37-docutils{0.16,0.17,0.18}
     py38-docutils{0.16,0.17,0.18}
     py39-docutils{0.16,0.17,0.18}
@@ -245,25 +244,12 @@ filterwarnings =
     always:datetime.datetime.utcfromtimestamp\(\) is deprecated and scheduled for removal in a future version:DeprecationWarning:sphinx.builders[.*]
 markers = sphinx
 
-[testenv:py312-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}]
-download = True
-setenv =
-    PYTHONDEVMODE=1
-    PIP_DISABLE_PIP_VERSION_CHECK=1
-
 [testenv:py312-docutils{0.16,0.17,0.18}]
 download = True
 setenv =
     PYTHONDEVMODE=1
     PIP_DISABLE_PIP_VERSION_CHECK=1
 
-[testenv:py313-sphinx{3.3,3.4,3.5,4.0,4.1,4.2,4.3,4.4,4.5,5.0,5.1,5.2,5.3,6.0,6.1,6.2,7.0,7.1,7.2}]
-download = True
-setenv =
-    PYTHONDEVMODE=1
-    PIP_DISABLE_PIP_VERSION_CHECK=1
-    UNSAFE_PYO3_SKIP_VERSION_CHECK=1
-
 [testenv:py313-docutils{0.16,0.17,0.18}]
 download = True
 setenv =
@@ -279,26 +265,25 @@ setenv =
 deps =
     -r{toxinidir}/tests/requirements.txt
     -r{toxinidir}/requirements.txt
-    sphinx3.3: sphinx~=3.3.1
-    sphinx3.4: sphinx~=3.4.3
-    sphinx3.5: sphinx~=3.5.4
+    sphinx3.3: sphinx==3.3.1
+    sphinx3.4: sphinx==3.4.3
+    sphinx3.5: sphinx==3.5.4
     sphinx3.{2,3,4,5}: docutils==0.16
-    sphinx4.0: sphinx~=4.0.3
-    sphinx4.1: sphinx~=4.1.2
-    sphinx4.2: sphinx~=4.2.0
-    sphinx4.3: sphinx~=4.3.2
-    sphinx4.4: sphinx~=4.4.0
-    sphinx4.5: sphinx~=4.5.0
-    sphinx5.0: sphinx~=5.0.2
-    sphinx5.1: sphinx~=5.1.1
-    sphinx5.2: sphinx~=5.2.1
-    sphinx5.3: sphinx~=5.3.0
-    sphinx6.0: sphinx~=6.0.1
-    sphinx6.1: sphinx~=6.1.2
-    sphinx6.2: sphinx~=6.2.0
-    sphinx7.0: sphinx~=7.0.0
-    sphinx7.1: sphinx~=7.1.0
-    sphinx7.2: sphinx~=7.2.0
+    sphinx4.0: sphinx==4.0.3
+    sphinx4.1: sphinx==4.1.2
+    sphinx4.2: sphinx==4.2.0
+    sphinx4.3: sphinx==4.3.2
+    sphinx4.4: sphinx==4.4.0
+    sphinx4.5: sphinx==4.5.0
+    sphinx5.0: sphinx==5.0.2
+    sphinx5.1: sphinx==5.1.1
+    sphinx5.2: sphinx==5.2.3
+    sphinx5.3: sphinx==5.3.0
+    sphinx6.0: sphinx==6.0.1
+    sphinx6.1: sphinx==6.1.3
+    sphinx6.2: sphinx==6.2.1
+    sphinx7.0: sphinx==7.0.1
+    sphinx7.1: sphinx==7.1.2
     docutils0.16: docutils~=0.16.0
     docutils0.17: docutils~=0.17.0
     docutils0.18: docutils~=0.18.0
@@ -312,3 +297,63 @@ deps =
 commands =
     python --version
     python -m pytest --cov=html_section -r aR tests/ {posargs}
+
+[testenv:py{39,310,311,312,313,py39}-sphinx7.2]
+deps =
+    -r{toxinidir}/tests/requirements.txt
+    -r{toxinidir}/requirements.txt
+commands =
+    pip install sphinx==7.2.6
+    pip install pygments>=2.7.4,<=2.13.0
+    python --version
+    python -m pytest --cov=html_section -r aR tests/ {posargs}
+
+[testenv:py{39,310,311,312,313,py39}-sphinx7.3]
+deps =
+    -r{toxinidir}/tests/requirements.txt
+    -r{toxinidir}/requirements.txt
+commands =
+    pip install sphinx==7.3.7
+    pip install pygments>=2.7.4,<=2.13.0
+    python --version
+    python -m pytest --cov=html_section -r aR tests/ {posargs}
+
+[testenv:py{39,310,311,312,313,py39}-sphinx7.4]
+deps =
+    -r{toxinidir}/tests/requirements.txt
+    -r{toxinidir}/requirements.txt
+commands =
+    pip install sphinx==7.4.7
+    pip install pygments>=2.7.4,<=2.13.0
+    python --version
+    python -m pytest --cov=html_section -r aR tests/ {posargs}
+
+[testenv:py{310,311,312,313}-sphinx8.0]
+deps =
+    -r{toxinidir}/tests/requirements.txt
+    -r{toxinidir}/requirements.txt
+commands =
+    pip install sphinx==8.0.2
+    pip install pygments>=2.7.4,<=2.13.0 alabaster==0.7.16
+    python --version
+    python -m pytest --cov=html_section -r aR tests/ {posargs}
+
+[testenv:py{310,311,312,313}-sphinx8.1]
+deps =
+    -r{toxinidir}/tests/requirements.txt
+    -r{toxinidir}/requirements.txt
+commands =
+    pip install sphinx==8.1.3
+    pip install pygments>=2.7.4,<=2.13.0
+    python --version
+    python -m pytest --cov=html_section -r aR tests/ {posargs}
+
+[testenv:py{311,312,313}-sphinx8.2]
+deps =
+    -r{toxinidir}/tests/requirements.txt
+    -r{toxinidir}/requirements.txt
+commands =
+    pip install sphinx==8.2.1
+    pip install pygments>=2.7.4,<=2.13.0
+    python --version
+    python -m pytest --cov=html_section -r aR tests/ {posargs}