use scverse-backends

Author: Intron7

.github/workflows/test.yaml

@@ -98,8 +98,6 @@ jobs:
         os: [ubuntu-latest, macos-latest]
         env: ${{ fromJSON(needs.get-environments.outputs.envs) }}
         exclude:
-          - os: macos-latest
-            env: { name: hatch-test.py3.11-stable }
           - os: macos-latest
             env: { name: hatch-test.py3.12-stable }
           - os: macos-latest

README.md

@@ -20,7 +20,7 @@ Head over to the [documentation](https://squidpy.readthedocs.io/en/stable/) for
 
 ## Installation
 
-We recommend running Squidpy on a recent Linux or macOS system with Python ≥3.11, but it also works on Windows via WSL.
+We recommend running Squidpy on a recent Linux or macOS system with Python ≥3.12, but it also works on Windows via WSL.
 
 Install from [PyPI](https://pypi.org/project/squidpy) with:
 

docs/api.md

@@ -89,14 +89,9 @@ import squidpy as sq
 ## Settings
 
 ```{eval-rst}
-.. currentmodule:: squidpy._backends._settings
-
-.. autoclass:: _Settings
-    :members: backend, use_backend, available_backends, get_backend
-
 .. data:: squidpy.settings
 
-    The global settings instance. See :class:`~squidpy._backends._settings._Settings`.
+    The global backend settings instance provided by :mod:`scverse_backends`.
 ```
 
 ## Datasets

docs/installation.md

@@ -1,6 +1,6 @@
 # Installation
 
-Squidpy requires Python version >= 3.11 to run.
+Squidpy requires Python version >= 3.12 to run.
 
 ## PyPI
 

pyproject.toml

@@ -21,7 +21,7 @@ maintainers = [
 authors = [
   { name = "scverse" },
 ]
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Environment :: Console",
@@ -31,7 +31,6 @@ classifiers = [
   "Operating System :: MacOS :: MacOS X",
   "Operating System :: POSIX :: Linux",
   "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",
@@ -66,6 +65,7 @@ dependencies = [
   "scikit-image>=0.25",
   # due to https://github.com/scikit-image/scikit-image/issues/6850 breaks rescale ufunc
   "scikit-learn>=0.24",
+  "scverse-backends",
   "spatialdata>=0.7.1",
   "spatialdata-plot",
   "statsmodels>=0.12",
@@ -142,7 +142,7 @@ version.source = "vcs"
 [tool.pixi]
 workspace.channels = [ "conda-forge" ]
 workspace.platforms = [ "linux-64", "osx-arm64" ]
-dependencies.python = ">=3.11"
+dependencies.python = ">=3.12"
 pypi-dependencies.squidpy = { path = ".", editable = true }
 tasks.format = "ruff format ."
 tasks.kernel-install = 'python -m ipykernel install --user --name pixi-dev --display-name "squidpy (dev)"'
@@ -151,12 +151,12 @@ tasks.lint = "ruff check ."
 tasks.pre-commit = "pre-commit run"
 tasks.pre-commit-install = "pre-commit install"
 tasks.test = "pytest -v --color=yes --tb=short --durations=10"
-feature.py311.dependencies.python = "3.11.*"
+feature.py312.dependencies.python = "3.12.*"
 feature.py313.dependencies.python = "3.13.*"
 environments.default = { features = [ "py313" ], solve-group = "py313" }
-environments.dev-py311 = { features = [ "dev", "test", "py311" ], solve-group = "py311" }
+environments.dev-py312 = { features = [ "dev", "test", "py312" ], solve-group = "py312" }
 environments.dev-py313 = { features = [ "dev", "test", "py313" ], solve-group = "py313" }
-environments.docs-py311 = { features = [ "docs", "py311" ], solve-group = "py311" }
+environments.docs-py312 = { features = [ "docs", "py312" ], solve-group = "py312" }
 environments.docs-py313 = { features = [ "docs", "py313" ], solve-group = "py313" }
 environments.test-py313 = { features = [ "test", "py313" ], solve-group = "py313" }
 

src/squidpy/_backends/__init__.py

@@ -2,8 +2,39 @@
 
 from __future__ import annotations
 
-from squidpy._backends._dispatch import dispatch
-from squidpy._backends._registry import available_backend_names, get_backend
-from squidpy._backends._settings import settings
+from scverse_backends import BackendDispatcher
 
-__all__ = ["dispatch", "get_backend", "available_backend_names", "settings"]
+_dispatcher = BackendDispatcher(
+    entrypoint_group="squidpy.backends",
+    host_name="squidpy",
+    trusted_backends={
+        "rapids_singlecell": {
+            "aliases": ["rapids-singlecell", "rsc", "cuda"],
+            "package": "rapids-singlecell",
+            "distributions": [
+                "rapids-singlecell",
+                "rapids-singlecell-cu12",
+                "rapids-singlecell-cu13",
+            ],
+            "entrypoints": ["rapids_singlecell"],
+            "module_prefixes": ["rapids_singlecell"],
+        },
+    },
+    reserved_backends={
+        "gpu": "Use a concrete backend alias such as 'cuda' or 'rsc'.",
+    },
+)
+
+dispatch = _dispatcher.dispatch
+settings = _dispatcher.settings
+get_backend = _dispatcher.get_backend
+available_backend_names = _dispatcher.available_backend_names
+discover = _dispatcher.discover
+
+__all__ = [
+    "available_backend_names",
+    "discover",
+    "dispatch",
+    "get_backend",
+    "settings",
+]