DX: replace tox with poethepoet

Author: redeboer

.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

@@ -14,7 +14,7 @@ repos:
       - id: check-useless-excludes
 
   - repo: https://github.com/ComPWA/policy
-    rev: 0.6.5
+    rev: 67a41477b9ccb7b8910224a2374c35745c4612aa
     hooks:
       - id: check-dev-files
         args:

.readthedocs.yml

@@ -11,12 +11,11 @@ build:
       pixi global install graphviz uv
     - |-
       export UV_LINK_MODE=copy
-      export UV_TOOL_BIN_DIR=$READTHEDOCS_VIRTUALENV_PATH/bin
-      uv tool install --with tox-uv tox
       uv run \
         --group doc \
         --no-dev \
-        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

CONTRIBUTING.md

@@ -31,14 +31,8 @@ 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`:
+If the repository provides a [`[tool.poe.tasks]`](https://poethepoet.natn.io) configuration under [`pyproject.toml`](./pyproject.toml), you can see which jobs it defines with:
 
 ```shell
-uv tool install tox --with tox-uv
-```
-
-If the repository provides a Tox configuration under [`pyproject.toml`](./pyproject.toml), you can see which jobs it defines with:
-
-```shell
-tox list
+poe
 ```