BREAK: drop support for Python 3.9 (#323)

* DX: define Poe the Poet `lab` job for Jupyter lab
* MAINT: upgrade Jupyter notebook kernels

Author: redeboer

docs/_extend_docstrings.py

@@ -9,10 +9,13 @@
 import inspect
 import logging
 import textwrap
-from typing import Callable
+from typing import TYPE_CHECKING
 
 import qrules
 
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
 logging.getLogger().setLevel(logging.ERROR)
 
 

docs/usage.ipynb

@@ -277,7 +277,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.9.18"
+   "version": "3.13.8"
   }
  },
  "nbformat": 4,

docs/usage/conservation.ipynb

@@ -417,7 +417,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.11.7"
+   "version": "3.13.8"
   }
  },
  "nbformat": 4,

docs/usage/custom-topology.ipynb

@@ -290,6 +290,18 @@
    "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.13.8"
   }
  },
  "nbformat": 4,

docs/usage/ls-coupling.ipynb

@@ -336,6 +336,18 @@
    "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.13.8"
   }
  },
  "nbformat": 4,

docs/usage/particle.ipynb

@@ -467,6 +467,18 @@
    "display_name": "Python 3 (ipykernel)",
    "language": "python",
    "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.13.8"
   }
  },
  "nbformat": 4,

docs/usage/reaction.ipynb

@@ -620,7 +620,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.11"
+   "version": "3.13.8"
   }
  },
  "nbformat": 4,

docs/usage/visualize.ipynb

@@ -792,7 +792,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.12.8"
+   "version": "3.13.8"
   }
  },
  "nbformat": 4,

pyproject.toml

@@ -20,7 +20,6 @@ classifiers = [
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
-    "Programming Language :: Python :: 3.9",
     "Programming Language :: Python",
     "Topic :: Scientific/Engineering :: Physics",
     "Topic :: Scientific/Engineering",
@@ -49,7 +48,7 @@ keywords = [
 license = {file = "LICENSE"}
 maintainers = [{email = "[email protected]"}]
 name = "qrules"
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 
 [project.optional-dependencies]
 viz = ["graphviz"]
@@ -303,6 +302,11 @@ env = {EXECUTE_NB = "yes"}
 help = "Set up a server to directly preview changes to the HTML pages with cached notebook execution"
 sequence = ["doclive"]
 
+[tool.poe.tasks.lab]
+args = [{name = "paths", default = "", positional = true}]
+cmd = "jupyter lab ${paths}"
+help = "Run Jupyter Lab"
+
 [tool.poe.tasks.linkcheck]
 cmd = """
 uv run --group doc --isolated --no-dev \

src/qrules/argument_handling.py

@@ -9,7 +9,7 @@
 
 import inspect
 from fractions import Fraction
-from typing import TYPE_CHECKING, Any, Callable, Generic, TypeVar, Union
+from typing import TYPE_CHECKING, Any, Generic, TypeVar, Union
 
 import attrs
 
@@ -21,11 +21,10 @@
 from qrules.quantum_numbers import EdgeQuantumNumber, NodeQuantumNumber, Parity
 
 if TYPE_CHECKING:
-    from collections.abc import Sequence
+    from collections.abc import Callable, Sequence
 
-Scalar = Union[int, float, Fraction]
-
-Rule = Union[GraphElementRule, EdgeQNConservationRule, ConservationRule]
+Scalar = int | float | Fraction
+Rule = GraphElementRule | EdgeQNConservationRule | ConservationRule
 """Any type of rule"""
 
 _ElementType = TypeVar("_ElementType")
@@ -95,7 +94,7 @@ def wrapper(states_list: Sequence[Any]) -> bool:
 
 def _check_all_arguments(checks: list[Callable]) -> Callable[..., bool]:
     def wrapper(*args: Any) -> bool:
-        return all(check(arg) for check, arg in zip(checks, args))
+        return all(check(arg) for check, arg in zip(checks, args, strict=False))
 
     return wrapper
 
@@ -171,7 +170,7 @@ def wrapper(states_list: Sequence[Any]) -> list[Any]:
 
 def _build_all_arguments(checks: list[Callable]) -> Callable:
     def wrapper(*args: Any) -> list[Any]:
-        return [check(arg) for check, arg in zip(checks, args) if arg]
+        return [check(arg) for check, arg in zip(checks, args, strict=False) if arg]
 
     return wrapper