✨ feat: add python3.14 support (including free-threading) (#545)

Author: SigureMo

.github/workflows/biliass-build-and-release.yml

@@ -107,7 +107,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.13"
+          python-version: "3.14"
           architecture: ${{ matrix.platform.target }}
           allow-prereleases: true
       - name: Build wheels

.github/workflows/e2e-test.yml

@@ -12,7 +12,8 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.13t"]
+        python-version:
+          ["3.10", "3.11", "3.12", "3.13", "3.13t", "3.14", "3.14t"]
         architecture: ["x64"]
     name: Python ${{ matrix.python-version }} on ${{ matrix.architecture }} e2e test
     steps:
@@ -27,6 +28,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           architecture: ${{ matrix.architecture }}
+          allow-prereleases: true
 
       - name: Install tools
         run: |
@@ -40,7 +42,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          just ci-install
+          just ci-install ${{ matrix.python-version }}
 
       - name: e2e without subprocess
         run: |
@@ -51,4 +53,4 @@ jobs:
 
       - name: e2e test
         run: |
-          just ci-e2e-test
+          just ci-e2e-test ${{ matrix.python-version }}

.github/workflows/latest-release-test.yml

@@ -9,7 +9,8 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.13t"]
+        python-version:
+          ["3.10", "3.11", "3.12", "3.13", "3.13t", "3.14", "3.14t"]
         architecture: ["x64"]
     name: Python ${{ matrix.python-version }} on ${{ matrix.architecture }} latest release test
     steps:
@@ -21,6 +22,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           architecture: ${{ matrix.architecture }}
+          allow-prereleases: true
 
       - name: Install tools
         run: |

.github/workflows/lint-and-fmt.yml

@@ -35,7 +35,7 @@ jobs:
 
       - name: Install dependencies
         run: |
-          just ci-install
+          just ci-install-all ${{ matrix.python-version }}
 
       - name: lint
         run: |

.github/workflows/unit-test.yml

@@ -12,7 +12,8 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12", "3.13", "3.13t"]
+        python-version:
+          ["3.10", "3.11", "3.12", "3.13", "3.13t", "3.14", "3.14t"]
         architecture: ["x64"]
     name: Python ${{ matrix.python-version }} on ${{ matrix.architecture }} unit test
     steps:
@@ -29,6 +30,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           architecture: ${{ matrix.architecture }}
+          allow-prereleases: true
 
       - name: Install just
         uses: extractions/setup-just@v3
@@ -37,14 +39,14 @@ jobs:
 
       - name: Install dependencies
         run: |
-          just ci-install
+          just ci-install ${{ matrix.python-version }}
 
       - name: Run unit tests
         run: |
-          just ci-test
+          just ci-test ${{ matrix.python-version }}
 
       - name: Run benchmarks
         uses: CodSpeedHQ/action@v3
         if: ${{ matrix.python-version == '3.13' && github.event_name != 'merge_group' }}
         with:
-          run: uv run pytest --codspeed
+          run: uv run -p ${{ matrix.python-version }} pytest --codspeed

justfile

@@ -71,20 +71,23 @@ generate-schema:
   uv run scripts/generate-schema.py
 
 # CI specific
-ci-install:
-  uv sync --all-extras --dev
+ci-install pyversion:
+  uv sync --dev -p {{pyversion}}
+
+ci-install-all pyversion:
+  uv sync --all-extras --dev -p {{pyversion}}
 
 ci-fmt-check:
   uv run ruff format --check --diff .
 
 ci-lint:
   just lint
 
-ci-test:
-  uv run pytest -m "(api or processor or biliass) and not (ci_skip or ignore)" --reruns 3 --reruns-delay 1
+ci-test pyversion:
+  uv run -p {{pyversion}} pytest -m "(api or processor or biliass) and not (ci_skip or ignore)" --reruns 3 --reruns-delay 1
 
-ci-e2e-test:
-  uv run pytest -m "e2e and not (ci_skip or ignore)"
+ci-e2e-test pyversion:
+  uv run -p {{pyversion}} pytest -m "e2e and not (ci_skip or ignore)"
 
 # docker specific
 docker-run *ARGS:

pyproject.toml

@@ -18,6 +18,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Python :: Implementation :: CPython",
 ]
 dependencies = [
@@ -28,7 +29,7 @@ dependencies = [
   "dict2xml>=1.7.7",
   "httpx[http2,socks]>=0.28.1",
   "tomli>=2.2.1; python_version < '3.11'",
-  "pydantic>=2.11.7",
+  "pydantic>=2.12.0a1",
   "returns>=0.26.0",
 ]
 optional-dependencies.mcp = ["fastmcp>=2.10.2"]
@@ -45,8 +46,8 @@ yutto = "yutto.__main__:main"
 [dependency-groups]
 dev = [
   "pyright>=1.1.403",
-  "ruff>=0.12.5",
-  "typos>=1.34.0",
+  "ruff>=0.12.7",
+  "typos>=1.35.0",
   "pytest>=8.4.1",
   "pytest-rerunfailures>=15.1",
   "syrupy>=4.9.1",