Reformat backend.pxd to be closer to black style.

Author: Diptorup Deb

dpctl/_backend.pxd

@@ -26,8 +26,9 @@ from libc.stdint cimport uint32_t
 
 
 cdef extern from "dpctl_utils.h":
-    cdef void DPCTLCString_Delete (const char *str)
-    cdef void DPCTLSize_t_Array_Delete (size_t *arr)
+    cdef void DPCTLCString_Delete(const char *str)
+    cdef void DPCTLSize_t_Array_Delete(size_t *arr)
+
 
 cdef extern from "dpctl_sycl_enum_types.h":
     cdef enum _backend_type 'DPCTLSyclBackendType':
@@ -67,6 +68,7 @@ cdef extern from "dpctl_sycl_enum_types.h":
 
     ctypedef _arg_data_type DPCTLKernelArgType
 
+
 cdef extern from "dpctl_sycl_types.h":
     cdef struct DPCTLOpaqueSyclContext
     cdef struct DPCTLOpaqueSyclDevice
@@ -76,155 +78,180 @@ cdef extern from "dpctl_sycl_types.h":
     cdef struct DPCTLOpaqueSyclQueue
     cdef struct DPCTLOpaqueSyclUSM
 
-    ctypedef DPCTLOpaqueSyclContext* DPCTLSyclContextRef
-    ctypedef DPCTLOpaqueSyclDevice*  DPCTLSyclDeviceRef
-    ctypedef DPCTLOpaqueSyclEvent*   DPCTLSyclEventRef
-    ctypedef DPCTLOpaqueSyclKernel*  DPCTLSyclKernelRef
-    ctypedef DPCTLOpaqueSyclProgram* DPCTLSyclProgramRef
-    ctypedef DPCTLOpaqueSyclQueue*   DPCTLSyclQueueRef
-    ctypedef DPCTLOpaqueSyclUSM*     DPCTLSyclUSMRef
+    ctypedef DPCTLOpaqueSyclContext        *DPCTLSyclContextRef
+    ctypedef DPCTLOpaqueSyclDevice         *DPCTLSyclDeviceRef
+    ctypedef DPCTLOpaqueSyclEvent          *DPCTLSyclEventRef
+    ctypedef DPCTLOpaqueSyclKernel         *DPCTLSyclKernelRef
+    ctypedef DPCTLOpaqueSyclProgram        *DPCTLSyclProgramRef
+    ctypedef DPCTLOpaqueSyclQueue          *DPCTLSyclQueueRef
+    ctypedef DPCTLOpaqueSyclUSM            *DPCTLSyclUSMRef
 
 
 cdef extern from "dpctl_sycl_device_interface.h":
