Merge branch 'main' into dlpack-api-update

data-apis · leofang · Feb 9, 2024 · Feb 21, 2023 · Mar 21, 2023 · Feb 7, 2024
commit c4e0cb8f5e29f713ea7cbc586fed01d6decc52d5
diff --git a/src/array_api_stubs/_draft/creation_functions.py b/src/array_api_stubs/_draft/creation_functions.py
@@ -233,11 +233,24 @@ def from_dlpack(x: object, /) -> array:
 
            The returned array may be either a copy or a view. See :ref:`data-interchange` for details.
 
+    Raises
+    ------
+    BufferError
+        The ``__dlpack__`` and ``__dlpack_device__`` methods on the input array
+        may raise ``BufferError`` when the data cannot be exported as DLPack
+        (e.g., incompatible dtype or strides). It may also raise other errors
+        when export fails for other reasons (e.g., not enough memory available
+        to materialize the data). ``from_dlpack`` must propagate such
+        exceptions.
+    AttributeError
+        If the ``__dlpack__`` and ``__dlpack_device__`` methods are not present
+        on the input array. This may happen for libraries that are never able
+        to export their data with DLPack.
+
     Notes
     -----
     See :meth:`array.__dlpack__` for implementation suggestions for `from_dlpack` in
     order to handle DLPack versioning correctly.
-
     """