FIX: fix is_integer() bug for QRules v0.10.4

.pre-commit-config.yaml

@@ -14,7 +14,7 @@ repos:
       - id: check-useless-excludes
 
   - repo: https://github.com/ComPWA/policy
-    rev: 0.5.15
+    rev: 0.5.18
     hooks:
       - id: check-dev-files
         args:
@@ -30,6 +30,7 @@ repos:
           - --add-install-cell
           - --additional-packages=IPython
           - --extras-require=doc,viz
+      - id: set-nb-display-name
 
   - repo: https://github.com/kynan/nbstripout
     rev: 0.8.1
@@ -60,7 +61,7 @@ repos:
             metadata.vscode
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.9.1
+    rev: v0.9.2
     hooks:
       - id: ruff
         args: [--fix]
@@ -127,12 +128,12 @@ repos:
         pass_filenames: false
 
   - repo: https://github.com/streetsidesoftware/cspell-cli
-    rev: v8.17.0
+    rev: v8.17.1
     hooks:
       - id: cspell
 
   - repo: https://github.com/editorconfig-checker/editorconfig-checker.python
-    rev: 3.0.3
+    rev: 3.1.2
     hooks:
       - id: editorconfig-checker
         name: editorconfig
@@ -153,11 +154,11 @@ repos:
           - python
 
   - repo: https://github.com/ComPWA/pyright-pre-commit
-    rev: v1.1.391
+    rev: v1.1.392
     hooks:
       - id: pyright
 
   - repo: https://github.com/astral-sh/uv-pre-commit
-    rev: 0.5.18
+    rev: 0.5.22
     hooks:
       - id: uv-lock

.readthedocs.yml

@@ -14,7 +14,7 @@ build:
       uv run \
         --group doc \
         --no-dev \
-        --with tox \
+        --with tox-uv \
         tox -e doc
       mkdir -p $READTHEDOCS_OUTPUT
       mv docs/_build/html $READTHEDOCS_OUTPUT

pyproject.toml

@@ -18,6 +18,7 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.9",
     "Programming Language :: Python",
     "Topic :: Scientific/Engineering :: Physics",
@@ -141,10 +142,13 @@ namespaces = false
 where = ["src"]
 
 [tool.setuptools_scm]
-local_scheme = "no-local-version"
-version_scheme = "only-version"
 write_to = "src/ampform/version.py"
 
+[tool.coverage.report]
+exclude_also = [
+    "if TYPE_CHECKING:",
+]
+
 [tool.coverage.run]
 branch = true
 source = ["src"]
