j[$ dZddlmZmZmZmZddlmZddlm Z m Z m Z m Z ddl mZmZmZeZdZdZd Zd Zd ZGd d e ZGddZGddee ZGdde ZGddee Z dddddddZy)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)BaseObjectProxyBoundFunctionWrapperCallableObjectProxyFunctionWrapper)_BOUND_DOC_PROPERTY _DOC_PROPERTY_NO_DOC_OVERRIDEcPdjdfd}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__`. _self_cached__ct|t}|tur#|j}|j||SN)getattr_MISSING_derive__self_setattr__)selfvalueattrslots Y/home/spazio/kingdom_calls/work5/transenv/lib/python3.12/site-packages/wrapt/signature.pygetterz_cached..getter&s<dH- H LL&E  ! !$ . )lstripproperty)rrrs` @r_cachedr"s-4;;s+, -D F rc|jjDcic]5}|jtjur|j |j7}}|j tjur|j |d<|Scc}w)Nreturn) parametersvalues annotationremptynamereturn_annotationr)sigpanns r_derive_annotationsr.0sx&&(  <z#_derive_defaults..<sI 66i//1P1PQ Q IIY__ , sAA )tupler%r&)r+defaultss r_derive_defaultsr:;s3&&(H  trc|jjDcic]Q}|jtjur3|j tj ur|j|j S}}|xsdScc}wr)r%r&r1r KEYWORD_ONLYr4r(r))r+r, kwdefaultss r_derive_kwdefaultsr>Esn&&( 66Y++ + 0P  J   sAA;cggg}}}dx}}|jjD]}|jtjur|j |j ;|jtjur|j |j s|jtjur |j }|jtjur|j |j |jtjus|j }||z|z}|r|j ||r|j |t|Sr) r%r&r1rr2appendr)r3VAR_POSITIONALr< VAR_KEYWORDr8)r+pos_only pos_or_kwkw_onlyvar_posvar_kwr,namess r_derive_varnamesrINs #%r2iHGf ^^ " " $  66Y.. . OOAFF # VVy66 6   QVV $ VVy// /ffG VVy-- - NN166 " VVy,, ,VVF  y 7 *E W  V <rcxeZdZdZfdZdZedZedZedZ edZ edZ xZ 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__. c2t||||_yrsuper__init___self_signaturerwrappedr __class__s rrOz_SignatureCode.__init__k !(rc|j}|dk(rLtjtjft fd|j j DS|dk(r*t d|j j DS|dk(r*t d|j j DS|dk(r t|S|dk(r|j j Dchc]}|jc}|jjttzz}tjvr |tz}tjvr |tz}|St|cc}w) N co_argcountc3:K|]}|jvywr)r1)r6r,kindss rr7z)_SignatureCode._derive..ssH1qvvHsco_posonlyargcountc3TK|] }|jtju"ywr)r1rr2r5s rr7z)_SignatureCode._derive..us$89)333&(co_kwonlyargcountc3TK|] }|jtju"ywr)r1rr<r5s rr7z)_SignatureCode._derive..ys$56)000r[ co_varnamesco_flags)rPrr2r3sumr%r&rIr1 __wrapped__r_rrrArBAttributeError)rrr+r,flagsrXs @rrz_SignatureCode._deriveosM"" = .. 0O0OPEH0E0E0GHH H ' '=@^^=R=R=T  & &:=..:O:O:Q  = #C( ( : %(^^%:%:%<=QVV=E$$--*~2M0NNE''50#$$-'LT"">s.E,rVrYr\r^r_) __name__ __module__ __qualname____doc__rOrr"rVrYr\r^r_ __classcell__rSs@rrKrKdsJ )#2-(K !56 34-(Kz"HrrKcfeZdZdZdZedZedZedZ edZ edZ y) _SignatureMixinzEShared Signature-derived introspection attrs for wrapper + surrogate.c|j}|dk(r t|S|dk(r t|S|dk(r t|S|dk(r t |j j |St|)N__annotations__ __defaults____kwdefaults____code__)rPr.r:r>rKrarprb)rrr+s rrz_SignatureMixin._derivest"" $ $&s+ + > !#C( ( # #%c* * : !$"2"2";";SA AT""rc|jSr)rPrs r __signature__z_SignatureMixin.__signature__s###rrmrnrorpN) rdrerfrgrr!rsr"rmrnrorprrrkrksJO #$$/0O>*L-.Nz"Hrrkc"eZdZdZfdZxZS)_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. c2t||||_yrrMrQs rrOz$_SignatureFunctionSurrogate.__init__rTr)rdrerfrgrOrhris@rrvrvs))rrvc0eZdZeZedZedZy)_BoundSignatureFunctionWrappercjt|jj|jjSr)rvra__func__ _self_parentrPrrs rr{z'_BoundSignatureFunctionWrapper.__func__s,*    % %t'8'8'H'H  rc.|jjSr)r|rPrrs rrsz,_BoundSignatureFunctionWrapper.__signature__s  000rN)rdrerfr rgr!r{rsrtrrryrys-!G   11rryc:eZdZeZeZeffd Ze dZ xZ S)_SignatureFunctionWrappercBt|||||_||_yr)rNrOrP _self_doc)rrRwrapperrdocrSs rrOz"_SignatureFunctionWrapper.__init__s! '*(rcBt|j|jSr)rvrarPrrs rr{z"_SignatureFunctionWrapper.__func__s*4+;+;T=Q=QRRr) rdrerfrrgry__bound_function_wrapper__rrOr!r{rhris@rrrs,G!?8H SSrrN) prototyperfactoryrctdfD}|dk(r td|dkDr tdfd}||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, or a tuple of `(signature_or_prototype, docstring)` to override the docstring at the same time. The docstring may also be overridden by supplying `doc`, in which case a docstring from the factory is ignored. When neither is supplied the wrapper reports the docstring of the wrapped function as normal. 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. c3$K|]}|du ywrrt)r6xs rr7z!with_signature..sKaATMKsrzBwith_signature requires one of prototype=, signature=, or factory=rzFwith_signature accepts only one of prototype=, signature=, or factory=cd}tn}  }nL t}n>|}t|tr |\}}|}t|tr|n t|}t ||||S)Nc||i|Srrt)rRinstanceargskwargss r_wrapperz4with_signature.._decorator.._wrappersD+F+ +r)r_inspect_signature isinstancer8rr) rRr resolved_docresolvedproduced produced_docrrrrs r _decoratorz"with_signature.._decorators ,,/;'C   H  "))4Hw'H(E*)1&,;#/Lh 2'1  )(HlSSr)r` TypeError)rRrrrr specifiedrs ```` rwith_signaturersj0KIy'+JKKIA~ P  1} T  T0 g rr)rginspectrrrrrr __wrapt__r r r r rr rrobjectrr"r.r:r>rIrKrkrvryrrrtrrrsED3 FE 8.,(#_(#V##2 )/3F ) 1%9 1 S S <"&$$<r