˔jK&dZddlmZddlmZmZddlmZmZm Z m Z ddl m Z Gdde Z Gd d e ZGd d eZGd de ZGddZGddeZeZddde ddZGddeZeZdS)zoThis module implements decorators for implementing other decorators as well as some commonly used decorators. )partial)isclass signature)BaseObjectProxyBoundFunctionWrapperCallableObjectProxyFunctionWrapper) formatargspecceZdZfdZedZedZedZedZedZ xZ S)_AdapterFunctionCodecftt||||_dSN)superr __init___self_adapter_code)self wrapped_code adapter_code __class__s >C:\Projects\DSCons\.venv\Lib\site-packages\wrapt/decorators.pyrz_AdapterFunctionCode.__init__s2 "D))22<@@@".c|jjSr)r co_argcountrs rrz _AdapterFunctionCode.co_argcount &22rc|jjSr)rco_coders rrz_AdapterFunctionCode.co_code$s&..rc|jjSr)rco_flagsrs rr z_AdapterFunctionCode.co_flags(s&//rc|jjSr)rco_kwonlyargcountrs rr"z&_AdapterFunctionCode.co_kwonlyargcount,s&88rc|jjSr)r co_varnamesrs rr$z _AdapterFunctionCode.co_varnames0rr) __name__ __module__ __qualname__rpropertyrrr r"r$ __classcell__rs@rr r s/////33X3//X/00X099X933X33333rr cveZdZfdZedZedZedZedZxZ S)_AdapterFunctionSurrogatecftt||||_dSr)rr,r _self_adapter)rwrappedadapterrs rrz"_AdapterFunctionSurrogate.__init__7s2 '..77@@@$rcJt|jj|jjSr)r __wrapped____code__r.rs rr3z"_AdapterFunctionSurrogate.__code__>s%#   %t'9'B   rc|jjSr)r. __defaults__rs rr5z&_AdapterFunctionSurrogate.__defaults__Ds!..rc|jjSr)r.__kwdefaults__rs rr7z(_AdapterFunctionSurrogate.__kwdefaults__Hs!00rc*t|jSr)rr.rs r __signature__z'_AdapterFunctionSurrogate.__signature__Ls+,,,r) r%r&r'rr(r3r5r7r9r)r*s@rr,r,5s%%%%%  X //X/11X1--X-----rr,c:eZdZedZedZdS)_BoundAdapterFunctionWrappercJt|jj|jjSr)r,r2__func__ _self_parentr.rs rr=z%_BoundAdapterFunctionWrapper.__func__Ss%(   %t'8'F   rc4t|jjSr)rr>r.rs rr9z*_BoundAdapterFunctionWrapper.__signature__Ys*8999rN)r%r&r'r(r=r9rrr;r;QsH   X ::X:::rr;czeZdZeZfdZedZedZedZ edZ xZ S)_AdapterFunctionWrapperc|d}tt|j|i|t |j||_||_dS)Nr0)poprrBrr,r2_self_surrogater.)rargskwargsr0rs rrz _AdapterFunctionWrapper.__init__bs\**Y'' 6%t,,5tFvFFF89I7SS$rc|jjSr)rEr3rs rr3z _AdapterFunctionWrapper.__code__ks#,,rc|jjSr)rEr5rs rr5z$_AdapterFunctionWrapper.__defaults__os#00rc|jjSr)rEr7rs rr7z&_AdapterFunctionWrapper.__kwdefaults__ss#22rc|jjSr)rEr9rs rr9z%_AdapterFunctionWrapper.__signature__ws#11r) r%r&r'r;__bound_function_wrapper__rr(r3r5r7r9r)r*s@rrBrB^s!=%%%%%--X-11X133X322X22222rrBceZdZdZdS)AdapterFactoryctr)NotImplementedErrorrr/s r__call__zAdapterFactory.__call__}s!###rN)r%r&r'rRr@rrrNrN|s#$$$$$rrNc$eZdZfdZdZxZS)_DelegatedAdapterFactorycdtt|||_dSr)rrTrfactory)rrVrs rrz!_DelegatedAdapterFactory.__init__s+ &--66888 rc,||Sr)rVrQs rrRz!_DelegatedAdapterFactory.__call__s||G$$$r)r%r&r'rrRr)r*s@rrTrTsG %%%%%%%rrTNenabledr0proxyc!dfd fd}|tSttS)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. Nc|rt|tr ||}t|smi}i}t|ts.t |dkr|d}|dd}t |}t d|d|||d}|r||_t||||S|||S)Nz def adapterz: passr0)r/wrapperrYr0)r/r_rY) isinstancerNcallablestrlenr exec__annotations__rB)r/r_rYr0ns annotationsrZs r_buildzdecorator.._builds# g~66/%gg..G((>B#%K%gs33:w<<1,,*1"+K&-crclG"/"96w666B??? mG #>2=/.#Wgw5'7KKK Krc||tr |s  fd}|S|d} }t|tur|s|Sd}|tr }nL }nIt|r d|}n# |t|}||| S)Ncl}t|tur|s|Sd}di}|||S)Nr@)typebool)target_wrapped_enabledtarget_wrapperrhr0rYrGr/s r_capturez-decorator.._wrapper.._captures] 'HH~~--'2#11#'&-W%6%6v%6%6N"6..(GTTTrr)rrkrl__get__) r/instancerFrGrprmrnrorhr0rYr_s ` ` r_wrapperzdecorator.._wrappers*GG$4$4T UUUUUUUUU2  "!WN HH~~%%*)) 7##(-,&-WYYNN$&-NN8$$/O.&-__T8%D%DNN0&-__XtH~~%N%NN6..(GLL Lr)r0rX)NN) decoratorr)r_rYr0rZrsrhs```` @rrtrts4& L& L& L& L& L& L^f Mf Mf Mf Mf Mf Mf Mf M^vgx;;;;y'7%PPPPrc4eZdZdZddfd ZdZdZxZS)_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)namecXtd||_dSr)rr_self_attr_name)rrxrs rrz_StateBindingWrapper.__init__s+ #rc||_|Sr)r2)rwrapper_factorys rrRz_StateBindingWrapper.__call__s+ rcf|S|j||jfd}|S)NcJ|}||Sr)__self_setattr__)funcr_rrrxr|s r_bindz+_StateBindingWrapper.__get__.._binds/%od++G  $ $T8 4 4 4Nr)r2rqrz)rrrownerrrxr|s ` @@rrqz_StateBindingWrapper.__get__s^  K *228UCC#        r)r%r&r'__doc__rrRrqr)r*s@rrvrvso   '$$$$$$$rrvr)r functoolsrinspectrr __wrapt__rrr r argumentsr r r,r;rBrNrTadapter_factoryrtrvbind_state_to_wrapperr@rrrs &&&&&&&& %$$$$$33333.333<----- 3---8 : : : : :#7 : : :22222o222<$$$$$$$$ %%%%%~%%%+DQ$ODQDQDQDQDQb77777?777t-r