DX: switch to poe as task runner (#306)

* DOC: update developer instructions
* DX: open browser after running `doclive`
* MAINT: update developer configuration
* MAINT: upgrade lock files

Author: pre-commit-ci[bot]

.cspell.json

@@ -96,10 +96,10 @@
     "helicity",
     "lambdify",
     "Mathematica",
-    "Miniconda",
     "Numba",
     "NumPy",
     "parametrizations",
+    "Pixi",
     "PyPA",
     "PyPI",
     "pytest",

.github/workflows/cd.yml

@@ -9,8 +9,8 @@ on:
 jobs:
   milestone:
     if: startsWith(github.ref, 'refs/tags')
-    uses: ComPWA/actions/.github/workflows/close-milestone.yml@v2
+    uses: ComPWA/actions/.github/workflows/close-milestone.yml@v3
   push:
     if: startsWith(github.ref, 'refs/tags') && !github.event.release.prerelease
     secrets: inherit
-    uses: ComPWA/actions/.github/workflows/push-to-version-branches.yml@v2
+    uses: ComPWA/actions/.github/workflows/push-to-version-branches.yml@v3

.github/workflows/ci.yml

@@ -25,7 +25,7 @@ on:
 
 jobs:
   doc:
-    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v2.1
+    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v3.0
     permissions:
       pages: write
       id-token: write
@@ -37,4 +37,4 @@ jobs:
     if: inputs.specific-pip-packages == ''
     secrets:
       token: ${{ secrets.PAT }}
-    uses: ComPWA/actions/.github/workflows/pre-commit.yml@v2.1
+    uses: ComPWA/actions/.github/workflows/pre-commit.yml@v3.0

.github/workflows/clean-caches.yml

@@ -16,7 +16,7 @@ jobs:
     name: Remove caches
     runs-on: ubuntu-24.04
     steps:
-      - uses: ComPWA/actions/clean-caches@v2
+      - uses: ComPWA/actions/clean-caches@v3
         with:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ref: ${{ inputs.ref }}

.github/workflows/lock.yml

@@ -17,6 +17,6 @@ on:
 
 jobs:
   lock:
-    uses: ComPWA/actions/.github/workflows/lock.yml@v2
+    uses: ComPWA/actions/.github/workflows/lock.yml@v3
     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@v2
+    uses: ComPWA/actions/.github/workflows/pr-linting.yml@v3

.gitignore

@@ -35,7 +35,6 @@ prof/
 
 # Virtual environments
 *venv/
-.tox/
 pyvenv*/
 
 # Settings

.pre-commit-config.yaml

@@ -1,5 +1,6 @@
 ci:
-  autoupdate_commit_msg: "MAINT: update lock files"
+  autofix_commit_msg: "MAINT: implement pre-commit autofixes"
+  autoupdate_commit_msg: "MAINT: upgrade lock files"
   autoupdate_schedule: quarterly
   skip:
     - check-jsonschema
@@ -13,7 +14,7 @@ repos:
       - id: check-useless-excludes
 
   - repo: https://github.com/ComPWA/policy
-    rev: 0.6.1
+    rev: 0.7.0
     hooks:
       - id: check-dev-files
         args:
@@ -57,7 +58,7 @@ repos:
             metadata.vscode
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.3
+    rev: v0.12.8
     hooks:
       - id: ruff
         args: [--fix]
@@ -66,7 +67,7 @@ repos:
         types_or: [python, pyi, jupyter]
 
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v5.0.0
+    rev: v6.0.0
     hooks:
       - id: check-ast
       - id: check-case-conflict
@@ -107,7 +108,7 @@ repos:
         args: [--in-place]
 
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.31.0
+    rev: 0.33.2
     hooks:
       - id: check-jsonschema
         name: Check CITATION.cff
@@ -120,12 +121,12 @@ repos:
         pass_filenames: false
 
   - repo: https://github.com/streetsidesoftware/cspell-cli
-    rev: v8.17.1
+    rev: v9.2.0
     hooks:
       - id: cspell
 
   - repo: https://github.com/editorconfig-checker/editorconfig-checker.python
-    rev: 3.2.0
+    rev: 3.2.1
     hooks:
       - id: editorconfig-checker
         name: editorconfig
@@ -146,11 +147,11 @@ repos:
           )$
 
   - repo: https://github.com/ComPWA/pyright-pre-commit
-    rev: v1.1.392
+    rev: v1.1.403
     hooks:
       - id: pyright
 
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.5.25
+    rev: 0.8.8
     hooks:
       - id: uv-lock

.readthedocs.yml

@@ -14,8 +14,8 @@ build:
       uv run \
         --group doc \
         --no-dev \
-        --with tox-uv \
-        tox -e doc
+        --with poethepoet \
+        poe doc
       mkdir -p $READTHEDOCS_OUTPUT
       mv docs/_build/html $READTHEDOCS_OUTPUT
 

.taplo.toml

@@ -13,7 +13,7 @@ reorder_keys = true
 
 [[rule]]
 include = ["**/pyproject.toml"]
-keys = ["tool.tox"]
+keys = ["tool.poe.tasks"]
 
 [rule.formatting]
 reorder_arrays = false