Add Python 3.14 compatibility matrix

Author: Vladimir Vilimaitis

.github/workflows/ci.yml

@@ -25,6 +25,7 @@ jobs:
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
 
     steps:
       - uses: actions/checkout@v4
@@ -54,7 +55,7 @@ jobs:
           uv run --no-sync python scripts/smoke_public_api.py
 
       - name: Rust and lint gates
-        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.14'
         run: |
           cargo fmt --check
           cargo clippy --all-targets -- -D warnings

.github/workflows/release.yml

@@ -43,6 +43,7 @@ jobs:
             -i python3.11
             -i python3.12
             -i python3.13
+            -i python3.14
           sccache: "true"
 
       - uses: actions/upload-artifact@v4
@@ -61,6 +62,7 @@ jobs:
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
 
     steps:
       - uses: actions/checkout@v4
@@ -97,6 +99,7 @@ jobs:
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
         platform:
           - os: macos-13
             target: x86_64
@@ -160,7 +163,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.13"
+          python-version: "3.14"
 
       - uses: actions/download-artifact@v4
         with:
@@ -172,9 +175,10 @@ jobs:
 
       - name: Install artifact in a clean environment
         run: |
+          PACKAGE_VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
           python -m venv .smoke
           .smoke/bin/python -m pip install --upgrade pip
-          .smoke/bin/python -m pip install --find-links dist polars-janitor==0.1.0
+          .smoke/bin/python -m pip install --find-links dist "polars-janitor==$PACKAGE_VERSION"
           .smoke/bin/python scripts/smoke_public_api.py
           .smoke/bin/python -m pip install --force-reinstall "polars==1.29.0"
           .smoke/bin/python scripts/smoke_public_api.py

README.md

@@ -25,15 +25,15 @@ import polars_janitor as pj
 pip install polars-janitor
 ```
 
-`polars-janitor` supports Python Polars `1.29.0` and newer. Older Polars `1.x` wheels do not expose the data exchange API this extension uses.
+`polars-janitor` supports CPython 3.10 through 3.14 and Python Polars `1.29.0` and newer. Older Polars `1.x` wheels do not expose the data exchange API this extension uses.
 
 From a local checkout:
 
 ```powershell
 uv run --extra dev maturin develop --release
 ```
 
-The Rust extension is built for the Python interpreter active in your environment. If you switch interpreters, for example from CPython 3.13 to CPython 3.11, rebuild it. The compiled `_rust.*.pyd` on Windows, or `_rust.*.so` on Linux and macOS, is not portable across Python versions.
+The Rust extension is built for the Python interpreter active in your environment. If you switch interpreters, for example from CPython 3.14 to CPython 3.13, rebuild it. The compiled `_rust.*.pyd` on Windows, or `_rust.*.so` on Linux and macOS, is not portable across Python versions.
 
 ## Python usage
 
@@ -319,7 +319,7 @@ Those may be useful in R, but in Polars they either duplicate existing APIs or p
 
 LazyFrame support is deliberately conservative. `clean_names`, `remove_empty(..., axis="rows")`, `get_dupes`, `compare_df_cols`, and `compare_df_cols_same` can work from lazy schemas or build lazy plans without collecting data. Helpers that need to inspect values are eager-only: `find_header`, `row_to_names`, `remove_constant`, and `remove_empty(..., axis="cols" | "both")`.
 
-The package supports Python Polars `1.29.0` and newer. Compatibility tests run against that lower bound and the current lockfile version.
+The package supports CPython 3.10 through 3.14 and Python Polars `1.29.0` and newer. Compatibility tests run against that lower bound and the current lockfile version.
 
 The project favors broad Python Polars compatibility over direct Rust deserialization of Python lazy plans. Most eager frame helpers cross through `pyo3-polars`; lazy frames keep their plans in Python Polars, with Rust deciding what public Polars plan to build. `clean_names` is a little different: Rust cleans the names, then Polars' public `rename` API applies them.
 

pyproject.toml

@@ -36,6 +36,7 @@ classifiers = [
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Programming Language :: Rust",
   "Topic :: Scientific/Engineering :: Information Analysis",
   "Typing :: Typed",

scripts/check_release_artifacts.py

@@ -10,7 +10,7 @@
 if TYPE_CHECKING:
     from collections.abc import Callable
 
-PYTHON_TAGS = ("cp310", "cp311", "cp312", "cp313")
+PYTHON_TAGS = ("cp310", "cp311", "cp312", "cp313", "cp314")
 PLATFORM_CHECKS: dict[str, Callable[[str], bool]] = {
     "win_amd64": lambda name: "win_amd64" in name,
     "macos_x86_64": lambda name: "macosx" in name and "x86_64" in name,