Skip older Sphinx versions on Python 3.12 due to breaking with newer setuptools.

Author: domdfcoding

.github/workflows/python_ci.yml

@@ -33,7 +33,7 @@ jobs:
           - {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{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-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}
 
     steps:

.github/workflows/python_ci_linux.yml

@@ -34,7 +34,7 @@ jobs:
           - {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{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-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}
 
     steps:

repo_helper.yml

@@ -33,6 +33,15 @@ python_versions:
   "3.10":
   "3.11":
   "3.12":
+   matrix_exclude:
+    sphinx:
+     - 3.3
+     - 3.4
+     - 3.5
+     - 4.0
+     - 4.1
+     - 4.2
+     - 4.3
   3.13:
    matrix_exclude:
     sphinx:

tox.ini

@@ -27,7 +27,7 @@ envlist =
     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{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}
     py37-docutils{0.16,0.17,0.18}
     py38-docutils{0.16,0.17,0.18}
@@ -53,7 +53,7 @@ test =
     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{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}
     py37-docutils{0.16,0.17,0.18}
     py38-docutils{0.16,0.17,0.18}