o 2hcR@sdZddlZddlmZddlmZmZddlmZm Z ddl m Z m Z m Z ddlmZGd d d e ZGd d d e ZGd dde ZGddde ZGdddZGdddeZeZddde dddZddZee_dS)zoThis module implements decorators for implementing other decorators as well as some commonly used decorators. N)partial)isclass signature)LockRLock)BoundFunctionWrapperCallableObjectProxyFunctionWrapper) formatargspeccsXeZdZfddZeddZeddZeddZed d Zed d Z Z S) _AdapterFunctionCodectt||||_dSN)superr __init___self_adapter_code)self wrapped_code adapter_code __class__K/var/www/html/chatgem/venv/lib/python3.10/site-packages/wrapt/decorators.pyr z_AdapterFunctionCode.__init__cC|jjSr)r co_argcountrrrrrz _AdapterFunctionCode.co_argcountcCrr)rco_coderrrrrrz_AdapterFunctionCode.co_codecCrr)rco_flagsrrrrr"rz_AdapterFunctionCode.co_flagscCrr)rco_kwonlyargcountrrrrr &rz&_AdapterFunctionCode.co_kwonlyargcountcCrr)r co_varnamesrrrrr!*rz _AdapterFunctionCode.co_varnames) __name__ __module__ __qualname__rpropertyrrrr r! __classcell__rrrrr s     r csLeZdZfddZeddZeddZeddZed d ZZ S) _AdapterFunctionSurrogatecr r)rr'r _self_adapter)rwrappedadapterrrrr1rz"_AdapterFunctionSurrogate.__init__cCst|jj|jjSr)r __wrapped____code__r(rrrrr,5 z"_AdapterFunctionSurrogate.__code__cCrr)r( __defaults__rrrrr.;rz&_AdapterFunctionSurrogate.__defaults__cCrr)r(__kwdefaults__rrrrr/?rz(_AdapterFunctionSurrogate.__kwdefaults__cCsdtvr |jjSt|jSNr)globalsr( __signature__rrrrrr2Cs  z'_AdapterFunctionSurrogate.__signature__) r"r#r$rr%r,r.r/r2r&rrrrr'/s    r'c@s$eZdZeddZeddZdS)_BoundAdapterWrappercCst|jj|jjSr)r'r+__func__ _self_parentr(rrrrr4Mr-z_BoundAdapterWrapper.__func__cCsdtvr |jjSt|jjSr0)r1r+r2rr5r(rrrrr2Ss  z"_BoundAdapterWrapper.__signature__N)r"r#r$r%r4r2rrrrr3Ks  r3csPeZdZeZfddZeddZeddZeddZ ed d Z Z S) AdapterWrappercs8|d}tt|j|i|t|j||_||_dS)Nr*)poprr6rr'r+_self_surrogater()rargskwargsr*rrrr_s  zAdapterWrapper.__init__cCrr)r8r,rrrrr,erzAdapterWrapper.__code__cCrr)r8r.rrrrr.irzAdapterWrapper.__defaults__cCrr)r8r/rrrrr/mrzAdapterWrapper.__kwdefaults__cCrr)r8r2rrrrr2qrzAdapterWrapper.__signature__) r"r#r$r3__bound_function_wrapper__rr%r,r.r/r2r&rrrrr6[s    r6c@seZdZddZdS)AdapterFactorycCstr)NotImplementedErrorrr)rrr__call__wszAdapterFactory.__call__N)r"r#r$r?rrrrr<vs r<cs$eZdZfddZddZZS)DelegatedAdapterFactorycstt|||_dSr)rr@rfactory)rrArrrr|s z DelegatedAdapterFactory.__init__cCs ||Sr)rAr>rrrr?s z DelegatedAdapterFactory.__call__)r"r#r$rr?r&rrrrr@{s r@enabledr*proxycsFdurdfdd fdd}|tdSttdS) 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|rGt|tr ||}t|s?i}i}t|ts,t|dkr(|d}|dd}t|}td|d|||d}|r?||_t||||dS|||dS)Nz def adapterz: passr*)r)wrapperrCr*)r)rGrC) isinstancer<callablestrlenr exec__annotations__r6)r)rGrCr*ns annotations)rDrr_builds&    zdecorator.._buildcs|durtr|sfdd}|S|d}}t|tur(|s&|Sd}|dur7tr4}n}nt|rBd|}n|t|}|||S)Ncs8}t|tur|s |Sd}di}|||S)Nr)typebool)target_wrapped_enabledtarget_wrapper)rPr*rCr:r)rr_captures z-decorator.._wrapper.._capturer)rrQrR__get__)r)instancer9r:rVrSrTrU)rPr*rCrG)r:r)r_wrappers" zdecorator.._wrapper)r*rB)NN) decoratorr)rGrCr*rDrYr)rPr*rCrDrGrrZs /0rZcszt|dr#t|dr#|tfdd}Gfdddt}||dSdd fd d }Gfd d d t}|||dS)aDepending on the nature of the `wrapped` object, will either return a decorator which can be used to wrap a function or method, or a context manager, both of which will act accordingly depending on how used, to synchronize access to calling of the wrapped function, or the block of code within the context manager. If it is an object which is a synchronization primitive, such as a threading Lock, RLock, Semaphore, Condition, or Event, then it is assumed that the object is to be used directly as the synchronization primitive, otherwise a lock is created automatically and attached to the wrapped object and used as the synchronization primitive. acquirereleasecs6||i|WdS1swYdSrrr)rXr9r:lockrr _synchronizeds $z#synchronized.._synchronizedcs$eZdZfddZfddZdS)z'synchronized.._PartialDecoratorcs Sr)r[rr^rr __enter__sz1synchronized.._PartialDecorator.__enter__cs dSr)r\rr9r^rr__exit__s z0synchronized.._PartialDecorator.__exit__Nr"r#r$rarcrr^rr_PartialDecorators re)r)cSs~t|dd}|dur=tj&t|dd}|dur-t}t|d|Wd|SWd|S1s8wY|S)N_synchronized_lock)varsget synchronized_synchronized_meta_lockrsetattr)contextr_rrrrfs      z(synchronized.._synchronized_lockcsF|dur|n|||i|WdS1swYdSrrr]rfrr_synchronized_wrappers $z+synchronized.._synchronized_wrappercs eZdZfddZddZdS)z%synchronized.._FinalDecoratorcs|j|_|j|jSr)r+ _self_lockr[rrmrrras  z/synchronized.._FinalDecorator.__enter__cWs|jdSr)ror\rbrrrrcsz.synchronized.._FinalDecorator.__exit__Nrdrrmrr_FinalDecorators  rp)r)rG)hasattrrZr r )r)r`rernrpr)rfr_rris   rir)__doc__sys functoolsrinspectrr threadingrr __wrapt__rr r argumentsr r r'r3r6r<r@adapter_factoryrZrirjrrrrs&     j