Harden release compatibility checks

Author: Vladimir Vilimaitis

.github/workflows/ci.yml

@@ -48,6 +48,11 @@ jobs:
       - name: Python tests
         run: uv run --extra dev pytest
 
+      - name: Lower-bound Polars smoke
+        run: |
+          uv pip install --reinstall "polars==1.29.0"
+          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'
         run: |

.github/workflows/release.yml

@@ -29,7 +29,7 @@ jobs:
         with:
           platforms: arm64
 
-      - uses: PyO3/maturin-action@v1
+      - uses: PyO3/maturin-action@423a6347767a8b16e65c2a7a7042e4a921528da8
         with:
           maturin-version: v1.11.5
           target: ${{ matrix.target }}
@@ -69,7 +69,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      - uses: PyO3/maturin-action@v1
+      - uses: PyO3/maturin-action@423a6347767a8b16e65c2a7a7042e4a921528da8
         with:
           maturin-version: v1.11.5
           target: x64
@@ -110,7 +110,7 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
 
-      - uses: PyO3/maturin-action@v1
+      - uses: PyO3/maturin-action@423a6347767a8b16e65c2a7a7042e4a921528da8
         with:
           maturin-version: v1.11.5
           target: ${{ matrix.platform.target }}
@@ -134,7 +134,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
-      - uses: PyO3/maturin-action@v1
+      - uses: PyO3/maturin-action@423a6347767a8b16e65c2a7a7042e4a921528da8
         with:
           command: sdist
           maturin-version: v1.11.5
@@ -176,6 +176,8 @@ jobs:
           .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 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
 
   publish:
     name: Publish to PyPI
@@ -193,6 +195,6 @@ jobs:
           path: dist
           merge-multiple: true
 
-      - uses: pypa/gh-action-pypi-publish@release/v1
+      - uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b
         with:
           packages-dir: dist

README.md

@@ -23,6 +23,8 @@ 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.
+
 From a local checkout:
 
 ```powershell
@@ -228,6 +230,8 @@ 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")`, and `get_dupes` can build lazy plans without collecting data. Column-removing helpers that need to inspect values are eager-only.
 
+The package supports 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. Eager frames cross through `pyo3-polars`; lazy frames keep their plans in Python Polars, with Rust deciding what public Polars plan to build.
 
 The compiled extension is CPython-version-specific. If `import polars_janitor` fails after changing Python versions, rebuild with `maturin develop --release` or reinstall from the wheel for that interpreter.

pyproject.toml

@@ -41,7 +41,7 @@ classifiers = [
   "Typing :: Typed",
 ]
 dependencies = [
-  "polars>=1.0",
+  "polars>=1.29.0",
 ]
 
 [project.urls]