a Re3@sddlmZddlZeejjdZdaGdddaddZ Gdd d e Z dd d Z d d Z ddZdddZddZdS)) _ccallback_cNc@s eZdZdS)CDataN)__name__ __module__ __qualname__rrI/var/www/sunrise/env/lib/python3.9/site-packages/scipy/_lib/_ccallback.pyr srcCsBtdur dSzddl}|atjaWnty<daYn0dS)NrF)fficffiZFFIr ImportError)r rrr _import_cffi s  r c@sneZdZdZdZdddZddZedd Zed d Z ed d Z ddZ e dddZ e dddZdS)LowLevelCallablea Low-level callback function. Some functions in SciPy take as arguments callback functions, which can either be python callables or low-level compiled functions. Using compiled callback functions can improve performance somewhat by avoiding wrapping data in Python objects. Such low-level functions in SciPy are wrapped in `LowLevelCallable` objects, which can be constructed from function pointers obtained from ctypes, cffi, Cython, or contained in Python `PyCapsule` objects. .. seealso:: Functions accepting low-level callables: `scipy.integrate.quad`, `scipy.ndimage.generic_filter`, `scipy.ndimage.generic_filter1d`, `scipy.ndimage.geometric_transform` Usage examples: :ref:`ndimage-ccallbacks`, :ref:`quad-callbacks` Parameters ---------- function : {PyCapsule, ctypes function pointer, cffi function pointer} Low-level callback function. user_data : {PyCapsule, ctypes void pointer, cffi void pointer} User data to pass on to the callback function. signature : str, optional Signature of the function. If omitted, determined from *function*, if possible. Attributes ---------- function Callback function given. user_data User data given. signature Signature of the function. Methods ------- from_cython Class method for constructing callables from Cython C-exported functions. Notes ----- The argument ``function`` can be one of: - PyCapsule, whose name contains the C function signature - ctypes function pointer - cffi function pointer The signature of the low-level callback must match one of those expected by the routine it is passed to. If constructing low-level functions from a PyCapsule, the name of the capsule must be the corresponding signature, in the format:: return_type (arg1_type, arg2_type, ...) For example:: "void (double)" "double (double, int *, void *)" The context of a PyCapsule passed in as ``function`` is used as ``user_data``, if an explicit value for ``user_data`` was not given. rNcCs ||||}t||||fSN)_parse_callbacktuple__new__)clsfunction user_data signatureitemrrr rhszLowLevelCallable.__new__cCsd|jd|jdS)NzLowLevelCallable(, ))rrselfrrr __repr__nszLowLevelCallable.__repr__cCs t|dS)Nrr __getitem__rrrr rqszLowLevelCallable.functioncCs t|dS)Nrrrrr ruszLowLevelCallable.user_datacCstt|dS)Nr)rZget_capsule_signaturerrrrrr ryszLowLevelCallable.signaturecCs tdSr) ValueError)ridxrrr r}szLowLevelCallable.__getitem__c Cs~z|j|}Wnbty<}ztd|WYd}~n>d}~0typ}ztd|d|WYd}~n d}~00||||S)a Create a low-level callback function from an exported Cython function. Parameters ---------- module : module Cython module where the exported function resides name : str Name of the exported function user_data : {PyCapsule, ctypes void pointer, cffi void pointer}, optional User data to pass on to the callback function. signature : str, optional Signature of the function. If omitted, determined from *function*. z?Given module is not a Cython module with __pyx_capi__ attributeNz No function z$ found in __pyx_capi__ of the module)Z __pyx_capi__AttributeErrorr KeyError)rmodulenamerrrerrr from_cythons(zLowLevelCallable.from_cythoncCstt|trt|d}nLt|tr8t||\}}n2t|trRt||\}}nt |rb|}nt dt|t j rt|}n:t|trt|}n&|durd}nt |r|}nt dt |||S)NrzMGiven input is not a callable or a low-level callable (pycapsule/ctypes/cffi)zNGiven user data is not a valid low-level void* pointer (pycapsule/ctypes/cffi))r isinstancerrr PyCFuncPtr_get_ctypes_funcr_get_cffi_funcrZ check_capsuler ctypesc_void_p_get_ctypes_data_get_cffi_dataZget_raw_capsule)robjrrfunccontextrrr rs(         z LowLevelCallable._parse_callback)NN)NN)NN)rrr__doc__ __slots__rrpropertyrrrr classmethodr'rrrrr rsK     rcCspt|tjj}|durht|jd}t|jD].\}}|dkrN|t|7}q0|dt|7}q0|d7}||fS)Nz (rrr)r,castr-value_typename_from_ctypesrestype enumerateargtypes)r1rfunc_ptrjargrrr r*sr*cCsv|dur dS|tjurdS|j}d}|drD|d7}|dd}q$|drZ|dd}|dkrr|d d |7}|S) Nvoidzvoid *rZLP_rZc_r *)r,r-r startswith)rr%Z pointer_levelrrr r9s    r9cCst|tjjSr)r,r7r-r8datarrr r.sr.cCs4td|}|dur,tt|dd}||fS)N uintptr_tz(*)rB)r r7ZgetctypeZtypeofreplace)r1rr=rrr r+s r+cCs td|S)NrG)r r7rErrr r/sr/)N)N)rr, CFUNCTYPEr- __bases__r)r rr rrr*r9r.r+r/rrrr s !