-    cdef void DPCTLDevice_DumpInfo (const DPCTLSyclDeviceRef DRef)
-    cdef void DPCTLDevice_Delete (DPCTLSyclDeviceRef DRef)
-    cdef void DPCTLDevice_DumpInfo (const DPCTLSyclDeviceRef DRef)
-    cdef bool DPCTLDevice_IsAccelerator (const DPCTLSyclDeviceRef DRef)
-    cdef bool DPCTLDevice_IsCPU (const DPCTLSyclDeviceRef DRef)
-    cdef bool DPCTLDevice_IsGPU (const DPCTLSyclDeviceRef DRef)
-    cdef bool DPCTLDevice_IsHost (const DPCTLSyclDeviceRef DRef)
-    cpdef const char *DPCTLDevice_GetDriverInfo (const DPCTLSyclDeviceRef DRef)
-    cpdef const char *DPCTLDevice_GetName (const DPCTLSyclDeviceRef DRef)
-    cpdef const char *DPCTLDevice_GetVendorName (const DPCTLSyclDeviceRef DRef)
-    cdef bool DPCTLDevice_IsHostUnifiedMemory (const DPCTLSyclDeviceRef DRef)
-    cpdef uint32_t DPCTLDevice_GetMaxComputeUnits (const DPCTLSyclDeviceRef DRef)
-    cpdef uint32_t DPCTLDevice_GetMaxWorkItemDims (const DPCTLSyclDeviceRef DRef)
-    cpdef size_t *DPCTLDevice_GetMaxWorkItemSizes (const DPCTLSyclDeviceRef DRef)
-    cpdef size_t DPCTLDevice_GetMaxWorkGroupSize (const DPCTLSyclDeviceRef DRef)
-    cpdef uint32_t DPCTLDevice_GetMaxNumSubGroups (const DPCTLSyclDeviceRef DRef)
-    cpdef bool DPCTLDevice_HasInt64BaseAtomics (const DPCTLSyclDeviceRef DRef)
-    cpdef bool DPCTLDevice_HasInt64ExtendedAtomics (const DPCTLSyclDeviceRef DRef)
+    cdef void DPCTLDevice_DumpInfo(const DPCTLSyclDeviceRef DRef)
+    cdef void DPCTLDevice_Delete(DPCTLSyclDeviceRef DRef)
+    cdef void DPCTLDevice_DumpInfo(const DPCTLSyclDeviceRef DRef)
+    cdef bool DPCTLDevice_IsAccelerator(const DPCTLSyclDeviceRef DRef)
+    cdef bool DPCTLDevice_IsCPU(const DPCTLSyclDeviceRef DRef)
+    cdef bool DPCTLDevice_IsGPU(const DPCTLSyclDeviceRef DRef)
+    cdef bool DPCTLDevice_IsHost(const DPCTLSyclDeviceRef DRef)
+    cpdef const char *DPCTLDevice_GetDriverInfo(const DPCTLSyclDeviceRef DRef)
+    cpdef const char *DPCTLDevice_GetName(const DPCTLSyclDeviceRef DRef)
+    cpdef const char *DPCTLDevice_GetVendorName(const DPCTLSyclDeviceRef DRef)
+    cdef bool DPCTLDevice_IsHostUnifiedMemory(const DPCTLSyclDeviceRef DRef)
+    cpdef uint32_t DPCTLDevice_GetMaxComputeUnits(const DPCTLSyclDeviceRef DRef)
+    cpdef uint32_t DPCTLDevice_GetMaxWorkItemDims(const DPCTLSyclDeviceRef DRef)
+    cpdef size_t *DPCTLDevice_GetMaxWorkItemSizes(const DPCTLSyclDeviceRef DRef)
+    cpdef size_t DPCTLDevice_GetMaxWorkGroupSize(const DPCTLSyclDeviceRef DRef)
+    cpdef uint32_t DPCTLDevice_GetMaxNumSubGroups(const DPCTLSyclDeviceRef DRef)
+    cpdef bool DPCTLDevice_HasInt64BaseAtomics(const DPCTLSyclDeviceRef DRef)
+    cpdef bool DPCTLDevice_HasInt64ExtendedAtomics(
+        const DPCTLSyclDeviceRef DRef)
 
 
 cdef extern from "dpctl_sycl_event_interface.h":
-    cdef void DPCTLEvent_Wait (DPCTLSyclEventRef ERef)
-    cdef void DPCTLEvent_Delete (DPCTLSyclEventRef ERef)
+    cdef void DPCTLEvent_Wait(DPCTLSyclEventRef ERef)
+    cdef void DPCTLEvent_Delete(DPCTLSyclEventRef ERef)
 
 
 cdef extern from "dpctl_sycl_kernel_interface.h":
-    cdef const char* DPCTLKernel_GetFunctionName (const DPCTLSyclKernelRef KRef)
-    cdef size_t DPCTLKernel_GetNumArgs (const DPCTLSyclKernelRef KRef)
-    cdef void DPCTLKernel_Delete (DPCTLSyclKernelRef KRef)
+    cdef const char* DPCTLKernel_GetFunctionName(const DPCTLSyclKernelRef KRef)
+    cdef size_t DPCTLKernel_GetNumArgs(const DPCTLSyclKernelRef KRef)
+    cdef void DPCTLKernel_Delete(DPCTLSyclKernelRef KRef)
 
 
 cdef extern from "dpctl_sycl_platform_interface.h":
-    cdef size_t DPCTLPlatform_GetNumNonHostPlatforms ()
-    cdef void DPCTLPlatform_DumpInfo ()
-    cdef size_t DPCTLPlatform_GetNumNonHostBackends ()
-    cdef DPCTLSyclBackendType *DPCTLPlatform_GetListOfNonHostBackends ()
-    cdef void DPCTLPlatform_DeleteListOfBackends (DPCTLSyclBackendType * BEs)
+    cdef size_t DPCTLPlatform_GetNumNonHostPlatforms()
+    cdef void DPCTLPlatform_DumpInfo()
+    cdef size_t DPCTLPlatform_GetNumNonHostBackends()
+    cdef DPCTLSyclBackendType *DPCTLPlatform_GetListOfNonHostBackends()
+    cdef void DPCTLPlatform_DeleteListOfBackends(DPCTLSyclBackendType * BEs)
 
 
 cdef extern from "dpctl_sycl_context_interface.h":
