Python 3.14 changes

Author: tobiasraabe

.github/workflows/main.yml

@@ -43,7 +43,7 @@ jobs:
       fail-fast: false
       matrix:
         os: ['ubuntu-latest', 'macos-latest', 'windows-latest']
-        python-version: ['3.10', '3.11', '3.12', '3.13']
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
 
     steps:
       - uses: actions/checkout@v6
@@ -60,9 +60,16 @@ jobs:
           sudo apt-get install graphviz graphviz-dev
 
       - name: Run tests, doctests, and notebook tests
+        if: matrix.os != 'windows-latest' || matrix.python-version != '3.14'
         shell: bash -l {0}
         run: just test-cov
 
+      # pywin32 has no wheels for Python 3.14 yet, so skip notebook tests
+      - name: Run tests without notebook tests (Windows + Python 3.14)
+        if: matrix.os == 'windows-latest' && matrix.python-version == '3.14'
+        shell: bash -l {0}
+        run: uv run --group test pytest --cov=src --cov=tests --cov-report=xml -n auto
+
       - name: Upload test coverage reports to Codecov with GitHub Action
         uses: codecov/codecov-action@v5
 
@@ -71,5 +78,5 @@ jobs:
         run: just test-lowest
 
       - name: Run tests with highest resolution
-        if: matrix.python-version == '3.13' && matrix.os == 'ubuntu-latest'
+        if: matrix.python-version == '3.14' && matrix.os == 'ubuntu-latest'
         run: just test-highest

.python-version

@@ -1 +1 @@
-3.12
+3.14

.readthedocs.yaml

@@ -1,18 +1,19 @@
 version: 2
 
+sphinx:
+  configuration: docs/source/conf.py
+  fail_on_warning: true
+
 build:
   os: ubuntu-24.04
   tools:
-    python: "3.12"
+    python: "3.13"
   jobs:
-    create_environment:
-      - asdf plugin add uv
-      - asdf install uv latest
-      - asdf global uv latest
-      - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --group docs
-    install:
-      - "true"
-
-sphinx:
-  configuration: docs/source/conf.py
-  fail_on_warning: true
+      pre_create_environment:
+         - asdf plugin add uv
+         - asdf install uv latest
+         - asdf global uv latest
+      create_environment:
+         - uv venv "${READTHEDOCS_VIRTUALENV_PATH}"
+      install:
+         - UV_PROJECT_ENVIRONMENT="${READTHEDOCS_VIRTUALENV_PATH}" uv sync --frozen --group docs

CHANGELOG.md

@@ -30,7 +30,8 @@ releases are available on [PyPI](https://pypi.org/project/pytask) and
 - {pull}`706` disables syntax highlighting for platform version information in session header.
 - {pull}`707` drops support for Python 3.9 as it has reached end of life.
 - {pull}`708` updates mypy and fixes type issues.
-- {pull}`709` add uv pre-commit check.
+- {pull}`709` adds uv pre-commit check.
+- {pull}`710` adds support for Python 3.14.
 - {pull}`713` removes uv as a test dependency. Closes {issue}`712`. Thanks to {user}`erooke`!
 - {pull}`718` fixes {issue}`717` by properly parsing the `pdbcls` configuration option from config files. Thanks to {user}`MImmesberger` for the report!
 - {pull}`719` fixes repeated tasks with the same function name in the programmatic interface to ensure all tasks execute correctly.

justfile

@@ -35,4 +35,4 @@ test-lowest:
 
 # Run tests with highest dependency resolution (like CI)
 test-highest:
-    uv run --python 3.13 --group test --resolution highest pytest --nbmake -n auto
+    uv run --python 3.14 --group test --resolution highest pytest --nbmake -n auto

pyproject.toml

@@ -15,6 +15,7 @@ classifiers = [
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Scientific/Engineering",
     "Topic :: Software Development :: Build Tools",
 ]
@@ -65,7 +66,8 @@ plugin-list = ["httpx>=0.27.0", "tabulate[widechars]>=0.9.0", "tqdm>=4.66.3"]
 test = [
     "cloudpickle>=3.0.0",
     "deepdiff>=7.0.0",
-    "nbmake>=1.5.5",
+    # nbmake requires pywin32 on Windows, which has no wheels for Python 3.14 yet
+    "nbmake>=1.5.5; platform_system != 'Windows' or python_version < '3.14'",
     "pygments>=2.18.0",
     "pexpect>=4.9.0",
     "pytest>=8.4.0",
@@ -165,6 +167,7 @@ markers = [
 filterwarnings = [
     "ignore:'@pytask.mark.*. is deprecated:FutureWarning",
     "ignore:The --rsyncdir command line argument:DeprecationWarning",
+    "ignore:'asyncio\\..*' is deprecated:DeprecationWarning",
 ]
 
 [tool.ty.rules]

tests/conftest.py

@@ -11,9 +11,13 @@
 
 import pytest
 from click.testing import CliRunner
-from nbmake.pytest_items import NotebookItem
 from packaging import version
 
+try:
+    from nbmake.pytest_items import NotebookItem
+except ImportError:
+    NotebookItem = None
+
 from pytask import console
 from pytask import storage
 
@@ -143,6 +147,8 @@ def run_in_subprocess(cmd: tuple[str, ...], cwd: Path | None = None) -> Result:
 
 def pytest_collection_modifyitems(session, config, items) -> None:  # noqa: ARG001
     """Add markers to Jupyter notebook tests."""
+    if NotebookItem is None:
+        return
     for item in items:
         if isinstance(item, NotebookItem):
             item.add_marker(pytest.mark.xfail(reason="The tests are flaky."))