a `*jI@sdZddlmZddlmZmZddlmZmZm Z m Z ddl m Z Gddde Z Gd d d e ZGd d d eZGd dde ZGdddZGdddeZeZddde dddZGdddeZeZdS)zoThis module implements decorators for implementing other decorators as well as some commonly used decorators. )partial)isclass signature)BaseObjectProxyBoundFunctionWrapperCallableObjectProxyFunctionWrapper) formatargspeccsXeZdZfddZeddZeddZeddZed d Zed d Z Z S) _AdapterFunctionCodecstt||||_dSN)superr __init___self_adapter_code)selfZ wrapped_codeZ adapter_code __class__L/var/www/html/assistant/venv/lib/python3.9/site-packages/wrapt/decorators.pyrsz_AdapterFunctionCode.__init__cCs|jjSr )r co_argcountrrrrr sz _AdapterFunctionCode.co_argcountcCs|jjSr )rco_coderrrrr$sz_AdapterFunctionCode.co_codecCs|jjSr )rco_flagsrrrrr(sz_AdapterFunctionCode.co_flagscCs|jjSr )rco_kwonlyargcountrrrrr,sz&_AdapterFunctionCode.co_kwonlyargcountcCs|jjSr )r co_varnamesrrrrr0sz _AdapterFunctionCode.co_varnames) __name__ __module__ __qualname__rpropertyrrrrr __classcell__rrrrr s     r csLeZdZfddZeddZeddZeddZed d ZZ S) _AdapterFunctionSurrogatecstt||||_dSr )r r r _self_adapter)rwrappedadapterrrrr7sz"_AdapterFunctionSurrogate.__init__cCst|jj|jjSr )r __wrapped____code__r!rrrrr%>s z"_AdapterFunctionSurrogate.__code__cCs|jjSr )r! __defaults__rrrrr&Dsz&_AdapterFunctionSurrogate.__defaults__cCs|jjSr )r!__kwdefaults__rrrrr'Hsz(_AdapterFunctionSurrogate.__kwdefaults__cCs t|jSr )rr!rrrr __signature__Lsz'_AdapterFunctionSurrogate.__signature__) rrrrrr%r&r'r(rrrrrr 5s    r c@s$eZdZeddZeddZdS)_BoundAdapterFunctionWrappercCst|jj|jjSr )r r$__func__ _self_parentr!rrrrr*Ss z%_BoundAdapterFunctionWrapper.__func__cCs t|jjSr )rr+r!rrrrr(Ysz*_BoundAdapterFunctionWrapper.__signature__N)rrrrr*r(rrrrr)Qs r)csPeZdZeZfddZeddZeddZeddZ ed d Z Z S) _AdapterFunctionWrappercs8|d}tt|j|i|t|j||_||_dS)Nr#)popr r,rr r$_self_surrogater!)rargskwargsr#rrrrbs z _AdapterFunctionWrapper.__init__cCs|jjSr )r.r%rrrrr%ksz _AdapterFunctionWrapper.__code__cCs|jjSr )r.r&rrrrr&osz$_AdapterFunctionWrapper.__defaults__cCs|jjSr )r.r'rrrrr'ssz&_AdapterFunctionWrapper.__kwdefaults__cCs|jjSr )r.r(rrrrr(wsz%_AdapterFunctionWrapper.__signature__) rrrr)Z__bound_function_wrapper__rrr%r&r'r(rrrrrr,^s    r,c@seZdZddZdS)AdapterFactorycCs tdSr )NotImplementedErrorrr"rrr__call__}szAdapterFactory.__call__N)rrrr4rrrrr1|sr1cs$eZdZfddZddZZS)_DelegatedAdapterFactorycstt|||_dSr )r r5rfactory)rr6rrrrsz!_DelegatedAdapterFactory.__init__cCs ||Sr )r6r3rrrr4sz!_DelegatedAdapterFactory.__call__)rrrrr4rrrrrr5s r5Nenabledr#proxycsJdur6dfdd fdd}|tdSttdSdS) a The decorator should be supplied with a single positional argument which is the `wrapper` function to be used to implement the decorator. This may be preceded by a step whereby the keyword arguments are supplied to customise the behaviour of the decorator. The `adapter` argument is used to optionally denote a separate function which is notionally used by an adapter decorator. In that case parts of the function `__code__` and `__defaults__` attributes are used from the adapter function rather than those of the wrapped function. This allows for the argument specification from `inspect.getfullargspec()` and similar functions to be overridden with a prototype for a different function than what was wrapped. The `enabled` argument provides a way to enable/disable the use of the decorator. If the type of `enabled` is a boolean, then it is evaluated immediately and the wrapper not even applied if it is `False`. If not a boolean, it will be evaluated when the wrapper is called for an unbound wrapper, and when binding occurs for a bound wrapper. When being evaluated, if `enabled` is callable it will be called to obtain the value to be checked. If `False`, the wrapper will not be called and instead the original wrapped function will be called directly instead. The `proxy` argument provides a way of passing a custom version of the `FunctionWrapper` class used in decorating the function. Ncs|rt|tr||}t|s~i}i}t|tsXt|dkrP|d}|dd}t|}td|d|||d}|r~||_t||||dS|||dS)Nz def adapterz: passr#)r"wrapperr8r#)r"r<r8) isinstancer1callablestrlenr exec__annotations__r,)r"r<r8r#ns annotations)r9rr_builds&     zdecorator.._buildcs|dur,tr,|s,fdd}|S|d}}t|turP|sL|Sd}|durntrh}q}n&t|rd|}n|t|}|||S)Ncs8}t|tur|s|Sd}fi}|||Sr )typebool)target_wrapped_enabledtarget_wrapper)rEr#r8r0r"rr_captures z-decorator.._wrapper.._capturer)rrFrG__get__)r"instancer/r0rKrHrIrJ)rEr#r8r<)r0r"r_wrappers" zdecorator.._wrapper)r#r7)NN) decoratorr)r<r8r#r9rNr)rEr#r8r9r<rrOs /0rOcs6eZdZdZddfdd ZddZdd ZZS) _StateBindingWrappera<A descriptor decorator that binds the owner instance to wrappers produced by a wrapper factory method. When applied on top of a method decorated with ``function_wrapper`` or ``decorator``, it intercepts the descriptor ``__get__`` so that when the method is accessed through an instance, the owner instance is automatically attached as an attribute on the resulting wrapper via ``__self_setattr__``. The *name* keyword argument controls the attribute name under which the owner instance is stored on the wrapper (default ``"state"``). state)namecstd||_dSr )r r _self_name)rrRrrrrs z_StateBindingWrapper.__init__cCs ||_|Sr )r$)rwrapper_factoryrrrr4sz_StateBindingWrapper.__call__cs4dur |S|j||jfdd}|S)Ncs|}||Sr )Z__self_setattr__)funcr<rMrRrTrr_binds z+_StateBindingWrapper.__get__.._bind)r$rLrS)rrMownerrWrrVrrLs  z_StateBindingWrapper.__get__)rrr__doc__rr4rLrrrrrrPs rP)N)rY functoolsrinspectrrZ __wrapt__rrrr argumentsr r r r)r,r1r5Zadapter_factoryrOrPZbind_state_to_wrapperrrrrs      :