[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

Author: pre-commit-ci[bot]

.binder/postBuild

@@ -3,10 +3,10 @@ set -ex
 curl -LsSf https://astral.sh/uv/install.sh | sh
 source $HOME/.cargo/env
 uv export \
-  --extra jupyter \
-  --extra notebooks \
+  --no-dev \
   > requirements.txt
 uv pip install \
   --requirement requirements.txt \
   --system
+rm requirements.txt
 uv cache clean

.cspell.json

@@ -113,5 +113,6 @@
     "toprettyxml",
     "unsrt",
     "venv"
-  ]
+  ],
+  "useGitignore": true
 }

.github/workflows/ci.yml

@@ -5,9 +5,6 @@ concurrency:
   cancel-in-progress: |-
     ${{ github.ref != format('refs/heads/{0}', github.event.repository.default_branch) }}
 
-env:
-  PYTHONHASHSEED: "0"
-
 on:
   push:
     branches:
@@ -28,7 +25,7 @@ on:
 
 jobs:
   doc:
-    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v2
+    uses: ComPWA/actions/.github/workflows/ci-docs.yml@v2.1
     permissions:
       pages: write
       id-token: write
@@ -40,4 +37,4 @@ jobs:
     if: inputs.specific-pip-packages == ''
     secrets:
       token: ${{ secrets.PAT }}
-    uses: ComPWA/actions/.github/workflows/pre-commit.yml@v2
+    uses: ComPWA/actions/.github/workflows/pre-commit.yml@v2.1

.readthedocs.yml

@@ -11,7 +11,11 @@ build:
       pixi global install graphviz uv
     - |-
       export UV_LINK_MODE=copy
-      uv run --extra doc --locked --with tox \
+      uv run \
+        --group doc \
+        --locked \
+        --no-dev \
+        --with tox \
         tox -e doc
       mkdir -p $READTHEDOCS_OUTPUT
       mv docs/_build/html $READTHEDOCS_OUTPUT

CONTRIBUTING.md

@@ -15,12 +15,30 @@ cd compwa.github.io
 Now it's simply a matter of creating and activating the [virtual environment](https://docs.astral.sh/uv/pip/environments) with [`uv sync`](https://docs.astral.sh/uv/reference/cli/#uv-sync). The dependencies for the project are 'pinned' in each commit through the [`uv.lock` file](https://docs.astral.sh/uv/concepts/projects/#project-lockfile).
 
 ```shell
-uv sync
+uv sync --all-extras
 source .venv/bin/activate
 ```
 
