DX: use poe as task runner (#35)

* MAINT: implement autofixes from pre-commit
* MAINT: upgrade lock files

Author: pre-commit-ci[bot]

.github/workflows/cd.yml

@@ -9,9 +9,9 @@ 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
   package-name:
-    uses: ComPWA/actions/.github/workflows/get-pypi-name.yml@v2
+    uses: ComPWA/actions/.github/workflows/get-pypi-name.yml@v3
   pypi:
     environment:
       name: PyPI
@@ -24,9 +24,9 @@ jobs:
       id-token: write
     runs-on: ubuntu-24.04
     steps:
-      - uses: ComPWA/actions/build-pypi-distribution@v2
+      - uses: ComPWA/actions/build-pypi-distribution@v3
       - uses: pypa/gh-action-pypi-publish@release/v1
   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

@@ -28,4 +28,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

@@ -16,6 +16,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

@@ -41,7 +41,6 @@ prof/
 
 # Virtual environments
 *venv/
-.tox/
 pyvenv*/
 uv.lock
 

.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:
     - mypy
@@ -12,21 +13,21 @@ 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:
           - --repo-name=sphinx-api-relink
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.3
+    rev: v0.12.8
     hooks:
       - id: ruff
         args: [--fix]
       - id: ruff-format
 
   - 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
@@ -64,12 +65,12 @@ repos:
           - --in-place
 
   - 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
@@ -89,6 +90,6 @@ repos:
           - python
 
   - repo: https://github.com/ComPWA/pyright-pre-commit
-    rev: v1.1.392
+    rev: v1.1.403
     hooks:
       - id: pyright

.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

.vscode/settings.json

@@ -42,7 +42,6 @@
   "gitlens.telemetry.enabled": false,
   "multiDiffEditor.experimental.enabled": true,
   "mypy-type-checker.args": ["--config-file=${workspaceFolder}/pyproject.toml"],
-  "mypy-type-checker.importStrategy": "fromEnvironment",
   "notebook.codeActionsOnSave": {
     "notebook.source.organizeImports": "explicit"
   },

CONTRIBUTING.md

@@ -31,14 +31,14 @@ and [`pre-commit install`](https://pre-commit.com/#3-install-the-git-hook-script
 pre-commit install --install-hooks
 ```
 
-In addition, it may be handy to install `tox`:
+[Poe the Poet](https://poethepoet.natn.io) is used as a task runner. You can see which local CI checks it defines by running
 
 ```shell
-uv tool install tox --with tox-uv
+poe
 ```
 
-If the repository provides a Tox configuration under [`pyproject.toml`](./pyproject.toml), you can see which jobs it defines with:
+For instance, all style checks can be run with
 
 ```shell
-tox list
+poe style
 ```