ENH: New function lazy_apply

docs/api-lazy.md

@@ -0,0 +1,15 @@
+# Tools for lazy backends
+
+These additional functions are meant to be used to support compatibility with
+lazy backends, e.g. Dask or Jax:
+
+```{eval-rst}
+.. currentmodule:: array_api_extra
+.. autosummary::
+    :nosignatures:
+    :toctree: generated
+
+    lazy_apply
+    testing.lazy_xp_function
+    testing.patch_lazy_xp_functions
+```

docs/conf.py

@@ -53,6 +53,8 @@
 
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
+    "numpy": ("https://numpy.org/doc/stable", None),
+    "dask": ("https://docs.dask.org/en/stable", None),
     "jax": ("https://jax.readthedocs.io/en/latest", None),
 }
 

docs/index.md

@@ -5,7 +5,7 @@
 :hidden:
 self
 api-reference.md
-testing-utils.md
+api-lazy.md
 contributing.md
 contributors.md
 ```

pyproject.toml

@@ -106,6 +106,7 @@ sphinx-autodoc-typehints = "*"
 dask-core = "*"
 pytest = "*"
 typing-extensions = "*"
+numpy = "*"
 
 [tool.pixi.feature.docs.tasks]
 docs = { cmd = "sphinx-build . build/", cwd = "docs" }
@@ -311,10 +312,5 @@ checks = [
     "ES01", # most docstrings do not need an extended summary
 ]
 exclude = [ # don't report on objects that match any of these regex
-    '.*test_at.*',
-    '.*test_funcs.*',
-    '.*test_testing.*',
-    '.*test_utils.*',
-    '.*test_version.*',
-    '.*test_vendor.*',
+    '.*test_*',
 ]

src/array_api_extra/__init__.py

@@ -12,6 +12,7 @@
     setdiff1d,
     sinc,
 )
+from ._lib._lazy import lazy_apply
 
 __version__ = "0.6.1.dev0"
 
@@ -25,6 +26,7 @@
     "expand_dims",
     "isclose",
     "kron",
+    "lazy_apply",
     "nunique",
     "pad",
     "setdiff1d",