-Formatting and linting checks are automatically performed when committing changes. This is done with [pre-commit](https://pre-commit.com). To install the hooks in your local repository, run [`pre-commit install`](https://pre-commit.com/#3-install-the-git-hook-scripts) **once**:
+Formatting and linting checks are automatically performed when committing changes. This is done with [pre-commit](https://pre-commit.com). To install the hooks in your local repository, run install `pre-commit` with `uv`:
+
+```shell
+uv tool install pre-commit --with pre-commit-uv --force-reinstall
+```
+
+and [`pre-commit install`](https://pre-commit.com/#3-install-the-git-hook-scripts) **once**:
 
 ```shell
 pre-commit install --install-hooks
 ```
+
+In addition, it may be handy to install `tox`:
+
+```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
+```

docs/adr/002/composition.ipynb

@@ -190,7 +190,7 @@
     ") -> DynamicsExpression:\n",
     "    edge_ids = determine_attached_final_state(graph, edge_id)\n",
     "    final_state_ids = map(str, edge_ids)\n",
-    "    mass = sp.Symbol(f\"m_{{{\"+\".join(final_state_ids)}}}\")\n",
+    "    mass = sp.Symbol(f\"m_{{{'+'.join(final_state_ids)}}}\")\n",
     "    particle, _ = graph.get_edge_props(edge_id)\n",
     "    mass0 = sp.Symbol(f\"m_{{{particle.latex}}}\")\n",
     "    gamma0 = sp.Symbol(Rf\"\\Gamma_{{{particle.latex}}}\")\n",
@@ -212,7 +212,7 @@
     ") -> DynamicsExpression:\n",
     "    edge_ids = determine_attached_final_state(graph, edge_id)\n",
     "    final_state_ids = map(str, edge_ids)\n",
-    "    mass = sp.Symbol(f\"m_{{{\"+\".join(final_state_ids)}}}\")\n",
+    "    mass = sp.Symbol(f\"m_{{{'+'.join(final_state_ids)}}}\")\n",
     "    particle, _ = graph.get_edge_props(edge_id)\n",
     "    mass0 = sp.Symbol(f\"m_{{{particle.latex}}}\")\n",
     "    gamma0 = sp.Symbol(Rf\"\\Gamma_{{{particle.latex}}}\")\n",

docs/adr/002/expr.ipynb

@@ -162,7 +162,7 @@
     "    ) -> RelativisticBreitWigner:\n",
     "        edge_ids = determine_attached_final_state(graph, edge_id)\n",
     "        final_state_ids = map(str, edge_ids)\n",
-    "        mass = sp.Symbol(f\"m_{{{\"+\".join(final_state_ids)}}}\")\n",
+    "        mass = sp.Symbol(f\"m_{{{'+'.join(final_state_ids)}}}\")\n",
     "        particle, _ = graph.get_edge_props(edge_id)\n",
     "        mass0 = sp.Symbol(f\"m_{{{particle.latex}}}\")\n",
     "        gamma0 = sp.Symbol(Rf\"\\Gamma_{{{particle.latex}}}\")\n",
@@ -247,7 +247,7 @@
     "    ) -> RelativisticBreitWignerWithFF:\n",
     "        edge_ids = determine_attached_final_state(graph, edge_id)\n",
     "        final_state_ids = map(str, edge_ids)\n",
-    "        mass = sp.Symbol(f\"m_{{{\"+\".join(final_state_ids)}}}\")\n",
+    "        mass = sp.Symbol(f\"m_{{{'+'.join(final_state_ids)}}}\")\n",
     "        particle, _ = graph.get_edge_props(edge_id)\n",
     "        mass0 = sp.Symbol(f\"m_{{{particle.latex}}}\")\n",
     "        gamma0 = sp.Symbol(Rf\"\\Gamma_{{{particle.latex}}}\")\n",
@@ -459,7 +459,7 @@
     "    ) -> RelativisticBreitWigner:\n",
     "        edge_ids = determine_attached_final_state(graph, edge_id)\n",
     "        final_state_ids = map(str, edge_ids)\n",
-    "        mass = sp.Symbol(f\"m_{{{\"+\".join(final_state_ids)}}}\")\n",
+    "        mass = sp.Symbol(f\"m_{{{'+'.join(final_state_ids)}}}\")\n",
     "        particle, _ = graph.get_edge_props(edge_id)\n",
     "        mass0 = sp.Symbol(Rf\"\\mu_{{{particle.latex}}}\")\n",
     "        gamma0 = sp.Symbol(Rf\"\\sigma_{{{particle.latex}}}\")\n",

docs/adr/002/function.ipynb

@@ -111,7 +111,7 @@
     "    ) -> \"RelativisticBreitWigner\":\n",
     "        edge_ids = determine_attached_final_state(graph, edge_id)\n",
     "        final_state_ids = map(str, edge_ids)\n",
-    "        mass = sp.Symbol(f\"m_{{{\"+\".join(final_state_ids)}}}\")\n",
+    "        mass = sp.Symbol(f\"m_{{{'+'.join(final_state_ids)}}}\")\n",
     "        particle, _ = graph.get_edge_props(edge_id)\n",
     "        mass0 = sp.Symbol(f\"m_{{{particle.latex}}}\")\n",
     "        gamma0 = sp.Symbol(Rf\"\\Gamma_{{{particle.latex}}}\")\n",
@@ -159,7 +159,7 @@
     "    ) -> \"RelativisticBreitWignerWithFF\":\n",
     "        edge_ids = determine_attached_final_state(graph, edge_id)\n",
     "        final_state_ids = map(str, edge_ids)\n",
-    "        mass = sp.Symbol(f\"m_{{{\"+\".join(final_state_ids)}}}\")\n",
+    "        mass = sp.Symbol(f\"m_{{{'+'.join(final_state_ids)}}}\")\n",
     "        particle, _ = graph.get_edge_props(edge_id)\n",
     "        mass0 = sp.Symbol(f\"m_{{{particle.latex}}}\")\n",
     "        gamma0 = sp.Symbol(Rf\"\\Gamma_{{{particle.latex}}}\")\n",

docs/conf.py

@@ -129,14 +129,14 @@
 html_title = "Common Partial Wave Analysis Project"
 intersphinx_mapping = {
     "ampform": ("https://ampform.readthedocs.io/stable", None),
-    "attrs": (f"https://www.attrs.org/en/{pin("attrs")}", None),
+    "attrs": (f"https://www.attrs.org/en/{pin('attrs')}", None),
     "expertsystem": ("https://expertsystem.readthedocs.io/stable", None),
     "graphviz": ("https://graphviz.readthedocs.io/en/stable", None),
-    "IPython": (f"https://ipython.readthedocs.io/en/{pin("IPython")}", None),
+    "IPython": (f"https://ipython.readthedocs.io/en/{pin('IPython')}", None),
     "jax": ("https://jax.readthedocs.io/en/latest", None),
-    "matplotlib": (f"https://matplotlib.org/{pin("matplotlib")}", None),
-    "numba": (f"https://numba.readthedocs.io/en/{pin("numba")}", None),
-    "numpy": (f"https://numpy.org/doc/{pin_minor("numpy")}", None),
+    "matplotlib": (f"https://matplotlib.org/{pin('matplotlib')}", None),
+    "numba": (f"https://numba.readthedocs.io/en/{pin('numba')}", None),
+    "numpy": (f"https://numpy.org/doc/{pin_minor('numpy')}", None),
     "pwa": ("https://pwa.readthedocs.io", None),
     "python": ("https://docs.python.org/3", None),
     "qrules": ("https://qrules.readthedocs.io/stable", None),

pyproject.toml

@@ -14,16 +14,25 @@ maintainers = [{email = "compwa-admin@ep1.rub.de"}]
 name = "compwa-github-io"
 requires-python = ">=3.12"
 
-[project.optional-dependencies]
+[project.readme]
+content-type = "text/markdown"
+file = "README.md"
+
+[project.urls]
+Documentation = "https://compwa.github.io"
+Source = "https://github.com/ComPWA/compwa.github.io"
+Tracker = "https://github.com/ComPWA/compwa.github.io/issues"
+
+[dependency-groups]
 dev = [
-    "compwa-github-io[doc]",
-    "compwa-github-io[jupyter]",
-    "compwa-github-io[sty]",
-    "compwa-github-io[test]",
+    "ruff",
     "sphinx-autobuild",
+    {include-group = "doc"},
+    {include-group = "jupyter"},
+    {include-group = "style"},
+    {include-group = "test"},
 ]
 doc = [
-    "compwa-github-io[notebooks]",
     "myst-nb",
     "sphinx",
     "sphinx-api-relink",
@@ -39,45 +48,34 @@ doc = [
     "sphinx-thebe",
     "sphinx-togglebutton",
     "sphinxcontrib-bibtex >=2",
+    {include-group = "notebooks"},
 ]
 jupyter = [
-    "compwa-github-io[notebooks]",
     "jupyterlab",
     "jupyterlab-code-formatter >=3.0.0",
     "jupyterlab-git",
     "jupyterlab-lsp",
     "jupyterlab-myst",
     "python-lsp-ruff",
     "python-lsp-server[rope]",
+    {include-group = "notebooks"},
 ]
 notebooks = [
     "black",
     "graphviz",
     "numpy",
     "sympy",
 ]
-sty = [
+style = [
     "attrs",
-    "compwa-github-io[types]",
     "nbformat",
-    "ruff",
+    {include-group = "types"},
 ]
 test = [
     "jupyter",
     "nbmake",
 ]
-types = [
-    "sphinx-api-relink",
-]
-
-[project.readme]
-content-type = "text/markdown"
-file = "README.md"
-
-[project.urls]
-Documentation = "https://compwa.github.io"
-Source = "https://github.com/ComPWA/compwa.github.io"
-Tracker = "https://github.com/ComPWA/compwa.github.io/issues"
+types = ["sphinx-api-relink"]
 
 [tool.setuptools]
 include-package-data = false
@@ -243,7 +241,7 @@ split-on-trailing-comma = false
     "S101",
     "S307",
     "T20",
-    "TCH00",
+    "TC00",
 ]
 "**/003.ipynb" = ["B023", "PLC2701"]
 "**/009.ipynb" = ["FURB113"]