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

Also clean up existing actions.

Author: jathoms

.github/actions/setup/action.yml

@@ -0,0 +1,18 @@
+name: "Set up uv and python"
+inputs:
+  groups:
+    description: "uv dependency groups to install"
+    required: false
+    default: "dev"
+runs:
+  using: "composite"
+  steps:
+    - uses: actions/setup-python@v5
+      with:
+        python-version: "3.13"
+
+    - uses: astral-sh/setup-uv@v7
+
+    - name: Sync deps
+      shell: bash
+      run: uv sync --group ${{ inputs.groups }} --frozen

.github/workflows/build-docs.yml

@@ -0,0 +1,50 @@
+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: Setup
+        uses: ./.github/actions/setup
+
+      - name: Set up just 
+        uses: extractions/setup-just@v3
+
+      - name: Build docs
+        run: just docs
+
+  doctest:
+    name: Run doctests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup
+        uses: ./.github/actions/setup
+        with:
+          groups: docs
+
+      - name: Set up just
+        uses: extractions/setup-just@v3
+
+      - name: Run doctests
+        run: just doctest

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

@@ -24,7 +24,7 @@ jobs:
     name: Ruff (lint + format)
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Ruff check
         uses: astral-sh/ruff-action@v3
@@ -40,19 +40,10 @@ jobs:
     name: Typecheck (pyrefly)
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
-      - 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: Sync typecheck deps (locked)
-        run: uv sync --dev --frozen
+      - name: Setup
+      - uses: ./.github/actions/setup
 
       - name: Run pyrefly
         run: uv run pyrefly check

.github/workflows/clear-notebooks.yml

@@ -0,0 +1,29 @@
+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@v6
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
+      - name: nbconvert
+        run: uv run pre-commit run notebook-clear-outputs --all-files

.github/workflows/unit-tests.yml

@@ -0,0 +1,25 @@
+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@v6
+
+      - name: Setup
+        uses: ./.github/actions/setup
+
+      - name: pytest
+        run: uv run pytest

.pre-commit-config.yaml

@@ -22,7 +22,7 @@ repos:
         pass_filenames: false
         always_run: true
 
-      - id: pytest-check
+      - id: pytest
         name: pytest (all tests)
         entry: uv run pytest
         language: system
@@ -31,7 +31,7 @@ repos:
 
       - id: notebook-clear-outputs
         name: reset jupyter notebook state
-        entry: uv run jupyter nbconvert --clear-output
+        entry: uv run jupyter nbconvert --clear-output --show-diff-on-failure
         files: \.ipynb$
         language: system