add nox and test against different Python and Django versions

Author: joshuadavidthomas

.github/workflows/test.yml

@@ -16,15 +16,35 @@ env:
   PYTHONUNBUFFERED: "1"
 
 jobs:
+  generate-matrix:
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: ${{ steps.set-matrix.outputs.matrix }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          pyproject-file: pyproject.toml
+
+      - id: set-matrix
+        run: |
+          uv run nox --session "gha_matrix"
+
   test:
+    name: Python ${{ matrix.python-version }}, Django ${{ matrix.django-version }} (${{ matrix.os }})
     runs-on: ${{ matrix.os }}
+    needs: generate-matrix
     strategy:
       fail-fast: false
       matrix:
         os:
           - macos-latest
           - ubuntu-latest
           - windows-latest
+        include: ${{ fromJson(needs.generate-matrix.outputs.matrix) }}
     steps:
       - uses: actions/checkout@v4
 
@@ -34,10 +54,6 @@ jobs:
           enable-cache: true
           pyproject-file: pyproject.toml
 
-      - name: Install dependencies and build
-        run: |
-          uv sync --frozen
-          uv run maturin build
-
       - name: Run tests
-        run: cargo test --verbose
+        run: |
+          uv run nox --session "tests(python='${{ matrix.python-version }}', django='${{ matrix.django-version }}')" -- --slow

Justfile

@@ -8,6 +8,10 @@ mod docs ".just/docs.just"
 default:
     @just --list
 
+[private]
+nox SESSION *ARGS:
+    uv run nox --session "{{ SESSION }}" -- "{{ ARGS }}"
+
 bumpver *ARGS:
     uv run --with bumpver bumpver {{ ARGS }}
 
@@ -17,4 +21,10 @@ clean:
 # run pre-commit on all files
 lint:
     @just --fmt
-    uv run --with pre-commit-uv pre-commit run --all-files
+    @just nox lint
+
+test *ARGS:
+    @just nox test {{ ARGS }}
+
+testall *ARGS:
+    @just nox tests {{ ARGS }}

noxfile.py

@@ -0,0 +1,131 @@
+from __future__ import annotations
+
+import json
+import os
+from pathlib import Path
+
+import nox
+
+nox.options.default_venv_backend = "uv|virtualenv"
+nox.options.reuse_existing_virtualenvs = True
+
+PY39 = "3.9"
+PY310 = "3.10"
+PY311 = "3.11"
+PY312 = "3.12"
+PY313 = "3.13"
+PY_VERSIONS = [PY39, PY310, PY311, PY312, PY313]
+PY_DEFAULT = PY_VERSIONS[0]
+PY_LATEST = PY_VERSIONS[-1]
+
+DJ42 = "4.2"
+DJ50 = "5.0"
+DJ51 = "5.1"
+DJMAIN = "main"
+DJMAIN_MIN_PY = PY312
+DJ_VERSIONS = [DJ42, DJ50, DJ51, DJMAIN]
+DJ_LTS = [
+    version for version in DJ_VERSIONS if version.endswith(".2") and version != DJMAIN
+]
+DJ_DEFAULT = DJ_LTS[0]
+DJ_LATEST = DJ_VERSIONS[-2]
+
+
+def version(ver: str) -> tuple[int, ...]:
+    """Convert a string version to a tuple of ints, e.g. "3.10" -> (3, 10)"""
+    return tuple(map(int, ver.split(".")))
+
+
+def should_skip(python: str, django: str) -> bool:
+    """Return True if the test should be skipped"""
+
+    if django == DJMAIN and version(python) < version(DJMAIN_MIN_PY):
+        # Django main requires Python 3.10+
+        return True
+
+    if django == DJ51 and version(python) < version(PY310):
+        # Django 5.1 requires Python 3.10+
+        return True
+
+    if django == DJ50 and version(python) < version(PY310):
+        # Django 5.0 requires Python 3.10+
+        return True
+
+    return False
+
+
+@nox.session
+def test(session):
+    session.notify(f"tests(python='{PY_DEFAULT}', django='{DJ_DEFAULT}')")
+
+
+@nox.session
+@nox.parametrize(
+    "python,django",
+    [
+        (python, django)
+        for python in PY_VERSIONS
+        for django in DJ_VERSIONS
+        if not should_skip(python, django)
+    ],
+)
+def tests(session, django):
+    session.run_install(
+        "uv",
+        "sync",
+        "--frozen",
+        "--inexact",
+        "--no-install-package",
+        "django",
+        "--python",
+        session.python,
+        env={"UV_PROJECT_ENVIRONMENT": session.virtualenv.location},
+    )
+
+    if django == DJMAIN:
+        session.install(
+            "django @ https://github.com/django/django/archive/refs/heads/main.zip"
+        )
+    else:
+        session.install(f"django=={django}")
+
+    command = ["cargo", "test"]
+    if session.posargs:
+        args = []
+        for arg in session.posargs:
+            if arg:
+                args.extend(arg.split(" "))
+        command.extend(args)
+    session.run(*command, external=True)
+
+
+@nox.session
+def lint(session):
+    session.run(
+        "uv",
+        "run",
+        "--with",
+        "pre-commit-uv",
+        "--python",
+        PY_LATEST,
+        "pre-commit",
+        "run",
+        "--all-files",
+    )
+
+
+@nox.session
+def gha_matrix(session):
+    sessions = session.run("nox", "-l", "--json", silent=True)
+    matrix = {
+        "include": [
+            {
+                "python-version": session["python"],
+                "django-version": session["call_spec"]["django"],
+            }
+            for session in json.loads(sessions)
+            if session["name"] == "tests"
+        ]
+    }
+    with Path(os.environ["GITHUB_OUTPUT"]).open("a") as fh:
+        print(f"matrix={matrix}", file=fh)

pyproject.toml

@@ -6,6 +6,7 @@ build-backend = "maturin"
 dev = [
     "django-stubs>=5.1.1",
     "maturin>=1.7.8",
+    "nox[uv]>=2025.2.9",
     "ruff>=0.8.2",
 ]
 docs = [