chore: include more justfile commands in ci (#192)

Create a reusable workflow to setup our project environment and run a
command. Use this for the existing checks and add two more checks.

* Check examples do not error
* Check docs do not error
* Also trigger a docs deploy on release so we don't have to do this
manually.
* Remove quantinuum-sphinx because it is failing and we don't use it.

EDIT: GitHub is confused when I try to modify/delete `ci.yml` so I'm
going to try this in two separate PRs... the next will remove the old
`ci.yml`.

Author: mwpb

.github/workflows/checks.yml

@@ -0,0 +1,34 @@
+name: Python package CI
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+
+jobs:
+  lint:
+    uses: ./.github/workflows/run-command.yml
+    with:
+      command_name: lint
+      command: just lint
+
+  test:
+    uses: ./.github/workflows/run-command.yml
+    with:
+      command_name: test
+      command: just test
+
+  examples:
+    uses: ./.github/workflows/run-command.yml
+    with:
+      command_name: examples
+      command: just examples
+
+  docs:
+    uses: ./.github/workflows/run-command.yml
+    with:
+      command_name: docs
+      command: just docs

.github/workflows/docs.yml

@@ -1,4 +1,6 @@
 on:
+  release:
+    types: [created]
   workflow_dispatch:
 
 jobs:

.github/workflows/run-command.yml

@@ -0,0 +1,36 @@
+name: Reusable setup for command
+
+on:
+  workflow_call:
+    inputs:
+      command_name:
+        required: true
+        type: string
+      command:
+        required: true
+        type: string
+
+jobs:
+  run:
+    name: ${{ inputs.command_name }}
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        python-version: ["3.12"]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up uv & venv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: "0.6.6"
+          enable-cache: true
+          python-version: ${{ matrix.python-version }}
+          cache-dependency-glob: uv.lock
+
+      - name: Setup just
+        uses: extractions/setup-just@v3
+
+      - name: ${{ inputs.command_name }}
+        run: ${{ inputs.command }}

docs/source/conf.py

@@ -13,7 +13,7 @@
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = ["autodoc2", "quantinuum_sphinx", "myst_nb"]
+extensions = ["autodoc2", "myst_nb"]
 autodoc2_packages = [
     "../../tierkreis/tierkreis",
     "../../tierkreis_workers/aer_worker",

examples/example_workers/auth_worker/uv.lock

@@ -26,13 +26,10 @@ test = [
     "pydantic>=2.9.2",
 ]
 docs = [
-    "quantinuum-sphinx",
     "sphinx>=8.2",
     "myst-parser>=4.0.1",
     "sphinx-autodoc2>=0.5.0",
     "myst-nb>=1.3.0",
+    "furo>=2025.7.19",
 ]
 examples = ["pyscf>=2.9.0"]
-
-[tool.uv.sources]
-quantinuum-sphinx = { git = "https://github.com/CQCL/quantinuum-sphinx.git" }

examples/example_workers/substitution_worker/uv.lock

@@ -60,7 +60,7 @@ def run(
                 )
                 proc.communicate(
                     f"{launcher_path} {worker_call_args_path} && touch {done_path}".encode(),
-                    timeout=3,
+                    timeout=10,
                 )
 
     def _create_env(

pyproject.toml

@@ -51,5 +51,5 @@ def run(self, launcher_name: str, worker_call_args_path: Path) -> None:
                 )
                 proc.communicate(
                     f"{launcher_path} <{input_file} >{output_file} && touch {done_path}".encode(),
-                    timeout=3,
+                    timeout=10,
                 )