FIX: render Plotly again on notebook pages

.cspell.json

@@ -45,6 +45,7 @@
     "PINF",
     "Richman",
     "absl",
+    "addopts",
     "aitchison",
     "allclose",
     "arange",
@@ -84,6 +85,7 @@
     "epsrel",
     "eqnarray",
     "errordef",
+    "esac",
     "facecolor",
     "facecolors",
     "fcode",
@@ -166,6 +168,7 @@
     "nstar",
     "numpycode",
     "operatorname",
+    "parentsize",
     "pathlib",
     "pbar",
     "pcolormesh",

.github/collect_notebooks.py

@@ -0,0 +1,44 @@
+"""Print notebooks changed relative to a base ref, excluding pytest --ignore paths."""
+# /// script
+# requires-python = ">=3.11"
+# ///
+
+from __future__ import annotations
+
+import subprocess  # noqa: S404
+import sys
+from pathlib import Path
+
+import tomllib  # ty:ignore[unresolved-import]
+
+
+def main() -> None:
+    base_ref = sys.argv[1] if len(sys.argv) > 1 else "main"
+    changed = subprocess.check_output(  # noqa: S603
+        ["git", "diff", "--name-only", f"origin/{base_ref}...HEAD"],  # noqa: S607
+        text=True,
+    ).splitlines()
+
+    notebooks: set[Path] = set()
+    for path_str in changed:
+        path = Path(path_str)
+        if path.suffix == ".ipynb":
+            notebooks.add(path)
+        elif path.name == "uv.lock":
+            notebooks.update(path.parent.glob("*.ipynb"))
+
+    with open("pyproject.toml", "rb") as f:
+        addopts = tomllib.load(f)["tool"]["pytest"]["addopts"]
+    ignored = [
+        Path(o[len("--ignore=") :]) for o in addopts if o.startswith("--ignore=")
+    ]
+
+    def is_ignored(nb: Path) -> bool:
+        return any(nb == ig or ig in nb.parents for ig in ignored)
+
+    result = sorted(nb for nb in notebooks if not is_ignored(nb))
+    print(" ".join(str(nb) for nb in result))  # noqa: T201
+
+
+if __name__ == "__main__":
+    main()

.github/workflows/notebooks.yml

@@ -1,24 +1,60 @@
-name: Run all notebooks
+name: Run notebooks
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: |-
+    ${{ github.ref != format('refs/heads/{0}', github.event.repository.default_branch) }}
+
+env:
+  FORCE_COLOR: true
 
 on:
   workflow_dispatch:
     inputs:
       notebook-selector:
-        description: Relative path to notebooks
+        description: Space-separated paths to notebooks (runs all if omitted)
         required: false
         type: string
+  pull_request:
+    branches:
+      - main
+      - epic/*
+      - "[0-9]+.[0-9]+.x"
+    paths:
+      - docs/**
 
 jobs:
   pytest:
-    name: Test all notebooks
+    name: Test notebooks
     runs-on: ubuntu-24.04
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       - uses: actions/setup-python@v5
         with:
           python-version: "3.13"
       - uses: astral-sh/setup-uv@v6
       - name: Install graphviz
         run: sudo apt-get -y install graphviz
-      - name: Run all notebooks
-        run: uv run --extra test pytest ${{ github.event.inputs.notebook-selector }}
+      - name: Collect notebooks to test
+        id: notebooks
+        run: |
+          if [ "${{ github.event_name }}" = "pull_request" ]; then
+            selector=$(uv run .github/collect_notebooks.py "${{ github.base_ref }}")
+          else
+            selector="${{ github.event.inputs.notebook-selector }}"
+          fi
+          echo "selector=$selector" >> $GITHUB_OUTPUT
+      - name: Initialize environments
+        if: github.event_name != 'pull_request' || steps.notebooks.outputs.selector != ''
+        run: |
+          for notebook in ${{ steps.notebooks.outputs.selector }}; do
+            project=$(dirname "$notebook")
+            echo
+            echo "--== Initializing project $project ==--"
+            uv run --project="$project" true
+          done
+      - name: Run notebooks
+        if: github.event_name != 'pull_request' || steps.notebooks.outputs.selector != ''
+        run: uv run --group test --no-dev pytest ${{ steps.notebooks.outputs.selector }}

.pre-commit-config.yaml

@@ -13,7 +13,7 @@ repos:
       - id: check-useless-excludes
 
   - repo: https://github.com/ComPWA/policy
-    rev: 0.8.9
+    rev: 0.8.10
     hooks:
       - id: check-dev-files
         args:
@@ -79,7 +79,7 @@ repos:
           )$
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.10
+    rev: v0.15.12
     hooks:
       - id: ruff-check
         args: [--fix]
@@ -166,6 +166,6 @@ repos:
         types_or: [python, pyi, jupyter]
 
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.11.6
+    rev: 0.11.13
     hooks:
       - id: uv-lock

docs/.gitignore

@@ -3,7 +3,5 @@
 *.svg
 _inventory.md
 
-002/*-tree
-002/*-graph
 013/graph?
 018/graph

docs/000/index.ipynb

@@ -43,19 +43,6 @@
     "<!-- cspell:disable -->"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "metadata": {
-    "tags": [
-     "remove-cell"
-    ]
-   },
-   "outputs": [],
-   "source": [
-    "%pip install -q black==21.5b2 jax==0.4.28 jaxlib==0.4.28 numpy==1.23 sympy==1.8"
-   ]
-  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -894,7 +881,7 @@
   "kernelspec": {
    "display_name": "Pyproject Local",
    "language": "python",
-   "name": "python3"
+   "name": "pyproject_local_kernel"
   },
   "language_info": {
    "codemirror_mode": {
@@ -906,7 +893,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.13.12"
+   "version": "3.13.13"
   },
   "orphan": true
  },

docs/000/pyproject.toml

@@ -1,3 +1,14 @@
+[project]
+dependencies = [
+    "black",
+    "jax",
+    "numpy~=1.23.0",
+    "sympy",
+]
+name = "technical-report"
+requires-python = "~=3.11.0"
+version = "0.1.0"
+
 [tool.ruff]
 preview = true
 
@@ -15,3 +26,5 @@ select = ["ALL"]
 
 [tool.ruff.lint.flake8-builtins]
 builtins-ignorelist = ["display"]
+
+[tool.uv.workspace]