empty

pyproject.toml

@@ -173,4 +173,5 @@ messages_control.disable = [
   "missing-class-docstring",
   "missing-function-docstring",
   "R1705",   # I like my if (return) elif (return) else (return) pattern
+  "R0801",   # Different files can have similar lines; that's okay
 ]

src/ragged/common/__init__.py

@@ -9,13 +9,14 @@
 
 from __future__ import annotations
 
-from ._creation import arange, asarray
+from ._creation import arange, asarray, empty
 from ._obj import array
 
 __all__ = [
     # _creation
     "arange",
     "asarray",
+    "empty",
     # _obj
     "array",
 ]

src/ragged/common/_creation.py

@@ -106,5 +106,31 @@ def asarray(
             ValueError in case a copy would be necessary. If `None`, the
             function reuses the existing memory buffer if possible and copies
             otherwise.
+
+    https://data-apis.org/array-api/latest/API_specification/generated/array_api.asarray.html
     """
     return array(obj, dtype=dtype, device=device, copy=copy)
+
+
+def empty(
+    shape: int | tuple[int, ...],
+    *,
+    dtype: None | Dtype = None,
+    device: None | Device = None,
+) -> array:
+    """
+    Returns an uninitialized array having a specified shape.
+
+    Args:
+        shape: Output array shape.
+        dtype: Output array data type. If `dtype` is `None`, the output array
+            data type is `np.float64`.
+        device: Device on which to place the created array.
+
+    https://data-apis.org/array-api/latest/API_specification/generated/array_api.empty.html
+    """
+
+    assert shape, "TODO"
+    assert dtype, "TODO"
+    assert device, "TODO"
+    assert False, "TODO"

src/ragged/v202212/__init__.py

@@ -11,13 +11,14 @@
 
 from __future__ import annotations
 
-from ._creation import arange, asarray
+from ._creation import arange, asarray, empty
 from ._obj import array
 
 __all__ = [
     # _creation
     "arange",
     "asarray",
+    "empty",
     # _obj
     "array",
 ]

src/ragged/v202212/_creation.py

@@ -6,6 +6,6 @@
 
 from __future__ import annotations
 
-from ..common._creation import arange, asarray
+from ..common._creation import arange, asarray, empty
 
-__all__ = ["arange", "asarray"]
+__all__ = ["arange", "asarray", "empty"]