Add 3.14 to list of supported Python versions.

We now use a central definition of supported versions in scripts/test.py. This
is used when building with cibuildwheel, and also in docs.

Author: julian-smith-artifex-com

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -82,6 +82,7 @@ body:
       # Need quotes around `3.10` otherwise it is treated as a number and shows as `3.1`.
       options:
         -
+        - "3.14"
         - "3.13"
         - "3.12"
         - "3.11"

changes.txt

@@ -16,7 +16,7 @@ Change Log
 
 * Other:
 
-    
+  * Supported Python versions are now 3.9-3.14.
   * We now define all class methods explicitly instead of with dynamic assignment; this improves type hints.
   * Removed `pymupdf.utils.Shape` class, was duplicate of `pymupdf.Shape`.
   * Allow use of cibuildwheel to build and test on Pyodide.

docs/conf.py

@@ -39,6 +39,8 @@
 # The master toctree document.
 root_doc = "index"
 
+rst_epilog = ''
+
 # General information about the project.
 project = "PyMuPDF"
 thisday = datetime.date.today()
@@ -59,6 +61,19 @@
 version = setup.version_p
 del setup   # Necessary otherwise sphinx seems to do `setup()`.
 
+# Supported Python versions are set in scripts.test.py.
+sys.path.insert(0, os.path.abspath(f'{__file__}/../../scripts'))
+try:
+    import test
+finally:
+    del sys.path[0]
+python_versions_minor = test.python_versions_minor
+del test
+python_versions_list = [f'3.{i}' for i in python_versions_minor]
+python_versions = ', '.join(python_versions_list[:-1]) + f' and {python_versions_list[-1]}'
+# Make `|python_versions|` available in .rst files.
+rst_epilog += f'.. |python_versions| replace:: {python_versions}\n'
+
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 # language = None

docs/installation.rst

@@ -146,9 +146,8 @@ Notes
     versions, including new Python releases.
 
   *
-    Wheels are tested on all Python versions currently marked as "Supported" on
-    https://devguide.python.org/versions/, currently 3.9, 3.10, 3.11, 3.12 and
-    3.13.
+    Wheels are tested on all Python versions currently marked as "Supported"
+    on https://devguide.python.org/versions/, currently |python_versions|.
 
 *
   Wheels are not available for Python installed with `Chocolatey

scripts/test.py

@@ -384,6 +384,19 @@
 run = pipcl.run
 
 
+# We build and test Python 3.x for x in this range.
+python_versions_minor = range(9, 14+1)
+
+def cibw_cp(*version_minors):
+    '''
+    Returns <version_tuples> in 'cp39*' format.
+    '''
+    ret = list()
+    for version_minor in version_minors:
+        ret.append(f'cp3{version_minor}*')
+    return ' '.join(ret)
+
+
 def main(argv):
 
     if github_workflow_unimportant():
@@ -467,7 +480,8 @@ def main(argv):
             env_extra['CIBW_ARCHS_LINUX'] = 'aarch64'
             # Testing only first and last python versions because otherwise
             # Github times out after 6h.
-            env_extra['CIBW_BUILD'] = 'cp39* cp313*'
+            versions = python_versions_cibw()
+            env_extra['CIBW_BUILD'] = f'{cibw_cp(python_versions_minor[0], python_versions_minor[-1])}'
             os_names = ['linux']
 
         elif arg == '--cibw-archs-linux':
@@ -896,7 +910,7 @@ def cibuildwheel(
             CIBW_BUILD = 'cp313*'
         elif os.environ.get('GITHUB_ACTIONS') == 'true':
             # Build/test all supported Python versions.
-            CIBW_BUILD = 'cp39* cp310* cp311* cp312* cp313*'
+            CIBW_BUILD = cibw_cp(*python_versions_minor)
         else:
             # Build/test current Python only.
             v = platform.python_version_tuple()[:2]