DX: define developer environment with uv

.binder/postBuild

@@ -0,0 +1,18 @@
+#!/bin/bash
+set -ex
+curl -LsSf https://pixi.sh/install.sh | bash
+export PATH="$HOME/.pixi/bin:$PATH"
+
+pixi_packages="$(NO_COLOR= pixi list --explicit --no-install | awk 'NR > 1 {print $1}')"
+if [[ -n "$pixi_packages" ]]; then
+  pixi global install $pixi_packages
+fi
+pixi clean cache --yes
+
+uv export \
+  --extra jupyter \
+  > requirements.txt
+uv pip install \
+  --requirement requirements.txt \
+  --system
+uv cache clean

.binder/runtime.txt

@@ -0,0 +1 @@
+python-3.12

.cspell.json

@@ -35,8 +35,7 @@
     ".readthedocs.yml",
     ".vscode/*",
     "docs/conf.py",
-    "pyproject.toml",
-    "tox.ini"
+    "pyproject.toml"
   ],
   "language": "en-US",
   "overrides": [
@@ -89,6 +88,7 @@
     "Mikhasenko",
     "NumPy",
     "parametrizations",
+    "Pixi",
     "plotly",
     "pyplot",
     "QRules",
@@ -172,6 +172,7 @@
     "iframe",
     "imag",
     "infty",
+    "installkernel",
     "ioff",
     "iplt",
     "ipykernel",
@@ -283,6 +284,7 @@
     "unbinned",
     "unnormalized",
     "unsrt",
+    "venv",
     "viridis",
     "vmax",
     "vmin",

.editorconfig

@@ -15,3 +15,6 @@ indent_size = 4
 
 [LICENSE]
 indent_size = unset
+
+[uv.lock]
+indent_size = 4

.envrc

@@ -1,10 +1,4 @@
-if [ -e .venv ]; then
-  source .venv/bin/activate
-elif [ -e venv ]; then
-  source venv/bin/activate
-elif [ -e .pixi ]; then
-  watch_file pixi.lock
-  eval "$(pixi shell-hook)"
-else
-  layout anaconda
-fi
+watch_file pixi.lock
+eval "$(pixi shell-hook)"
+uv sync --all-extras --quiet
+source .venv/bin/activate

.github/workflows/ci.yml

@@ -28,19 +28,15 @@ on:
 
 jobs:
   doc:
-    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v1
+    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v2
     permissions:
       pages: write
       id-token: write
     with:
-      apt-packages: graphviz
       gh-pages: true
-      python-version: "3.12"
       specific-pip-packages: ${{ inputs.specific-pip-packages }}
   style:
     if: inputs.specific-pip-packages == ''
     secrets:
       token: ${{ secrets.PAT }}
-    uses: ComPWA/actions/.github/workflows/pre-commit.yml@v1
-    with:
-      python-version: "3.12"
+    uses: ComPWA/actions/.github/workflows/pre-commit.yml@v2

.github/workflows/clean-caches.yml

@@ -14,9 +14,9 @@ on:
 jobs:
   cleanup:
     name: Remove caches
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
-      - uses: ComPWA/actions/clean-caches@v1
+      - uses: ComPWA/actions/clean-caches@v2
         with:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ref: ${{ inputs.ref }}

.github/workflows/lock.yml

@@ -0,0 +1,22 @@
+name: Update
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: |-
+    ${{ github.ref != format('refs/heads/{0}', github.event.repository.default_branch) }}
+
+on:
+  pull_request:
+    branches:
+      - main
+      - epic/*
+    paths:
+      - .pre-commit-config.yaml
+      - uv.lock
+  workflow_dispatch:
+
+jobs:
+  lock:
+    uses: ComPWA/actions/.github/workflows/lock.yml@v2
+    secrets:
+      token: ${{ secrets.PAT }}

.github/workflows/pr-linting.yml

@@ -11,4 +11,4 @@ on:
 
 jobs:
   lint-pr:
-    uses: ComPWA/actions/.github/workflows/pr-linting.yml@v1
+    uses: ComPWA/actions/.github/workflows/pr-linting.yml@v2

.gitignore

@@ -21,7 +21,6 @@ version.py
 
 # Temporary files
 *.pyc
-*condaenv.*
 .coverage
 .coverage.*
 .ipynb_checkpoints/
@@ -38,7 +37,6 @@ prof/
 .pixi/
 .tox/
 *venv/
-pixi.lock
 pyvenv*/
 
 # Settings
@@ -53,6 +51,5 @@ pyvenv*/
 !.readthedocs.yml
 !.vscode/*.json
 !codecov.yml
-!environment.yml
 !pyrightconfig.json
 .jupyter_ystore.db

.pre-commit-config.yaml

@@ -1,9 +1,10 @@
 ci:
-  autoupdate_commit_msg: "MAINT: autoupdate pre-commit hooks"
+  autoupdate_commit_msg: "MAINT: update lock files"
   autoupdate_schedule: quarterly
   skip:
     - pin-nb-requirements
     - pyright
+    - uv-lock
 
 repos:
   - repo: meta
@@ -12,16 +13,15 @@ repos:
       - id: check-useless-excludes
 
   - repo: https://github.com/ComPWA/policy
-    rev: 0.4.1
+    rev: 0.5.0rc10
     hooks:
       - id: check-dev-files
         args:
-          - --doc-apt-packages=graphviz
-          - --dev-python-version=3.12
           - --github-pages
           - --imports-on-top
-          - --no-prettierrc
+          - --no-cd
           - --no-pypi
+          - --package-manager=pixi+uv
           - --repo-name=report
           - --repo-title=ComPWA Technical Reports
       - id: colab-toc-visible
@@ -56,8 +56,27 @@ repos:
             metadata.varInspector
             metadata.vscode
 
+  - repo: https://github.com/nbQA-dev/nbQA
+    rev: 1.8.7
+    hooks:
+      - id: nbqa-isort
+        args: [--float-to-top]
+        exclude: >-
+          (?x)^(
+            docs/001\.ipynb|
+            docs/002\.ipynb|
+            docs/003\.ipynb|
+            docs/008\.ipynb|
+            docs/013\.ipynb|
+            docs/018\.ipynb|
+            docs/020\.ipynb|
+            docs/026\.ipynb|
+            docs/027\.ipynb|
+            docs/028\.ipynb
+          )$
+
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.8
+    rev: v0.6.9
     hooks:
       - id: ruff
         args: [--fix]
@@ -66,7 +85,7 @@ repos:
         types_or: [python, pyi, jupyter]
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v5.0.0
     hooks:
       - id: check-ast
       - id: check-case-conflict
@@ -103,7 +122,7 @@ repos:
         exclude: (?x)^(.*/Manifest\.toml|.*/Project\.toml)$
 
   - repo: https://github.com/streetsidesoftware/cspell-cli
