Add actions for notebook clearing, building docs, and running unit tests

Author: jathoms

.github/workflows/build-docs.yml

@@ -0,0 +1,60 @@
+name: CI - Build docs
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - "docs/**"
+      - "**/*.py"
+      - ".github/workflows/build-docs.yml"
+  pull_request:
+    paths:
+      - "docs/**"
+      - ".github/workflows/build-docs.yml"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  docs:
+    name: Build docs
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install uv
+        run: python -m pip install -U uv
+
+      - name: Install just
+        run: uv tool install just
+
+      - name: Build docs
+        run: just docs
+
+  doctest:
+    name: Run doctests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install uv
+        run: python -m pip install -U uv
+
+      - name: Install just
+        run: uv tool install just
+
+      - name: Run doctests
+        run: just doctest

.github/workflows/ci-lint-typecheck.yml

@@ -51,7 +51,7 @@ jobs:
       - name: Install uv
         run: python -m pip install -U uv
 
-      - name: Sync typecheck deps (locked)
+      - name: uv sync
         run: uv sync --dev --frozen
 
       - name: Run pyrefly

.github/workflows/clear-notebooks.yml

@@ -0,0 +1,38 @@
+name: CI - Clear notebook outputs
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - "**/*.ipynb"
+      - ".github/workflows/clear-notebooks.yml"
+  pull_request:
+    paths:
+      - "**/*.ipynb"
+      - ".github/workflows/clear-notebooks.yml"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  nbconvert:
+    name: Clear notebooks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install uv
+        run: python -m pip install -U uv
+
+      - name: uv sync
+        run: uv sync --dev --frozen
+
+      - name: nbconvert
+        run: uv run jupyter nbconvert --clear-output **.ipynb

.github/workflows/unit-tests.yml

@@ -0,0 +1,34 @@
+name: Run unit tests
+
+on:
+  push:
+    branches: [ main ]
+    paths:
+      - "**/*.py"
+      - ".github/workflows/unit-tests.yml"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  nbconvert:
+    name: Run unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install uv
+        run: python -m pip install -U uv
+
+      - name: uv sync
+        run: uv sync
+
+      - name: pytest
+        run: uv run pytest