-    cdef bool DPCTLContext_AreEq (const DPCTLSyclContextRef CtxRef1,
+    cdef bool DPCTLContext_AreEq(const DPCTLSyclContextRef CtxRef1,
                                  const DPCTLSyclContextRef CtxRef2)
-    cdef DPCTLSyclBackendType DPCTLContext_GetBackend (
-            const DPCTLSyclContextRef CtxRef)
-    cdef void DPCTLContext_Delete (DPCTLSyclContextRef CtxRef)
+    cdef DPCTLSyclBackendType DPCTLContext_GetBackend(
+        const DPCTLSyclContextRef CtxRef)
+    cdef void DPCTLContext_Delete(DPCTLSyclContextRef CtxRef)
 
 
 cdef extern from "dpctl_sycl_program_interface.h":
-    cdef DPCTLSyclProgramRef DPCTLProgram_CreateFromSpirv (
-                                const DPCTLSyclContextRef Ctx,
-                                const void *IL,
-                                size_t Length,
-                                const char *CompileOpts)
-    cdef DPCTLSyclProgramRef DPCTLProgram_CreateFromOCLSource (
-                                const DPCTLSyclContextRef Ctx,
-                                const char *Source,
-                                const char *CompileOpts)
-    cdef DPCTLSyclKernelRef DPCTLProgram_GetKernel (DPCTLSyclProgramRef PRef,
-                                                  const char *KernelName)
-    cdef bool DPCTLProgram_HasKernel (DPCTLSyclProgramRef PRef,
+    cdef DPCTLSyclProgramRef DPCTLProgram_CreateFromSpirv(
+        const DPCTLSyclContextRef Ctx,
+        const void *IL,
+        size_t Length,
+        const char *CompileOpts)
+    cdef DPCTLSyclProgramRef DPCTLProgram_CreateFromOCLSource(
+        const DPCTLSyclContextRef Ctx,
+        const char *Source,
+        const char *CompileOpts)
+    cdef DPCTLSyclKernelRef DPCTLProgram_GetKernel(
+        DPCTLSyclProgramRef PRef,
+        const char *KernelName)
+    cdef bool DPCTLProgram_HasKernel(DPCTLSyclProgramRef PRef,
                                      const char *KernelName)
-    cdef void DPCTLProgram_Delete (DPCTLSyclProgramRef PRef)
+    cdef void DPCTLProgram_Delete(DPCTLSyclProgramRef PRef)
 
 
 cdef extern from "dpctl_sycl_queue_interface.h":
-    cdef bool DPCTLQueue_AreEq (const DPCTLSyclQueueRef QRef1,
+    cdef bool DPCTLQueue_AreEq(const DPCTLSyclQueueRef QRef1,
                                const DPCTLSyclQueueRef QRef2)
-    cdef void DPCTLQueue_Delete (DPCTLSyclQueueRef QRef)
-    cdef DPCTLSyclBackendType DPCTLQueue_GetBackend (const DPCTLSyclQueueRef Q)
-    cdef DPCTLSyclContextRef DPCTLQueue_GetContext (const DPCTLSyclQueueRef Q)
-    cdef DPCTLSyclDeviceRef DPCTLQueue_GetDevice (const DPCTLSyclQueueRef Q)
-    cdef DPCTLSyclEventRef  DPCTLQueue_SubmitRange (
-                                const DPCTLSyclKernelRef Ref,
-                                const DPCTLSyclQueueRef QRef,
-                                void **Args,
-                                const DPCTLKernelArgType *ArgTypes,
-                                size_t NArgs,
-                                const size_t Range[3],
-                                size_t NDims,
-                                const DPCTLSyclEventRef *DepEvents,
-                                size_t NDepEvents)
+    cdef void DPCTLQueue_Delete(DPCTLSyclQueueRef QRef)
+    cdef DPCTLSyclBackendType DPCTLQueue_GetBackend(const DPCTLSyclQueueRef Q)
+    cdef DPCTLSyclContextRef DPCTLQueue_GetContext(const DPCTLSyclQueueRef Q)
+    cdef DPCTLSyclDeviceRef DPCTLQueue_GetDevice(const DPCTLSyclQueueRef Q)
+    cdef DPCTLSyclEventRef  DPCTLQueue_SubmitRange(
+        const DPCTLSyclKernelRef Ref,
+        const DPCTLSyclQueueRef QRef,
+        void **Args,
+        const DPCTLKernelArgType *ArgTypes,
+        size_t NArgs,
+        const size_t Range[3],
+        size_t NDims,
+        const DPCTLSyclEventRef *DepEvents,
+        size_t NDepEvents)
     cdef DPCTLSyclEventRef DPCTLQueue_SubmitNDRange(
-                                const DPCTLSyclKernelRef Ref,
-                                const DPCTLSyclQueueRef QRef,
-                                void **Args,
-                                const DPCTLKernelArgType *ArgTypes,
-                                size_t NArgs,
-                                const size_t gRange[3],
-                                const size_t lRange[3],
-                                size_t NDims,
-                                const DPCTLSyclEventRef *DepEvents,
-                                size_t NDepEvents)
-    cdef void DPCTLQueue_Wait (const DPCTLSyclQueueRef QRef)
-    cdef void DPCTLQueue_Memcpy (const DPCTLSyclQueueRef Q,
-                                void *Dest, const void *Src, size_t Count)
-    cdef void DPCTLQueue_Prefetch (const DPCTLSyclQueueRef Q,
-                                  const void *Src, size_t Count)
-    cdef void DPCTLQueue_MemAdvise (const DPCTLSyclQueueRef Q,
-                                   const void *Src, size_t Count, int Advice)
+        const DPCTLSyclKernelRef Ref,
+        const DPCTLSyclQueueRef QRef,
+        void **Args,
+        const DPCTLKernelArgType *ArgTypes,
+        size_t NArgs,
+        const size_t gRange[3],
+        const size_t lRange[3],
+        size_t NDims,
+        const DPCTLSyclEventRef *DepEvents,
+        size_t NDepEvents)
+    cdef void DPCTLQueue_Wait(const DPCTLSyclQueueRef QRef)
+    cdef void DPCTLQueue_Memcpy(
+        const DPCTLSyclQueueRef Q,
+        void *Dest,
+        const void *Src,
+        size_t Count)
+    cdef void DPCTLQueue_Prefetch(
+        const DPCTLSyclQueueRef Q,
+        const void *Src,
+        size_t Count)
+    cdef void DPCTLQueue_MemAdvise(
+        const DPCTLSyclQueueRef Q,
+        const void *Src,
+        size_t Count,
+        int Advice)
 
 
 cdef extern from "dpctl_sycl_queue_manager.h":
-    cdef DPCTLSyclQueueRef DPCTLQueueMgr_GetCurrentQueue ()
-    cdef size_t DPCTLQueueMgr_GetNumQueues (DPCTLSyclBackendType BETy,
+    cdef DPCTLSyclQueueRef DPCTLQueueMgr_GetCurrentQueue()
+    cdef size_t DPCTLQueueMgr_GetNumQueues(DPCTLSyclBackendType BETy,
                                            DPCTLSyclDeviceType DeviceTy)
-    cdef size_t DPCTLQueueMgr_GetNumActivatedQueues ()
-    cdef DPCTLSyclQueueRef DPCTLQueueMgr_GetQueue (DPCTLSyclBackendType BETy,
-                                                 DPCTLSyclDeviceType DeviceTy,
-                                                 size_t DNum)
-    cdef bool DPCTLQueueMgr_IsCurrentQueue (const DPCTLSyclQueueRef QRef)
-    cdef void DPCTLQueueMgr_PopQueue ()
-    cdef DPCTLSyclQueueRef DPCTLQueueMgr_PushQueue (DPCTLSyclBackendType BETy,
-                                                  DPCTLSyclDeviceType DeviceTy,
-                                                  size_t DNum)
-    cdef DPCTLSyclQueueRef DPCTLQueueMgr_SetAsDefaultQueue (
-                              DPCTLSyclBackendType BETy,
-                              DPCTLSyclDeviceType DeviceTy,
-                              size_t DNum
-                          )
+    cdef size_t DPCTLQueueMgr_GetNumActivatedQueues()
+    cdef DPCTLSyclQueueRef DPCTLQueueMgr_GetQueue(
+        DPCTLSyclBackendType BETy,
+        DPCTLSyclDeviceType DeviceTy,
+        size_t DNum)
+    cdef bool DPCTLQueueMgr_IsCurrentQueue(const DPCTLSyclQueueRef QRef)
+    cdef void DPCTLQueueMgr_PopQueue()
+    cdef DPCTLSyclQueueRef DPCTLQueueMgr_PushQueue(
+        DPCTLSyclBackendType BETy,
+        DPCTLSyclDeviceType DeviceTy,
+        size_t DNum)
+    cdef DPCTLSyclQueueRef DPCTLQueueMgr_SetAsDefaultQueue(
+        DPCTLSyclBackendType BETy,
+        DPCTLSyclDeviceType DeviceTy,
+        size_t DNum)
     cdef DPCTLSyclQueueRef DPCTLQueueMgr_GetQueueFromContextAndDevice(
         DPCTLSyclContextRef CRef,
         DPCTLSyclDeviceRef DRef)
 
 
 cdef extern from "dpctl_sycl_usm_interface.h":
-    cdef DPCTLSyclUSMRef DPCTLmalloc_shared (size_t size, DPCTLSyclQueueRef QRef)
-    cdef DPCTLSyclUSMRef DPCTLmalloc_host (size_t size, DPCTLSyclQueueRef QRef)
-    cdef DPCTLSyclUSMRef DPCTLmalloc_device (size_t size, DPCTLSyclQueueRef QRef)
-    cdef DPCTLSyclUSMRef DPCTLaligned_alloc_shared (size_t alignment,
-                                                  size_t size, DPCTLSyclQueueRef QRef)
-    cdef DPCTLSyclUSMRef DPCTLaligned_alloc_host (size_t alignment,
-                                                size_t size, DPCTLSyclQueueRef QRef)
-    cdef DPCTLSyclUSMRef DPCTLaligned_alloc_device (size_t alignment,
-                                                  size_t size, DPCTLSyclQueueRef QRef)
-    cdef void DPCTLfree_with_queue (DPCTLSyclUSMRef MRef,
-                                   DPCTLSyclQueueRef QRef)
-    cdef void DPCTLfree_with_context (DPCTLSyclUSMRef MRef,
-                                     DPCTLSyclContextRef CRef)
-    cdef const char* DPCTLUSM_GetPointerType (DPCTLSyclUSMRef MRef,
-                                             DPCTLSyclContextRef CRef)
-    cdef DPCTLSyclDeviceRef DPCTLUSM_GetPointerDevice (DPCTLSyclUSMRef MRef,
-                                                     DPCTLSyclContextRef CRef)
+    cdef DPCTLSyclUSMRef DPCTLmalloc_shared(
+        size_t size,
+        DPCTLSyclQueueRef QRef)
+    cdef DPCTLSyclUSMRef DPCTLmalloc_host(
+        size_t size,
+        DPCTLSyclQueueRef QRef)
+    cdef DPCTLSyclUSMRef DPCTLmalloc_device(size_t size, DPCTLSyclQueueRef QRef)
+    cdef DPCTLSyclUSMRef DPCTLaligned_alloc_shared(
+        size_t alignment,
+        size_t size,
+        DPCTLSyclQueueRef QRef)
+    cdef DPCTLSyclUSMRef DPCTLaligned_alloc_host(
+        size_t alignment,
+        size_t size,
+        DPCTLSyclQueueRef QRef)
+    cdef DPCTLSyclUSMRef DPCTLaligned_alloc_device(
+        size_t alignment,
+        size_t size,
+        DPCTLSyclQueueRef QRef)
+    cdef void DPCTLfree_with_queue(
+        DPCTLSyclUSMRef MRef,
+        DPCTLSyclQueueRef QRef)
+    cdef void DPCTLfree_with_context(
+        DPCTLSyclUSMRef MRef,
+        DPCTLSyclContextRef CRef)
+    cdef const char* DPCTLUSM_GetPointerType(
+        DPCTLSyclUSMRef MRef,
+        DPCTLSyclContextRef CRef)
+    cdef DPCTLSyclDeviceRef DPCTLUSM_GetPointerDevice(
+        DPCTLSyclUSMRef MRef,
+        DPCTLSyclContextRef CRef)