@@ -436,6 +440,11 @@ trailing_comma_inline_array = true
 
 [tool.tox]
 env_list = [
+    "3.9",
+    "3.10",
+    "3.11",
+    "3.12",
+    "3.13",
     "bench",
     "cov",
     "docnb-force",
@@ -448,13 +457,16 @@ skip_install = true
 skip_missing_interpreters = true
 
 [tool.tox.env_run_base]
-allowlist_externals = ["pytest"]
 commands = [["pytest", {replace = "posargs", extend = true}]]
-description = "Run all unit tests"
+dependency_groups = ["test"]
+description = "Run test suite on Python {env_name}"
+no_package = false
 pass_env = ["*"]
+runner = "uv-venv-lock-runner"
+skip_install = false
+skip_missing_interpreters = false
 
 [tool.tox.env.bench]
-allowlist_externals = ["pytest"]
 commands = [
     [
         "pytest",
@@ -468,7 +480,6 @@ commands = [
 description = "Run benchmark tests and visualize in histogram"
 
 [tool.tox.env.cov]
-allowlist_externals = ["pytest"]
 commands = [
     [
         "pytest",
@@ -483,6 +494,7 @@ description = "Compute test coverage"
 
 [tool.tox.env.doc]
 allowlist_externals = ["sphinx-build"]
+base = []
 commands = [
     [
         "sphinx-build",
@@ -499,6 +511,7 @@ set_env.PYTHONWARNINGS = ""
 
 [tool.tox.env.doclive]
 allowlist_externals = ["sphinx-autobuild"]
+base = []
 commands = [
     [
         "sphinx-autobuild",
@@ -531,31 +544,31 @@ commands = [
 description = "Set up a server to directly preview changes to the HTML pages"
 
 [tool.tox.env.docnb]
-base = ["tool.tox.env.doc", "tool.tox.env_run_base"]
+base = ["tool.tox.env.doc"]
 description = "{[tool.tox.env.doc]description} with cached notebook execution"
 set_env = [
     {replace = "ref", of = ["tool.tox.env.doc.set_env"]},
     {EXECUTE_NB = "yes"},
 ]
 
 [tool.tox.env.docnb-force]
-base = ["tool.tox.env.doc", "tool.tox.env_run_base"]
+base = ["tool.tox.env.doc"]
 description = "{[tool.tox.env.doc]description} with notebook execution (no cache)"
 set_env = [
     {replace = "ref", of = ["tool.tox.env.doc.set_env"]},
     {FORCE_EXECUTE_NB = "yes"},
 ]
 
 [tool.tox.env.docnblive]
-base = ["tool.tox.env.doclive", "tool.tox.env_run_base"]
+base = ["tool.tox.env.doclive"]
 description = "{[tool.tox.env.doclive]description} with cached notebook execution"
 set_env = [
     {replace = "ref", of = ["tool.tox.env.doclive.set_env"]},
     {EXECUTE_NB = "yes"},
 ]
 
 [tool.tox.env.linkcheck]
-allowlist_externals = ["sphinx-build"]
+base = ["tool.tox.env.doc"]
 commands = [
     [
         "sphinx-build",
@@ -569,17 +582,25 @@ description = "Check external links in the documentation (requires internet conn
 
 [tool.tox.env.nb]
 allowlist_externals = ["pytest"]
+base = []
 commands = [["pytest", "--nbmake", "{posargs:docs}"]]
 description = "Run all notebooks with pytest"
 
 [tool.tox.env.sty]
 allowlist_externals = ["pre-commit"]
+base = []
 commands = [["pre-commit", "run", "--all-files", {replace = "posargs", extend = true}]]
 description = "Perform all linting, formatting, and spelling checks"
 
-[tool.uv]
-constraint-dependencies = [
-    "pygments!=2.19.*", # https://github.com/felix-hilden/sphinx-codeautolink/issues/152
-    "pytest-profiling!=1.8.0",
-    "sphinx-codeautolink!=0.16.0",
+[tool.tox.labels]
+doc = [
+    "docnb-force",
+    "linkcheck",
+]
+test = [
+    "3.9",
+    "3.10",
+    "3.11",
+    "3.12",
+    "3.13",
 ]

src/ampform/helicity/__init__.py

@@ -13,6 +13,7 @@
 import sys
 import warnings
 from collections import OrderedDict, abc
+from fractions import Fraction
 from functools import reduce, singledispatchmethod
 from typing import TYPE_CHECKING, Union
 
@@ -928,13 +929,21 @@
 def _generate_kinematic_variable_set(
     transition: StateTransition, node_id: int
 ) -> TwoBodyKinematicVariableSet:
+    def is_integer(spin: float | Fraction) -> bool:
+        if isinstance(spin, float):
+            return spin.is_integer()
+        if isinstance(spin, Fraction):
+            return spin.denominator == 1
+        msg = "spin has to of type float (qrules 0.9) or Fraction (qrules >= 0.10)"
+        raise TypeError(msg)
+
     decay = TwoBodyDecay.from_transition(transition, node_id)
     inv_mass, phi, theta = _generate_kinematic_variables(transition, node_id)
     topology = transition.topology
     child1_mass = get_invariant_mass_symbol(topology, decay.children[0].id)
     child2_mass = get_invariant_mass_symbol(topology, decay.children[1].id)
     angular_momentum: int | None = decay.interaction.l_magnitude
-    if angular_momentum is None and decay.parent.particle.spin.is_integer():
+    if angular_momentum is None and is_integer(decay.parent.particle.spin):
         angular_momentum = int(decay.parent.particle.spin)
     return TwoBodyKinematicVariableSet(
         incoming_state_mass=inv_mass,

src/ampform/sympy/_cache.py

@@ -48,6 +48,6 @@ def get_readable_hash(obj) -> str:
 
 
 def to_bytes(obj) -> bytes:
-    if isinstance(obj, bytes | bytearray):
+    if isinstance(obj, (bytes, bytearray)):
         return obj
     return pickle.dumps(obj, protocol=pickle.HIGHEST_PROTOCOL)

tests/sympy/test_cache.py

@@ -2,6 +2,7 @@
 
 import logging
 import os
+import sys
 from typing import TYPE_CHECKING, ClassVar
 
 import pytest
@@ -18,7 +19,7 @@
     from qrules.transition import SpinFormalism
 
 
-_GH = "CI" in os.environ and os.uname().sysname != "Darwin"
+_GH = "CI" in os.environ
 
 
 @pytest.mark.parametrize(
@@ -66,8 +67,14 @@ class TestLargeHash:
     @pytest.mark.parametrize(
         ("expected_hash", "formalism"),
         [
-            ("762cc00", "canonical-helicity"),
-            ("17fefe5", "helicity"),
+            (
+                "762cc00" if sys.version_info >= (3, 11) else "1f5ac33",
+                "canonical-helicity",
+            ),
+            (
+                "17fefe5" if sys.version_info >= (3, 11) else "7b5fad1",
+                "helicity",
+            ),
         ],
         ids=["canonical-helicity", "helicity"],
     )