Expose more dpctl exceptions: SyclContextCreationError, SyclQueueCreationError, USMAllocationError, ExecutionPlacementError

Author: antonwolfy

doc/reference/exceptions.rst

@@ -36,4 +36,32 @@ Exceptions
         ...
         DLPackCreationError: to_dlpack_capsule: DLPack can only export arrays based on USM allocations bound to a default platform SYCL context
 
-.. autodata:: SyclDeviceCreationError
+.. data:: ExecutionPlacementError
+
+    Given when execution placement target can not be unambiguously determined
+    from input arrays. Make sure that input arrays are associated with the same
+    :class:`dpctl.SyclQueue`, or migrate data to the same
+    :class:`dpctl.SyclQueue` using :meth:`dpnp.ndarray.to_device` method.
+
+.. data:: SyclContextCreationError
+
+    Given when :class:`dpctl.SyclContext` instance could not created.
+
+.. data:: SyclDeviceCreationError
+
+    Given when :class:`dpctl.SyclDevice` instance could not created.
+
+.. data:: SyclQueueCreationError
+
+    Given when :class:`dpctl.SyclQueue` instance could not created.
+    The creation can fail if the filter string is invalid, or the backend or
+    device type values are not supported.
+
+.. data:: USMAllocationError
+
+    Given when Unified Shared Memory (USM) allocation call returns a null
+    pointer, signaling a failure to perform the allocation.
+    Some common reasons for allocation failure are:
+
+        * insufficient free memory to perform the allocation request
+        * allocation size exceeds the maximum supported by targeted backend

dpnp/exceptions/__init__.py

@@ -1,9 +1,19 @@
-from dpctl import SyclDeviceCreationError
+from dpctl import (
+    SyclContextCreationError,
+    SyclDeviceCreationError,
+    SyclQueueCreationError,
+)
+from dpctl.memory import USMAllocationError
 from dpctl.tensor._dlpack import DLPackCreationError
+from dpctl.utils import ExecutionPlacementError
 from numpy.exceptions import AxisError
 
 __all__ = [
     "AxisError",
     "DLPackCreationError",
+    "ExecutionPlacementError",
     "SyclDeviceCreationError",
+    "SyclContextCreationError",
+    "SyclQueueCreationError",
+    "USMAllocationError",
 ]