+ BrhRt^RIt^RIt^RIt^RIt^RIt^RIt.ROt!RR]P4t ] !4t Rt Rt !RR4t]!R R!4t!RR4tR t!R R ]4tR R/R ltR RRR/RltRtRtRtRRRRRRR] P4/RltRtRtRt]P>R,P@t!Rt"R#)"z3Helpers for introspecting and wrapping annotations.NFormat ForwardRefc&]tRt^t^t^t^t^tRtR#)rN) __name__ __module__ __qualname____firstlineno__VALUEVALUE_WITH_FAKE_GLOBALS FORWARDREFSTRING__static_attributes__r*/usr/local/lib/python3.14/annotationlib.pyrrs EJ Frz!name '{name:.200}' is not definedc a]tRt^5toRt]tRRRRRRRR/R ltR tR RR RR RRRR] P/Rlt ] 3Rlt ]R4t]R4tRtRtRtRtRtRtVtR#)raWrapper that holds a forward reference. Constructor arguments: * arg: a string representing the code to be evaluated. * module: the module where the forward reference was created. Must be a string, not a module object. * owner: The owning object (module, class, or function). * is_argument: Does nothing, retained for compatibility. * is_class: True if the forward reference was created in class scope. moduleNowner is_argumentTis_classFc\V\4'g\RV: 24hWnW@nWPnW nW0nRVnRVn RVn RVn RVn R#)z*Forward reference must be a string -- got N) isinstancestr TypeError__arg____forward_is_argument____forward_is_class____forward_module__ __owner__ __globals____cell____extra_names____code__ __ast_node__)selfargrrrrs&&$$$$r__init__ForwardRef.__init__Dsj#s##HPQ Q '2$$,!"(  #  rc\R4h)zCannot subclass ForwardRefr)clsargskwdss"*,r__init_subclass__ForwardRef.__init_subclass___s455rglobalslocals type_paramsformatc T;\P8XdVP#;\P8XdRpM#\P8XdRpM \ V4hVP eVP P#Vf VPpVfDVPe6\\PPVPR4RR4pVf VPpVf\!V\"4'dL\VRR4pV'd6\PPVR4pV'd\VRR4pML\!V\$P&4'd\VRR4pM\)V4'd\VRR4pVf/pVf3/p\!V\"4'dVP+\-V44VfVe\VRR4pVe#\/V4pVFp WV P0&K VP2'd/VCVP2CpVPp V P54'd\6P8!V 4'gnW9d W*,#W9d W,#\;\<V 4'd\\<V 4#V'dV#\?\@PCV R7V R7hVPDp \GWVR 7# \dELi;i \Hd T'ghMi;i\K/\<PLCTCTTTPNTR 7p \GYT R 7p T PQ4T # \HdTu#i;i) zxEvaluate the forward reference and return the value. If the forward reference cannot be evaluated, raise an exception. FTN__dict__rr__type_params__)name)r/r0r/rrr2))rr __forward_arg__r r NotImplementedErrorr cell_contents ValueErrorrrgetattrsysmodulesgetrrtypetypes ModuleTypecallableupdatevarsdictrr! isidentifierkeyword iskeywordhasattrbuiltins NameError_NAME_ERROR_MSGr2__forward_code__eval Exception_StringifierDictr4r transmogrify)r$r/r0r1rr2is_forwardref_format module_namerparamr%code new_localsresults&$$$$$ revaluateForwardRef.evaluatebs+++',$""'+$)&11 == $ }}222 =NNE ?t66B  7 7> DG ?&&G ?%&&%e\4@  [[__[$?F")&*d"CE5#3#344!%T:%!%= ?G >F%&& d5k*  5#4"%):DAK  "7mG$*/'%    77$"6"67F""     g&7&7&<&<}{"|#3''x--%  6 6C 6 @sKK((D D&AA  @ +, */8$$//22 J dJG'')    s</K;. L ; L  L  L$ L$#L$ M33 NNc^RIp^RIpV\JdVPR4RpVP RRRR7VP VVVVVR7#) Nztyping.ForwardRef._evaluatezForwardRef._evaluatez{name} is a private API and is retained for compatibility, but will be removed in Python 3.16. Use ForwardRef.evaluate() or typing.evaluate_forward_ref() instead.)remove)r/r0r1_recursive_guardr))typingwarnings _sentinel._deprecation_warning_for_no_type_params_passed _deprecatedevaluate_forward_ref)r$globalnslocalnsr1recursive_guardrarbs&&&&$ r _evaluateForwardRef._evaluatesp ) #  A A- K " c  ** #, +  rcVPe VP#VPe2\P!VP4VnVP#\ R4h)NzDAttempted to access '__forward_arg__' on an uninitialized ForwardRef)rr#astunparseAssertionErrorr$s&rr8ForwardRef.__forward_arg__sR << #<<     (;;t'8'89DL<<  R  rcVPe VP#VPpVPR4'dRV R2pMTp\VRR4VnVP# \d\ RT: 24hi;i)N*(z,)[0]zrOz/Forward reference must be an expression -- got )r"r8 startswithcompile SyntaxError)r$r%arg_to_compiles& rrNForwardRef.__forward_code__s == $== "" >>#   U^N N Y#NJGDM}} Y OPSwWX X Ys A&&Bc\V\4'g\#VPVP8H;'Ed'VPVP8H;'EdVP VP J;'dVP VP 8H;'dVPVP8H;'dVPVP8H;'dVP'd-\\VPP444MRVP'd-\\VPP444MR8H#N) rrNotImplementedr8rrrr rr!tuplesorteditemsr$others&&r__eq__ForwardRef.__eq__s,%,,! !  E$9$9 9  ''5+C+CC    E$5$55   ))U-G-GG    /  %//1  AE@T@T@Tvd2288:;> % LL8DNN#56 7T114RWWU^4DAFFr) rr#r r"r!rrrrr)rrrr __doc___SLOTS __slots__r&r-rr rYrcrjpropertyr8rNrrrrrr__classdictcell__ __classdict__s@rrr5s I! !  !  !!66ii i  i  i||iV8A .  " $  ,,GGrca]tRtRto]tRRR/RlltRtRtRt RRlt R t R t R t R tR tRtRtV3RlRlt]!]P(!44t]!]P,!44t]!]P0!44t]!]P4!44t]!]P8!44t]!]P<!44t]!]P@!44t!]!]PD!44t#]!]PH!44t%]!]PL!44t']!]PP!44t)]!]PT!44t+]!]PX!44t-AV3RlRlt.].!]P(!44t/].!]P,!44t0].!]P0!44t1].!]P4!44t2].!]P8!44t3].!]P<!44t4].!]P@!44t5].!]PD!44t6].!]PH!44t7].!]PL!44t8].!]PP!44t9].!]PT!44t:].!]PX!44t;A.Rt<]] \2\P8\4\P:\6\P</\V4,p V !V 4V3#VPP?4p\P !VR7W/3#)rNvalue) rrr#rrmNamer!r@ _Template_template_to_astrr2rr intfloatboolcomplexConstantrFr_Stringifier__convert_to_astrDrDictlistr}setListTupleSetcreate_unique_name)r$rrkeysvalueskeyrnew_keynew_extra_names new_valueeltseltnew_elt ast_classr6s&& r__convert_to_ast_Stringifier.__convert_to_astQs$ e\ * *%,,c22xx5#5#568M8MMM%%u'<'<< < %[I %#E*D0 0  % % , , =}E{sCg>><.convs7;+/+@+@+E(".&&7r)lowerupperstep)rslicermSlicestartstoprr)r$rrrsf& @r__convert_to_ast_getitem%_Stringifier.__convert_to_ast_getitem|sn eU # #K 995;;'5::&%**%   ((/ /rcxVPp\V\4'd\P!VR7#V#)r)r#rrrmr)r$rs& r __get_ast_Stringifier.__get_asts.   dC 88t$ $ rc V/pVPeVPVP4VeVPV4\TVPVPVP VP T;'gRR7pVP PPV4V#)N)rr) r!rDrrrrr stringifiersr)r$rrr stringifiers&&& r __make_new_Stringifier.__make_news    +  " "4#7#7 8  "  " "; /"     NN  % %!66'//4   !!..55kBrc\V4#r{rrps&rr_Stringifier.__hash__s $xrcVPR8Xd\h\V\4'd^/p.pVF<pVP V4wrVVeVP V4VP V4K> \P!V4pMVP V4wr\V\P4'gQ\V44hVP\P!VP4V4V4#r)r#KeyErrorrr}$_Stringifier__convert_to_ast_getitemrDrrmrrrepr_Stringifier__make_new Subscript_Stringifier__get_ast)r$rrrrrrs&& r __getitem___Stringifier.__getitem__s    /N eU # #KD+/+H+H+M(".&&7 G$  IIdOE!%!>!>u!E E%))64;6)s}}T^^-=uE{SSrcjVP\P!VP4V44#r{)rrm Attributer)r$attrs&&r __getattr___Stringifier.__getattr__s#s}}T^^-=tDEErc/p.pVF<pVPV4wrgVeVPV4VPV4K> .pVP4FRwrVPV 4wrVeVPV4VP\P !W44KT VP \P!VP4WH4V4#r{) rrDrrrmrHrCallr) r$r+kwargsrast_argsr%new_argr ast_kwargsrrrs &*, r__call___Stringifier.__call__s C'+'<')>u)E &I*""?3   ckk#9 : ) sxx(8(OQ\]]rc#x"VP\P!VP444xR#5ir{)rrmStarredrrps&r__iter___Stringifier.__iter__s$oockk$..*:;<.binops@#44U; C?? $..*B4k rr)rrsf r _make_binop_Stringifier._make_binops   rc4<V^8dQhRS[P/#rr)r2rs"rrr srcaV3RlpV#)c<VPV4wr#VP\P!VSVP 44V4#r{r )r$r new_otherrrs&& rrbinop)_Stringifier._make_rbinop..rbinops@%)%:%:5%A "I?? )R)9:K rr)rrsf r _make_rbinop_Stringifier._make_rbinops   rcaV3RlpV#)c<VPV4wr#VP\P!VP 4S.V.R7V4#))leftops comparators)rrrmComparerrs&& rcompare+_Stringifier._make_compare..comparesL#44U; C?? )!$   rr)rr"sf r _make_compare_Stringifier._make_compares rcaV3RlpV#)cl<VP\P!SVP444#r{)rrmUnaryOpr)r$rs&runary_op-_Stringifier._make_unary_op..unary_op's$??3;;r4>>3C#DE Err)rr)sf r_make_unary_op_Stringifier._make_unary_op&s Fr) rr#r r"r!rrrrrr)NNFNr{)Rrrrr rrr&rrrrrrrrrrrrrmAdd__add__Sub__sub__Mult__mul__MatMult __matmul__Div __truediv__Mod__mod__LShift __lshift__RShift __rshift__BitOrrBitXor__xor__BitAnd__and__FloorDiv __floordiv__Pow__pow__r__radd____rsub____rmul__ __rmatmul__ __rtruediv____rmod__ __rlshift__ __rrshift__r__rxor____rand__ __rfloordiv____rpow__r$Lt__lt__LtE__le__EqrNotEq__ne__Gt__gt__GtE__ge__r+Invert __invert__UAdd__pos__USub__neg__rrrs@rrr2sI554)4V0( &T&F^ =. T#'')$G#'')$G#((*%GS[[]+Jcggi(K#'')$GSZZ\*JSZZ\*J  %F#**,'G#**,'Gs||~.L#'')$GCGGI&HCGGI&HCHHJ'Hs{{}-K *LCGGI&Hszz|,Kszz|,K399;'GCJJL)HCJJL)H 0MCGGI&H 3668 $F 3779 %F 3668 $F 399; 'F 3668 $F 3779 %F   -JSXXZ(GSXXZ(Grrc .pVFpV\Rc;e+wVP\P!VR74K9\P!VP \P !VP 4VPe\VP4MRVPR8wd"\P!VPR7MRR7pVPV4K \P!VR7#)rNrr)rr conversionr)r) rrrmr Interpolation expressionparserdordr TemplateStr)templaterpartinterps& rrr3s F cll67**))DOO4 ??6DOO, ++r1 4+;+;<!  f%)* ??& ))rcTaa]tRtRtoRRRRRR/V3RlltRtR tR tR tVt V;t #) rQiMr/NrrFc~<\SV`V4WnW nW0nW@n.Vn^VnWPnR#)N) superr& namespacer/rrrnext_idr2)r$rrr/rrr2 __class__s&&$$$$rr&_StringifierDict.__init__Ns8 #"     rc\VVPVPVPVR7pVPP V4V#))r/rrr)rr/rrrr)r$rfwdrefs&& r __missing___StringifierDict.__missing__XsB LL**]]!     ( rcVPFOp\VnRVn\ VP \ 4'gK7VP VnRVnKQ R#r{)rrrtrrr#rr)r$rs& rrR_StringifierDict.transmogrifycsI$$C&CM'+C $#**C00!.. #' %rcXRVP R2pV;P^, unV#)__annotationlib_name___)rs)r$r6s& rr#_StringifierDict.create_unique_nameks'&t||nB7   r)r2r/rrrrsrr) rrrr r&rxrRrrr __classcell__)rtrs@@rrQrQMs3T (rrQrc\WVRR7#)zCall an evaluate function. Evaluate functions are normally generated for the value of type aliases and the bounds, constraints, and defaults of type parameter objects. T)r _is_evaluate)call_annotate_function)rYr2rs&&$rcall_evaluate_functionrqs "(%d SSrrFc V\P8Xd \R4hV!V4# \dMi;iT\P8Xd\ /TR7p\ T\4p\YYTRR7p\P!TPTTTPTPR7pT!\P4pT'd \T4#TP4U U u/uFwrT \T 4bK up p #uup p iT\P 8XEd/TP"CTP$Cp \ T\4p\ T TP$TTTR7p\YYTRR7p\P!TPTTTPTPR7pT!\P4p TP'4T # \(dMi;i\ /TP$TTTR7p\YYTRR7p\P!TPTTTPTPR7pT!\P4p TP'4T'd9\ T \*4'd!T P-\P R7#T #T P4U U u/uF>wrT \ T \*4'd!T P-\P R7MT bK@ up p #uup p iT\P.8Xd \1R4h\R T: 24h) aZCall an __annotate__ function. __annotate__ functions are normally generated by the compiler to defer the evaluation of annotations. They can be called with any of the format arguments in the Format enum, but compiler-generated __annotate__ functions only support the VALUE format. This function provides additional functionality to call __annotate__ functions with the FORWARDREF and STRING formats. *annotate* must be an __annotate__ function, which takes a single argument and returns a dict of annotations. *format* must be a member of the Format enum or one of the corresponding integer values. *owner* can be the object that owns the annotations (i.e., the module, class, or function that the __annotate__ function derives from). With the FORWARDREF format, it is used to provide better evaluation capabilities on the generated ForwardRef objects. ;The VALUE_WITH_FAKE_GLOBALS format is for internal use only)r2F)allow_evaluation)closureargdefs kwdefaultsr7Tz/annotate function does not support VALUE formatzInvalid format: )rr r;r9r rQrr@_build_closurerA FunctionTyper" __defaults____kwdefaults___stringify_singlerr __builtins__rrRrPrrYr RuntimeError) annotater2rrr/rrfuncannosrvalrrrXs &&$$ rrrys(///VWW      #2f5eT* X !!    ))..  V334 $U+ +"KKM ) "3' ')    6$$ $$Fx,,E0D0DE eT*" ((  ! X !!    ))..   &889F  "M    # ((  ! X !!    ))..  f445 &*--f.?.?@@ !'   !/HC !#z22LL(9(9L: !/   6<< LMM+F:677s+* 880D 3G G)(G)ALc VP'gR#VPPp.p\VP4FwrxV\ V48d WW,p MRp Rp V'dVP Tp V fM\V VVVPVVR7p VPPV 4\P!V 4p VPV 4K \V4# \ dL}i;i)Nr )rrr/rr) __closure__r" co_freevars enumeratelenr:r;rrrrrACellTyper}) rrrrrfreevars new_closureirr6new_cellrws &&&&$ rrrs      ,,HKX112 s8} ;DD  ""   ! ,,!!1 F  ) ) 0 0 8~~f-H8$132  !  s- C++ C98C9cVRJdR#\V\4'dV#\V\4'd \P!\ V44#\ V4#)....)rrrrmrnrr)annos&rrr'sJ s{ D#   D) $ ${{+D122Dzrc\VR,# \dTPRR4u#i;i)zRetrieve the annotate function from a class namespace dictionary. Return None if the namespace does not contain an annotate function. This is useful in metaclass ``__new__`` methods to retrieve the annotate function. r__annotate_func__N)rr?)rs&r!get_annotate_from_class_namespacer3s3 2>"" 2ww*D112s  ++r/r0eval_strr2c 0V'd!V\P8wd \R4hT;\P8Xd\V4pVf\ W4pM;\P 8Xd9\V4pVe \ V4#\ W4pVf\V4pMy;\P8Xd6\ W4pVe \ V4#\V4pVe;\V4#\P8Xd \R4h\RV: 24hVf9\V\4'g\V4'd/#\V: R24hV'g/#V'g \ V4#VeVEfs\V\4'ddRp\VRR4pV'd6\ P"P%VR4pV'd\VRR4p\ \'V44p Tp MY\V\(P*4'd\VR4pRp Rp M(\V4'd\VRR4pRp Tp MR;p;rV e\-V R 4'dV P.p K!\ P"P%R 4;p 'd*\WP04'dV P2p Kq\-T R4'd T P4pVfTpVfT p\VR R 4;p 'd*Vf/pV U u/uFqP6V bK up V,pVP94UUu/uF*wrT\V\:4'gTM \=WV4bK, pppV# \dELi;iuup iuuppi) aCompute the annotations dict for an object. obj may be a callable, class, module, or other object with __annotate__ or __annotations__ attributes. Passing any other object raises TypeError. The *format* parameter controls the format in which annotations are returned, and must be a member of the Format enum or its integer equivalent. For the VALUE format, the __annotations__ is tried first; if it does not exist, the __annotate__ function is called. The FORWARDREF format uses __annotations__ if it exists and can be evaluated, and otherwise falls back to calling the __annotate__ function. The SOURCE format tries __annotate__ first, and falls back to using __annotations__, stringified using annotations_to_string(). This function handles several details for you: * If eval_str is true, values of type str will be un-stringized using eval(). This is intended for use with stringized annotations ("from __future__ import annotations"). * If obj doesn't have an annotations dict, returns an empty dict. (Functions and methods always have an annotations dict; classes, modules, and other types of callables may not.) * Ignores inherited annotations on classes. If a class doesn't have its own annotations dict, returns an empty dict. * All accesses to object members and dict values are done using getattr() and dict.get() for safety. * Always, always, always returns a freshly-created dict. eval_str controls whether or not values of type str are replaced with the result of calling eval() on those values: * If eval_str is true, eval() is called on values of type str. * If eval_str is false (the default), values of type str are unchanged. globals and locals are passed in to eval(); see the documentation for eval() for more information. If either globals or locals is None, this function may replace that value with a context-specific default, contingent on type(obj): * If obj is a module, globals defaults to obj.__dict__. * If obj is a class, globals defaults to sys.modules[obj.__module__].__dict__ and locals defaults to the obj class namespace. * If obj is a callable, globals defaults to obj.__globals__, although if obj is a wrapped function (using functools.update_wrapper()) it is first unwrapped. z8eval_str=True is only supported with format=Format.VALUENrzUnsupported format z does not have annotationsrr4r __wrapped__ functoolsr5r)rr r;_get_dunder_annotations_get_and_call_annotater rFrPr annotations_to_stringr rr@rCrr<r=r>r?rErArBrJrpartialrrrrrrO)rr/r0rr2ann obj_globalsrTr obj_localsunwraprr1rUrr return_values&$$$$ rget_annotationsr?s2jFfll*STT  V\\)#.C{,S9 V   %-c2?9$#)5C{.c2 V]](5CCy )#.C,S11  + +Z[ [ 26*=> > { c4 HSMMI3'!;<==  Cy&. c4 K!#|T:Kd;")&*d"CKd3iJF U-- . .!#z2KJF c]]"#}d;KJF04 4K 4*  6=11#//F #  <<9<!&*;*;<F c#4b99{9 >F5@A[E..%'[AFJ))+%JC *UC00Ud566RR% }  pBs2 M;N 0N; N  N cp\V\\P\P34'd9VP R8Xd VP #VP RVP 2#\V\4'd"\V4p\P!V4#VRJdR#\V4#)aConvert a Python value to a format suitable for use with the STRING format. This is intended as a helper for tools that support the STRING format but do not have access to the code that originally produced the annotations. It uses repr() for most objects. rK..r) rr@rArBuiltinFunctionTyperrrrrmrnr)rtrees& r type_reprrs%$ 2 2E4M4MNOO   z )%% %""#1U%7%7$899 E9 % %&{{4   | ;rc VP4UUu/uF)wrT\V\4'dTM \V4bK+ upp#uuppi)zwConvert an annotation dict containing values to approximately the STRING format. Always returns a fresh a dictionary. )rrrr) annotationsnts& rrrsK %%' 'DA 1c""1 ! 4'  s/Ac\VRR4pVe5\W!VR7p\V\4'g\ V: R24hV#R#)zOGet the __annotate__ function and call it. May not return a fresh dictionary. rN)rz!.__annotate__ returned a non-dict)r<rrrFr;)rr2rrs&& rrrsL sND1H$XSA#t$$w&GHI I r__annotations__c\V\4'd\V4pM\ VRR4pVfR#\V\ 4'g\ V: R24hV# \dR#i;i)zmReturn the annotations for an object, checking that it is a dictionary. Does not return a fresh dictionary. Nrz+.__annotations__ is neither a dict nor None)rr@_BASE_GET_ANNOTATIONSAttributeErrorr<rFr;)rrs& rrrsr#t ',C c,d3 ; c4 C7"MNOO J  s A A-,A-)rrrrrrrr) rrr __weakref__rrr!r"r#r rr)rr)#rrmrKenumrHr=rA__all__IntEnumrobjectrcrMrrr@rrrrFrQrrrrrr rrrrr4__get__rrrrrrs9    T\\ H 5  wGwGt I ~~B*4!t!HTdTJ8dJ8J8ZB  2bb!%b05b>DllbJ(  &78@@r