-    rev: v8.13.3
+    rev: v8.15.1
     hooks:
       - id: cspell
 
@@ -128,25 +147,6 @@ repos:
             docs/_static/favicon.ico
           )$
 
-  - repo: https://github.com/nbQA-dev/nbQA
-    rev: 1.8.7
-    hooks:
-      - id: nbqa-isort
-        args: [--float-to-top]
-        exclude: >-
-          (?x)^(
-            docs/001\.ipynb|
-            docs/002\.ipynb|
-            docs/003\.ipynb|
-            docs/008\.ipynb|
-            docs/013\.ipynb|
-            docs/018\.ipynb|
-            docs/020\.ipynb|
-            docs/026\.ipynb|
-            docs/027\.ipynb|
-            docs/028\.ipynb
-          )$
-
   - repo: local
     hooks:
       - id: pin-nb-requirements
@@ -159,7 +159,12 @@ repos:
         types:
           - jupyter
 
-  - repo: https://github.com/ComPWA/mirrors-pyright
-    rev: v1.1.382
+  - repo: https://github.com/ComPWA/pyright-pre-commit
+    rev: v1.1.385
     hooks:
       - id: pyright
+
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.4.22
+    hooks:
+      - id: uv-lock

.python-version

@@ -0,0 +1 @@
+3.12

.readthedocs.yml

@@ -1,22 +1,19 @@
 version: 2
 
-sphinx:
-  builder: html
-  configuration: docs/conf.py
-  fail_on_warning: true
-
-formats:
-  - htmlzip
-
 build:
-  os: ubuntu-22.04
-  apt_packages:
-    - graphviz
+  os: ubuntu-24.04
   tools:
     python: "3.12"
-  jobs:
-    pre_install:
-      - ./docs/install-julia-on-rtd.sh
-    post_install:
-      - python -m pip install 'uv>=0.2.0'
-      - python -m uv pip install -e .[doc]
+  commands:
+    - |-
+      export PIXI_HOME=$READTHEDOCS_VIRTUALENV_PATH
+      curl -fsSL https://pixi.sh/install.sh | bash
+      export UV_LINK_MODE=copy
+      pixi run \
+        uv run \
+          --extra doc \
+          --locked \
+          --with tox \
+          tox -e doc
+      mkdir -p $READTHEDOCS_OUTPUT
+      mv docs/_build/html $READTHEDOCS_OUTPUT