Support Python 3.14 (#2871)

* Bump sphinx from 8.2.3 to 9.1.0

Bumps [sphinx](https://github.com/sphinx-doc/sphinx) from 8.2.3 to 9.1.0.
- [Release notes](https://github.com/sphinx-doc/sphinx/releases)
- [Changelog](https://github.com/sphinx-doc/sphinx/blob/master/CHANGES.rst)
- [Commits](sphinx-doc/sphinx@v8.2.3...v9.1.0)

---
updated-dependencies:
- dependency-name: sphinx
  dependency-version: 9.1.0
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>

* Bump doc8

* Support Python 3.14

* Don't bump Sphinx

* Fix secrets file lookup for multi-Python matrix

Use modulo arithmetic to map job index to secrets file index,
ensuring that adding Python versions to the matrix doesn't break
the secrets file lookup. Each test pattern maps to the same
secrets file regardless of Python version.

The number of secrets files is determined dynamically from
the extracted tarball.

* Support only 3.14

* Fix ruff

* Revert "Fix ruff"

This reverts commit 9a342f4.

* Ignore ruff TC rules until beartype supports TYPE_CHECKING

Beartype requires imports to be available at runtime, not just under
`if TYPE_CHECKING`. See beartype/beartype#594
for when beartype 0.23 will add support for TYPE_CHECKING imports.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Remove runtime beartype application to test functions

Python 3.14's deferred annotation evaluation (PEP 649) causes
`_Stringifier.__format__` to raise a TypeError when beartype
inspects function signatures at test collection time.

This is a workaround until beartype 0.23 is released with full
Python 3.14 support.

See:
- beartype/beartype#594
- beartype/beartype#440

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Drop pytest-beartype-tests due to Python 3.14 annotation issue

* [pre-commit.ci lite] apply automatic fixes

* Apply ruff format (PEP 758 except syntax)

* Restore pytest-beartype-tests; disable plugin in repeated pytest.main calls

* Ignore .claude/scheduled_tasks.lock

* Add 'stringify' to spelling dict

* Use real subprocess for pytest collection to avoid plugin state accumulation

* Add new tests to CI matrix; exclude meta-tests from collected-once check

* Restore Python 3.14 in test workflow matrix after merge

* Use real subprocess in test_custom_linters to avoid beartype state accumulation

* Add 'subprocess' to spelling dict

* Re-apply subprocess collection: in-process approach fails on Python 3.14 full-suite runs

* Bump pytest-beartype-tests to 2026.4.26; revert subprocess workaround in ci/test_custom_linters.py

* Run coverage tool on Python 3.14 to parse PEP 758 except syntax

* Set Python 3.14 via setup-uv python-version on coverage job

* Drop comment on coverage job python-version

---------

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Co-authored-by: pre-commit-ci-lite[bot] <117423508+pre-commit-ci-lite[bot]@users.noreply.github.com>

Author: 4 people

.github/workflows/lint.yml

@@ -18,7 +18,7 @@ jobs:
   build:
     strategy:
       matrix:
-        python-version: ['3.13']
+        python-version: ['3.14']
         platform: [ubuntu-latest, windows-latest]
         hook-stage: [pre-commit, pre-push, manual]
 

.github/workflows/publish-site.yml

@@ -22,6 +22,6 @@ jobs:
         with:
           documentation_path: docs/source
           pyproject_extras: dev
-          python_version: '3.13'
+          python_version: '3.14'
           sphinx_build_options: -W
           publish: ${{ github.ref_name == 'main' }}

.github/workflows/test.yml

@@ -26,7 +26,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ['3.13']
+        python-version: ['3.14']
         ci_pattern:
           - tests/mock_vws/test_query.py::TestContentType
           - tests/mock_vws/test_query.py::TestSuccess
@@ -191,7 +191,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.13']
+        python-version: ['3.14']
         platform: [ubuntu-latest]
 
     steps:
@@ -237,7 +237,7 @@ jobs:
     runs-on: windows-latest
     strategy:
       matrix:
-        python-version: ['3.13']
+        python-version: ['3.14']
 
     steps:
       - uses: actions/checkout@v6
@@ -291,6 +291,7 @@ jobs:
         with:
           enable-cache: true
           cache-dependency-glob: '**/pyproject.toml'
+          python-version: '3.14'
 
       - uses: actions/download-artifact@v8
         with:

README.rst

@@ -76,4 +76,4 @@ This includes details on how to use the mock, options, and details of the differ
    :target: https://github.com/VWS-Python/vws-python-mock/actions
 .. |PyPI| image:: https://badge.fury.io/py/VWS-Python-Mock.svg
     :target: https://badge.fury.io/py/VWS-Python-Mock
-.. |minimum-python-version| replace:: 3.13
+.. |minimum-python-version| replace:: 3.14

pyproject.toml

@@ -20,15 +20,15 @@ license = "MIT"
 authors = [
     { name = "Adam Dangoor", email = "adamdangoor@gmail.com" },
 ]
-requires-python = ">=3.13"
+requires-python = ">=3.14"
 classifiers = [
     "Development Status :: 5 - Production/Stable",
     "Environment :: Web Environment",
     "Framework :: Pytest",
     "Operating System :: Microsoft :: Windows",
     "Operating System :: POSIX",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
 ]
 dynamic = [
     "version",
@@ -76,7 +76,7 @@ optional-dependencies.dev = [
     "pyright==1.1.409",
     "pyroma==5.0.1",
     "pytest==9.0.3",
-    "pytest-beartype-tests==2026.4.20",
+    "pytest-beartype-tests==2026.4.26",
     "pytest-retry==1.7.0",
     "pytest-xdist==3.8.0",
     "pyyaml==6.0.3",
@@ -166,6 +166,12 @@ lint.ignore = [
     # Ignore 'too-many-*' errors as they seem to get in the way more than
     # helping.
     "PLR0913",
+    # Beartype requires imports to be available at runtime, not just for type
+    # checking. See https://github.com/beartype/beartype/discussions/594
+    # for when beartype will support `if TYPE_CHECKING` imports.
+    "TC001",
+    "TC002",
+    "TC003",
 ]
 lint.per-file-ignores."ci/test_custom_linters.py" = [
     # Allow asserts in tests.
@@ -330,7 +336,7 @@ per_rule_ignores.DEP002 = [
 [tool.pyproject-fmt]
 indent = 4
 keep_full_version = true
-max_supported_python = "3.13"
+max_supported_python = "3.14"
 
 [tool.mypy]
 strict = true

spelling_private_dict.txt

@@ -104,6 +104,8 @@ respx
 rfc
 rgb
 str
+stringify
+subprocess
 timestamp
 todo
 travis

src/mock_vws/_flask_server/Dockerfile

@@ -1,4 +1,4 @@
-FROM ghcr.io/astral-sh/uv:0.10.4-python3.13-trixie-slim AS base
+FROM ghcr.io/astral-sh/uv:0.11.7-python3.14-trixie-slim AS base
 # We set this pretend version as we do not have Git in our path, and we do
 # not care enough about having the version correct inside the Docker container
 # to install it.

src/mock_vws/_flask_server/healthcheck.py

@@ -15,7 +15,7 @@ def flask_app_healthy(port: int) -> bool:
     try:
         conn.request(method="GET", url="/some-random-endpoint")
         response = conn.getresponse()
-    except (TimeoutError, http.client.HTTPException, socket.gaierror):
+    except TimeoutError, http.client.HTTPException, socket.gaierror:
         return False
     finally:
         conn.close()

src/mock_vws/target_raters.py

@@ -42,7 +42,7 @@ def _get_brisque_target_tracking_rating(*, image_content: bytes) -> int:
     image_tensor = image_tensor.permute(2, 0, 1).unsqueeze(dim=0)
     try:
         brisque_score = brisque(x=image_tensor, data_range=255)
-    except (AssertionError, IndexError):
+    except AssertionError, IndexError:
         return 0
     return math.ceil(int(brisque_score.item()) / 20)