Merge pull request #2112 from EliahKagan/py314

Upgrade Sphinx for 3.14 support; drop doc build support on 3.8; test 3.14

Author: EliahKagan

.github/workflows/pythonpackage.yml

@@ -13,21 +13,32 @@ jobs:
     strategy:
       matrix:
         os-type: [ubuntu, macos, windows]
-        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.13t"]
+        python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.13t", "3.14", "3.14t"]
         exclude:
         - os-type: macos
           python-version: "3.7"  # Not available for the ARM-based macOS runners.
         - os-type: macos
           python-version: "3.13t"
+        - os-type: macos
+          python-version: "3.14t"
         - os-type: windows
-          python-version: "3.13"  # FIXME: Fix and enable Python 3.13 on Windows (#1955).
+          python-version: "3.13"  # FIXME: Fix and enable Python 3.13 and 3.14 on Windows (#1955).
         - os-type: windows
           python-version: "3.13t"
+        - os-type: windows
+          python-version: "3.14"
+        - os-type: windows
+          python-version: "3.14t"
         include:
         - os-ver: latest
         - os-type: ubuntu
           python-version: "3.7"
           os-ver: "22.04"
+        - build-docs: true  # We ensure documentation builds, except on very old interpreters.
+        - python-version: "3.7"
+          build-docs: false
+        - python-version: "3.8"
+          build-docs: false
         - experimental: false
 
       fail-fast: false
@@ -108,7 +119,7 @@ jobs:
       continue-on-error: false
 
     - name: Documentation
-      if: matrix.python-version != '3.7'
+      if: matrix.build-docs
       run: |
         pip install '.[doc]'
         make -C doc html

doc/requirements.txt

@@ -1,3 +1,3 @@
-sphinx >= 7.1.2, < 7.2
+sphinx >= 7.4.7, < 8
 sphinx_rtd_theme
 sphinx-autodoc-typehints