MAINT: drop Python 3.8 support due to EOL (#365)

* DX: exclude `.constraints` dir from VS Code search
* DX: remove `python.analysis.typeCheckingMode` VS Code setting
* FIX: set correct Python version for GitLab CI
* MAINT: modernize Python syntax to Python 3.9
* MAINT: ignore links to PRD
* MAINT: update links to `TypeVar`

.gitlab-ci.yml

@@ -58,7 +58,7 @@ documentation:
   before_script:
     - apt-get update -y
     - apt-get install -y cm-super dvipng inkscape latexmk texlive-fonts-extra texlive-latex-extra texlive-xetex xindy
-    - python3 -m pip install .[doc] tox -c .constraints/py3.8.txt
+    - python3 -m pip install .[doc] tox -c .constraints/py3.9.txt
     - version=$(sed -n '3p' julia/Manifest.toml)
     - version=${version:17:-1}
     - major_version=${version:0:-2}

.vscode/settings.json

@@ -55,7 +55,6 @@
   "notebook.gotoSymbols.showAllSymbols": true,
   "python.analysis.autoImportCompletions": false,
   "python.analysis.inlayHints.pytestParameters": true,
-  "python.analysis.typeCheckingMode": "strict",
   "python.terminal.activateEnvironment": false,
   "python.testing.pytestArgs": ["--color=no"],
   "python.testing.pytestEnabled": true,
@@ -65,6 +64,9 @@
   "ruff.enable": true,
   "ruff.importStrategy": "fromEnvironment",
   "ruff.organizeImports": true,
+  "search.exclude": {
+    "**/.constraints/py*.txt": true
+  },
   "telemetry.telemetryLevel": "off",
   "yaml.schemas": {
     "https://citation-file-format.github.io/1.2.0/schema.json": "CITATION.cff",

docs/appendix/widget.ipynb

@@ -31,7 +31,7 @@
     "\n",
     "import logging\n",
     "import os\n",
-    "from functools import lru_cache\n",
+    "from functools import cache\n",
     "from textwrap import dedent\n",
     "from warnings import filterwarnings\n",
     "\n",
@@ -170,7 +170,7 @@
     "FIXED_PARAMETERS = {s: v for s, v in PARAMETERS.items() if s not in FREE_PARAMETERS}\n",
     "\n",
     "\n",
-    "@lru_cache(maxsize=None)\n",
+    "@cache\n",
     "def unfold_and_substitute(expr: sp.Expr, reference_subsystem: int = 1) -> sp.Expr:\n",
     "    expr = perform_cached_doit(expr)\n",
     "    expr = perform_cached_doit(expr.xreplace(MODELS[reference_subsystem].amplitudes))\n",

docs/conf.py

@@ -231,6 +231,7 @@ def print(self) -> None:
 add_module_names = False
 api_github_repo = f"{ORGANIZATION}/{REPO_NAME}"
 api_target_substitutions = {
+    "_T": "typing.TypeVar",
     "AmplitudeModel": "ampform_dpd.AmplitudeModel",
     "Artist": "matplotlib.artist.Artist",
     "Axes": "matplotlib.axes.Axes",
@@ -255,7 +256,6 @@ def print(self) -> None:
     "Particle": "ampform_dpd.decay.Particle",
     "Path": "pathlib.Path",
     "Pattern": "typing.Pattern",
-    "polarimetry.lhcb._T": "typing.TypeVar",
     "PoolSum": "ampform.sympy.PoolSum",
     "PositionalArgumentFunction": "tensorwaves.function.PositionalArgumentFunction",
     "QuadContourSet": "matplotlib.contour.QuadContourSet",
@@ -443,9 +443,13 @@ def print(self) -> None:
 }
 latex_engine = "xelatex"  # https://tex.stackexchange.com/a/570691
 latex_show_pagerefs = True
+linkcheck_anchors_ignore_for_url = [
+    "https://github.com/ComPWA/polarimetry/issues",
+]
 linkcheck_ignore = [
     "https://arxiv.org/pdf/2208.03262.pdf",
     "https://arxiv.org/pdf/hep-ex/0510019.pdf",
+    "https://doi.org/10.1103/PhysRevD.101.034033",
     "https://journals.aps.org/prd/pdf/10.1103/PhysRevD.101.034033",
     "https://www.bookfinder.com",
 ]

docs/cross-check.ipynb

@@ -32,7 +32,7 @@
     "import json\n",
     "import logging\n",
     "import os\n",
-    "from functools import lru_cache\n",
+    "from functools import cache\n",
     "from textwrap import dedent\n",
     "\n",
     "import numpy as np\n",
@@ -55,7 +55,7 @@
     "from polarimetry.lhcb.particle import load_particles\n",
     "\n",
     "\n",
-    "@lru_cache(maxsize=None)\n",
+    "@cache\n",
     "def load_model_cached(model_id: int | str) -> AmplitudeModel:\n",
     "    return load_model(MODEL_FILE, PARTICLES, model_id)\n",
     "\n",
@@ -265,7 +265,7 @@
    },
    "outputs": [],
    "source": [
-    "@lru_cache(maxsize=None)\n",
+    "@cache\n",
     "def create_amplitude_functions(\n",
     "    model_id: int | str,\n",
     ") -> dict[tuple[sp.Rational, sp.Rational], sp.Expr]:\n",
@@ -287,7 +287,7 @@
     "    }\n",
     "\n",
     "\n",
-    "@lru_cache(maxsize=None)\n",
+    "@cache\n",
     "def formulate_amplitude_expressions(\n",
     "    model_id: int | str,\n",
     ") -> dict[tuple[sp.Rational, sp.Rational], sp.Expr]:\n",
@@ -305,7 +305,7 @@
     "    }\n",
     "\n",
     "\n",
-    "@lru_cache(maxsize=None)\n",
+    "@cache\n",
     "def get_production_couplings(model_id: int | str) -> dict[sp.Indexed, complex]:\n",
     "    model = load_model(MODEL_FILE, PARTICLES, model_id)\n",
     "    return {\n",

docs/resonance-polarimetry.ipynb

@@ -37,7 +37,7 @@
     "import logging\n",
     "import os\n",
     "from collections import defaultdict\n",
-    "from functools import lru_cache\n",
+    "from functools import cache\n",
     "from math import ceil, sqrt\n",
     "from textwrap import dedent, wrap\n",
     "from typing import Literal\n",
@@ -86,7 +86,7 @@
     "    logging.getLogger(\"polarimetry.io\").setLevel(logging.ERROR)\n",
     "\n",
     "\n",
-    "@lru_cache(maxsize=None)\n",
+    "@cache\n",
     "def doit(expr: PoolSum) -> sp.Expr:\n",
     "    return perform_cached_doit(expr)"
    ]

pyproject.toml

@@ -22,7 +22,6 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
-    "Programming Language :: Python :: 3.8",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python",
     "Topic :: Scientific/Engineering :: Physics",
@@ -45,7 +44,7 @@ description = "Symbolic expressions that describe an aligned polarimeter vector
 dynamic = ["version"]
 license = {file = "LICENSE"}
 name = "polarimetry-lc2pkpi"
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 
 [project.optional-dependencies]
 dev = [
@@ -221,7 +220,7 @@ src = [
     "src",
     "tests",
 ]
-target-version = "py38"
+target-version = "py39"
 
 [tool.ruff.format]
 docstring-code-format = true