a `*jN!@sdZddlmZmZmZmZddlmZddlm Z m Z m Z m Z e ZddZdd Zd d Zd d ZddZGddde ZGdddZGdddee ZGddde ZGdddee ZdddddddZdS)aThe `with_signature` decorator: override the signature (and related introspection attributes) of a wrapped callable without mutating the wrapped function itself. Accepts a prototype callable, a prebuilt `inspect.Signature`, or a factory that derives a signature from the wrapped function at decoration time. This replaces the need for the `adapter=` argument of `wrapt.decorator`, which is planned for deprecation. ) CO_VARARGSCO_VARKEYWORDS Parameter Signature) signature)BaseObjectProxyBoundFunctionWrapperCallableObjectProxyFunctionWrappercs&ddfdd}t|S)aQRead-only property that memoizes its derivation in a `_self_*` slot. `functools.cached_property` is unusable on ObjectProxy subclasses: wrapt overrides `__dict__` with a property returning the wrapped object's dict, so cached_property's `instance.__dict__[name] = value` would mutate the wrapped function. Storing under a `_self_*` name routes through wrapt's own setattr handling and lands in the proxy's real instance dict. Using a `@property` (data descriptor) also ensures we win over any value copied into the instance dict by `FunctionWrapper.__init__`. Z _self_cached__cs.t|t}|tur*|}|||SN)getattr_MISSING_deriveZ__self_setattr__)selfvalueattrZslotK/var/www/html/assistant/venv/lib/python3.9/site-packages/wrapt/signature.pygetter%s    z_cached..getter)lstripproperty)rrrrr_cacheds rcCs.dd|jD}|jtjur*|j|d<|S)NcSs"i|]}|jtjur|j|jqSr) annotationremptyname.0prrr 0s z'_derive_annotations..return) parametersvaluesreturn_annotationrr)sigannrrr_derive_annotations/s   r(cCs tdd|jD}|pdS)Ncss2|]*}|jtjtjfvr|jtjur|jVqdSr )kindrPOSITIONAL_ONLYPOSITIONAL_OR_KEYWORDdefaultrrrrr ;s z#_derive_defaults..)tupler#r$)r&defaultsrrr_derive_defaults:sr0cCsdd|jD}|pdS)NcSs.i|]&}|jtjur|jtjur|j|jqSr)r)r KEYWORD_ONLYr,rrrrrrr!Esz&_derive_kwdefaults..)r#r$)r& kwdefaultsrrr_derive_kwdefaultsDsr3cCsggg}}}d}}|jD]x}|jtjur@||jq"|jtjurZ||jq"|jtjurn|j}q"|jtj ur||jq"|jtj ur"|j}q"|||}|r|||r||t |Sr ) r#r$r)rr*appendrr+VAR_POSITIONALr1 VAR_KEYWORDr.)r&Zpos_onlyZ pos_or_kwZkw_onlyZvar_posZvar_kwr namesrrr_derive_varnamesMs&        r8csPeZdZdZfddZddZedZedZedZ ed Z ed Z Z S) _SignatureCodezCode-object proxy deriving argument-related co_* attrs from a Signature. Non-argument bits (co_flags for coroutine/generator, co_filename, etc.) fall through to the wrapped function's real __code__. cst|||_dSr super__init___self_signaturerwrappedr __class__rrr<js z_SignatureCode.__init__cs|j}|dkr6tjtjftfdd|jDS|dkrVtdd|jDS|dkrvtdd|jDS|dkrt|S|d krd d |jD|jj t t B@}tj vr|t O}tj vr|t O}|St|dS) N co_argcountc3s|]}|jvVqdSr r)rkindsrrr-rz)_SignatureCode._derive..co_posonlyargcountcss|]}|jtjuVqdSr )r)rr*rrrrr-tsco_kwonlyargcountcss|]}|jtjuVqdSr )r)rr1rrrrr-xs co_varnamesco_flagscSsh|] }|jqSrrCrrrr ~rFz)_SignatureCode._derive..)r=rr*r+sumr#r$r8 __wrapped__rJrrr5r6AttributeError)rrr&flagsrrDrrns.   z_SignatureCode._deriverBrGrHrIrJ) __name__ __module__ __qualname____doc__r<rrrBrGrHrIrJ __classcell__rrr@rr9cs r9c@sDeZdZdZddZeddZedZedZ edZ ed Z d S) _SignatureMixinzEShared Signature-derived introspection attrs for wrapper + surrogate.cCsX|j}|dkrt|S|dkr&t|S|dkr6t|S|dkrLt|jj|St|dS)N__annotations__ __defaults____kwdefaults____code__)r=r(r0r3r9rMrYrN)rrr&rrrrsz_SignatureMixin._derivecCs|jSr )r=rrrr __signature__sz_SignatureMixin.__signature__rVrWrXrYN) rPrQrRrSrrr[rrVrWrXrYrrrrrUs  rUcs eZdZdZfddZZS)_SignatureFunctionSurrogateaFunction surrogate exposing Signature-derived introspection attrs. Used as __func__ of a bound wrapper so that inspect.signature -- which treats the bound wrapper as a MethodType and consults __func__ -- sees our override and strips self/cls correctly. cst|||_dSr r:r>r@rrr<s z$_SignatureFunctionSurrogate.__init__)rPrQrRrSr<rTrrr@rr\sr\c@s$eZdZeddZeddZdS)_BoundSignatureFunctionWrappercCst|jj|jjSr )r\rM__func__ _self_parentr=rZrrrr^s z'_BoundSignatureFunctionWrapper.__func__cCs|jjSr )r_r=rZrrrr[sz,_BoundSignatureFunctionWrapper.__signature__N)rPrQrRrr^r[rrrrr]s r]cs,eZdZeZfddZeddZZS)_SignatureFunctionWrappercst||||_dSr r:)rr?wrapperrr@rrr<sz"_SignatureFunctionWrapper.__init__cCst|j|jSr )r\rMr=rZrrrr^sz"_SignatureFunctionWrapper.__func__) rPrQrRr]Z__bound_function_wrapper__r<rr^rTrrr@rr`s r`N) prototyperfactorycs\tddfD}|dkr(td|dkr8tdfdd}|d urT|S||S) aOverride the signature of a wrapped callable. Exactly one of `prototype`, `signature`, or `factory` must be supplied: - `prototype`: a callable whose signature will be used. - `signature`: a prebuilt `inspect.Signature` object. - `factory`: a callable `factory(wrapped)` invoked at decoration time that returns either a `Signature` or a prototype callable. The resulting wrapper exposes the override via `__signature__`, and derives `__annotations__`, `__defaults__`, `__kwdefaults__`, and the argument-related attributes of `__code__` from the same source. The wrapped function is not mutated. Calling behaviour is unchanged. css|]}|duVqdSr r)rxrrrr-rFz!with_signature..rzBwith_signature requires one of prototype=, signature=, or factory=rzFwith_signature accepts only one of prototype=, signature=, or factory=csRdd}dur}n0dur(t}n|}t|tr>|nt|}t|||S)NcSs||i|Sr r)r?instanceargskwargsrrr_wrappersz4with_signature.._decorator.._wrapper)_inspect_signature isinstancerr`)r?rhZresolvedZproducedrcrbrrr _decorators z"with_signature.._decoratorN)rL TypeError)r?rbrrcZ specifiedrlrrkrwith_signaturesrn)N)rSinspectrrrrrriZ __wrapt__rr r r objectrrr(r0r3r8r9rUr\r]r`rnrrrrs     +