build: Support testing multiple Python versions in CI and locally

.github/workflows/ci.yml: 
.gitignore: 
Justfile: 
crates/codetracer-python-recorder/test/smoke.py: 
crates/codetracer-python-recorder/test/test_smoke.py: 
crates/codetracer-python-recorder/uv.lock: 
flake.lock: 
flake.nix: 
uv.lock: 

Signed-off-by: Tzanko Matev <[email protected]>

Author: tzanko-matev

.github/workflows/ci.yml

@@ -8,50 +8,55 @@ on:
 
 jobs:
   tests:
-    name: Tests on ${{ matrix.os }}
+    name: Tests on ${{ matrix.os }} (Python ${{ matrix.python-version }})
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.x'
+      - uses: astral-sh/setup-uv@v4
+      - name: Install Python via uv
+        shell: bash
+        run: uv python install ${{ matrix.python-version }}
       - name: Run tests
         shell: bash
-        run: python -m unittest discover -v
+        run: uv run -p ${{ matrix.python-version }} -m unittest discover -v
 
   nix-tests:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
       - uses: cachix/install-nix-action@v27
         with:
-          nix_path: nixpkgs=channel:nixos-24.05
+          nix_path: nixpkgs=channel:nixos-25.05
           extra_nix_config: |
             experimental-features = nix-command flakes
       - name: Run tests via Nix
         run: nix develop --command just test
 
   rust-smoke:
-    name: Rust module smoke test on ${{ matrix.os }}
+    name: Rust module smoke test on ${{ matrix.os }} (Python ${{ matrix.python-version }})
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["10", "11", "12", "13"]
     steps:
       - uses: actions/checkout@v4
       - uses: actions/setup-python@v5
         with:
-          python-version: '3.x'
+          python-version: 3.${{ matrix.python-version }}
+      - uses: astral-sh/setup-uv@v4
       - uses: messense/maturin-action@v1
         with:
           command: build
-          args: -m crates/codetracer-python-recorder/Cargo.toml --release
-      - name: Install built wheel
-        shell: bash
-        run: python -m pip install --upgrade pip && python -m pip install crates/codetracer-python-recorder/target/wheels/*.whl
-      - name: Import smoke test
+          args: --interpreter python3.${{ matrix.python-version }} -m crates/codetracer-python-recorder/Cargo.toml --release
+      - name: Install and smoke test built wheel with uv (pytest)
         shell: bash
-        run: python -c "import codetracer_python_recorder as m; print(m.hello())"
+        run: |
+          v={{matrix.python-version}}
+          file=(crates/codetracer-python-recorder/target/wheels/codetracer_python_recorder_*_cp3$v-cp3$v-*.whl)
+          file="${file[0]}"
+          uv run -p python3.$v --with "${file}" --with pytest -- python -m pytest crates/codetracer-python-recorder/test -q

.gitignore

@@ -2,4 +2,5 @@
 **/__pycache__/
 .aider*
 .venv/
-**/target/
+**/target/
+build

Justfile

@@ -1,5 +1,8 @@
 # Development helpers for the monorepo
 
+# Python versions used for multi-version testing/building with uv
+PY_VERSIONS := "3.10 3.11 3.12 3.13"
+PY_SHORT_VERSIONS := "10 11 12 13"
 # Print toolchain versions to verify the dev environment
 env:
     python3 --version
@@ -10,7 +13,6 @@ env:
 # Create a local virtualenv for Python tooling
 venv:
     test -d .venv || python3 -m venv .venv
-    .venv/bin/python -m pip install -U pip
 
 # Build and develop-install the Rust-backed Python module
 build-rust:
@@ -19,8 +21,28 @@ build-rust:
 
 # Smoke test the Rust module after build
 smoke-rust:
-    .venv/bin/python -c "import codetracer_python_recorder as m; print(m.hello())"
+    .venv/bin/python -m pip install -U pip pytest
+    .venv/bin/python -m pytest crates/codetracer-python-recorder/test -q
 
 # Run the Python test suite for the pure-Python recorder
 test:
     python3 -m unittest discover -v
+
+# Run the test suite across multiple Python versions using uv
+test-uv-all:
+    uv python install {{PY_VERSIONS}}
+    for v in {{PY_VERSIONS}}; do uv run -p "$v" -m unittest discover -v; done
+
+# Build wheels for all target Python versions with maturin
+build-rust-uv-all:
+    for v in {{PY_VERSIONS}}; do \
+        maturin build --interpreter "python$v" -m crates/codetracer-python-recorder/Cargo.toml --release; \
+    done
+
+# Smoke the built Rust wheels across versions using uv
+smoke-rust-uv-all:
+    for v in {{PY_SHORT_VERSIONS}}; do \
+        file=(crates/codetracer-python-recorder/target/wheels/codetracer_python_recorder-*-cp3$v-cp3$v-*.whl); \
+        file="${file[0]}"; \
+        uv run -p "python3.$v" --with "${file}" --with pytest -- python -m pytest crates/codetracer-python-recorder/test -q; \
+    done

crates/codetracer-python-recorder/test/smoke.py

@@ -0,0 +1,8 @@
+"""Smoke test for codetracer_python_recorder wheel."""
+
+def main() -> None:
+    import codetracer_python_recorder as m
+    print(m.hello())
+
+if __name__ == "__main__":
+    main()

crates/codetracer-python-recorder/test/test_smoke.py

@@ -0,0 +1,5 @@
+import codetracer_python_recorder as m
+
+
+def test_hello_returns_expected_string() -> None:
+    assert m.hello() == "Hello from codetracer-python-recorder (Rust)"

crates/codetracer-python-recorder/uv.lock

@@ -1,7 +1,7 @@
 {
   description = "Development environment for CodeTracer recorders (pure-python and rust-backed)";
 
-  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-24.05";
+  inputs.nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.05";
 
   outputs = { self, nixpkgs }:
     let
@@ -14,14 +14,18 @@
           default = pkgs.mkShell {
             packages = with pkgs; [
               bashInteractive
-              python3
+              python310
+	      python311
+	      python312
+	      python313
               just
               git-lfs
 
               # Linters and type checkers for Python code
               ruff
               black
               mypy
+              python3Packages.pytest
 
               # Rust toolchain for the Rust-backed Python module
               cargo
@@ -31,6 +35,7 @@
 
               # Build tooling for Python extensions
               maturin
+              uv
               pkg-config
             ];
           };