chore: SPEC0 update (Python 3.12+) (#140)

Author: flying-sheep

.github/workflows/ci-gpu.yml

@@ -43,9 +43,9 @@ jobs:
       - uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-      - uses: hynek/setup-cached-uv@v2
+      - uses: astral-sh/setup-uv@v6
         with:
-          cache-dependency-path: pyproject.toml
+          enable-cache: true  # "auto" is `false` on non-GitHub runners
       - name: Install package
         run: uv pip install --system -e .[test,full] cupy-cuda12x --extra-index-url=https://pypi.nvidia.com --index-strategy=unsafe-best-match
       - name: List installed packages

.github/workflows/ci.yml

@@ -75,7 +75,7 @@ jobs:
     steps:
       - uses: actions/checkout@v5
         with: { fetch-depth: 0, filter: "blob:none" }
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.13'
       - uses: astral-sh/setup-uv@v7
@@ -90,7 +90,7 @@ jobs:
     steps:
       - uses: actions/checkout@v5
         with: { fetch-depth: 0, filter: "blob:none" }
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: '3.13'
       - uses: astral-sh/setup-uv@v7
@@ -110,7 +110,7 @@ jobs:
     steps:
       - uses: actions/checkout@v5
         with: { fetch-depth: 0, filter: "blob:none" }
-      - uses: actions/setup-python@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: ${{ matrix.python-version }}
       - uses: pre-commit/[email protected]

.github/workflows/publish.yml

@@ -13,8 +13,8 @@ jobs:
     permissions:
       id-token: write # to authenticate as Trusted Publisher to pypi.org
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
         with:
           python-version: "3.x"
           cache: pip

.readthedocs.yml

@@ -2,7 +2,7 @@ version: 2
 build:
   os: ubuntu-24.04
   tools:
-    python: "3.12"
+    python: "3.13"
 python:
   install:
     - method: pip

docs/conf.py

@@ -9,16 +9,20 @@
 from typing import TYPE_CHECKING
 
 from docutils.nodes import Text
+from sphinx.util import logging
 
 
 if TYPE_CHECKING:
+    from typing import Final
+
     from docutils.nodes import TextElement, reference
     from sphinx.addnodes import pending_xref
     from sphinx.application import Sphinx
     from sphinx.environment import BuildEnvironment
 
 
-HERE = Path(__file__).parent
+HERE: Final = Path(__file__).parent
+LOGGER: Final = logging.getLogger("fast_array_utils")
 
 
 # -- General configuration ------------------------------------------------
@@ -134,7 +138,8 @@ def resolve_type_aliases(app: Sphinx, env: BuildEnvironment, node: pending_xref,
         ref = resolve_reference_any_inventory(env=env, honor_disabled_refs=False, node=node, contnode=contnode)
     if ref is None:
         msg = f"Could not resolve {typ} {target} (from {node['reftarget']})"
-        raise AssertionError(msg)
+        LOGGER.warning(msg, type="ref")
+        return ref
     if name:
         ref.children[:] = [Text(name)]
     return ref

pyproject.toml

@@ -14,12 +14,11 @@ license = "MPL-2.0"
 authors = [
   { name = "Philipp A.", email = "[email protected]" },
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Developers",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.14",
@@ -107,11 +106,11 @@ overrides.matrix.resolution.dependencies = [
 ]
 
 [[tool.hatch.envs.hatch-test.matrix]]
-python = [ "3.13", "3.11" ]
+python = [ "3.13", "3.12" ]
 extras = [ "full", "min" ]
 
 [[tool.hatch.envs.hatch-test.matrix]]
-python = [ "3.11" ]
+python = [ "3.12" ]
 extras = [ "full" ]
 resolution = [ "lowest" ]
 

src/fast_array_utils/conv/__init__.py

@@ -5,7 +5,6 @@
 
 from typing import TYPE_CHECKING, overload
 
-from ..typing import CpuArray, DiskArray, GpuArray  # noqa: TC001
 from ._to_dense import to_dense_
 
 
@@ -15,6 +14,7 @@
     from numpy.typing import NDArray
 
     from .. import types
+    from ..typing import CpuArray, DiskArray, GpuArray
 
 
 __all__ = ["to_dense"]

src/fast_array_utils/conv/_to_dense.py

@@ -8,14 +8,15 @@
 import numpy as np
 
 from .. import types
-from ..typing import CpuArray, DiskArray, GpuArray  # noqa: TC001
 
 
 if TYPE_CHECKING:
     from typing import Any, Literal
 
     from numpy.typing import NDArray
 
+    from ..typing import CpuArray, DiskArray, GpuArray
+
 
 # fallback’s arg0 type has to include types of registered functions
 @singledispatch

src/fast_array_utils/stats/__init__.py

@@ -10,7 +10,6 @@
 from typing import TYPE_CHECKING, cast, get_args, overload
 
 from .._validation import validate_axis
-from ..typing import CpuArray, DiskArray, GpuArray  # noqa: TC001
 from ._generic_ops import DtypeOps
 
 
@@ -22,6 +21,7 @@
     from optype.numpy import ToDType
 
     from .. import types
+    from ..typing import CpuArray, DiskArray, GpuArray
     from ._generic_ops import Ops
     from ._typing import NoDtypeOps, StatFunDtype, StatFunNoDtype
 

src/fast_array_utils/stats/_generic_ops.py

@@ -12,14 +12,14 @@
 
 
 if TYPE_CHECKING:
-    from typing import Any, Literal, TypeAlias
+    from typing import Any, Literal
 
     from numpy.typing import DTypeLike, NDArray
 
     from ..typing import CpuArray, DiskArray, GpuArray
     from ._typing import Ops
 
-    ComplexAxis: TypeAlias = tuple[Literal[0], Literal[1]] | tuple[Literal[0, 1]] | Literal[0, 1] | None
+    type ComplexAxis = tuple[Literal[0], Literal[1]] | tuple[Literal[0, 1]] | Literal[0, 1] | None
 
 
 def _run_numpy_op(