c&dZddlmZddlZddlZddlZddlZddlmZm Z ddl m Z ddl Z ddl mZmZddlmZddlmZejd krdd l mZndd lmZe d Zed Ze jd ZGddZdZe jdZe jdZejr dddZ dddZ!dS dddZ dddZ!dS)z(A few useful function/method decorators.) annotationsN)Callable Generator)TypeVar)_cacheutil)InferenceContext)InferenceError) ) ParamSpec_R_Pct|dd}|(ix|_}tj| ||S#t $r||i|x||<}|cYSwxYw)z>Simple decorator to cache result of method calls without args.__cacheN)getattrrr CACHE_MANAGERadd_dict_cacheKeyError)funcinstanceargskwargscacheresults 2lib/python3.11/site-packages/astroid/decorators.pycachedrs Hi . .E 3#%%5++E222T{ #tT4V444d f sAA! A!c:eZdZdZdZdZedZddZdS)cachedpropertyaProvides a cached property equivalent to the stacking of @cached and @property, but more efficient. After first usage, the becomes part of the object's __dict__. Doing: del obj. empties the cache. Idea taken from the pyramid_ framework and the mercurial_ project. .. _pyramid: http://pypi.python.org/pypi/pyramid .. _mercurial: http://pypi.python.org/pypi/Mercurial )wrappedctjdkrtjdt |jn%#t $r}t|d|d}~wwxYw||_dS)N)r z}cachedproperty has been deprecated and will be removed in astroid 3.0 for Python 3.8+. Use functools.cached_property instead.z must have a __name__ attribute) sys version_infowarningswarnDeprecationWarning__name__AttributeError TypeErrorr )selfr excs r__init__zcachedproperty.__init__@s  v %  M9"     R     R R RwGGGHHc Q R s4 AAAcFt|jdd}d|rd|zndzS)N__doc__z+%sz %s)rr )r+docs rr/zcachedproperty.__doc__Ms2dlIt44< 'FSLLR  Ncn||S||}t||jj||SN)r setattrr()r+instobjtypevals r__get__zcachedproperty.__get__Ts<  Kll4  dl+S111 r2r4)r( __module__ __qualname__r/ __slots__r-propertyr9r2rrr/sc  I     X r2rcHtj|d|fdd}|S)zReturn the given infer function wrapped to handle the path. Used to stop inference if the node has already been looked at for a given `InferenceContext` to prevent infinite recursion NcontextInferenceContext | Nonereturnrc;K|t}||rdSt}|||fi|D]9}|jjdkr|j}n|}||vr|V||:dS)z"Wrapper function handling context.NInstance)r pushset __class__r(_proxiedadd)noder@_funcryieldedresaress rr zpath_wrapper..wrappedcs  )&((G <<    F%%5w11&11 " "C}%3 |7" "  D!!! " "r2)r@rArBr functoolswraps)rr s r path_wrapperrR\s>_T15T"""""* Nr2c#K||i|} t|Vn#t$rtjVYdSwxYw|Ed{VdSr4)next StopIterationr Uninferable)rrrr generators ryes_if_nothing_inferredrX|sd%f%%I9oo  s ::c#6K||i|} t|Vns#t$r4}|jrtdi|jd|td|d}~wt$r*}tdt jd|d}~wwxYw|Ed{VdS)Nrz3StopIteration raised without any error information.z!RecursionError raised with limit .r>)rTrUrr RecursionErrorr#getrecursionlimit)rrrrrWerrors rraise_if_nothing_inferredr^sd%f%%I 9oo  : = 115:a=11u < A     J0E0G0G J J J    s  B/A B$%B  B3.0astroid_versionstr argumentsrB.Callable[[Callable[_P, _R]], Callable[_P, _R]]c dfd }|S)aDecorator which emits a DeprecationWarning if any arguments specified are None or not passed at all. Arguments should be a key-value mapping, with the key being the argument to check and the value being a type annotation as string for the value of the argument. To improve performance, only used when DeprecationWarnings other than the default one are enabled. rCallable[_P, _R]rBcNtjdfd }|S) Decorator function.r_P.argsr _P.kwargsrBrc\ttjj}D]\}} ||}n5#t$r(td|d|djj ddwxYw||vr||8||vrv|dks.t||kst||krJ||Btj d|d|djj dj d d |d |d t|i|S) z/Emit DeprecationWarnings if conditions are met.Can't find argument '' for 'r'Nz#' will be a required argument for 'rZz ' in astroid z ('z' should be of type: 'z')listinspect signature parameterskeysitemsindex ValueErrorrGr;lenr%r&r(r') rrrtargtype_annotationrvrbr`rs rwrapperz@deprecate_default_argument_values..deco..wrappersG-d33>CCEEFF,5OO,=,=(C$ $ 3%$$$(aCaaQ@Q@^aaa#$$,2#;f,"RK #4yyE1!$D E 17;5k ! PPP $Q 1 >PPAEPP+:PP"%PP=LPPP/ tT,V,,, A**2BrrhrrirBrrOrr{rbr`s` rdecoz/deprecate_default_argument_values..decosK_T " "" -" -" -" -" -" -" -# "" -HNr2rrerBrer>r`rbrs`` r!deprecate_default_argument_valuesrs/ ( ( ( ( ( ( ( T r2c dfd }|S)aDecorator which emits a DeprecationWarning if any arguments specified are passed. Arguments should be a key-value mapping, with the key being the argument to check and the value being a string that explains what to do instead of passing the argument. To improve performance, only used when DeprecationWarnings other than the default one are enabled. rrerBcNtjdfd }|S) NrrhrrirBrcttjj}D]\}} ||}n5#t$r(td|d|djj ddwxYw||vst||kr?tj d|d|djj dj dd|d t|i|S) NrkrlrrmzThe argument 'rZz/' is deprecated and will be removed in astroid z ()ro) rrrtrynotervrbr`rs rr{z2deprecate_arguments..deco..wrappers`G-d33>CCEEFF!*!2!2  IC$ $ 3%$$$(aCaaQ@Q@^aaa#$$f}D E(9 YSYY $Q 1 >YYAEYY>MYYQUYYY/  tT,V,,,r|r}rOr~s` rrz!deprecate_arguments..decosH _T " " - - - - - - -# " -$Nr2rr>rs`` rdeprecate_argumentsrs.       , r2c dd}|S)bPassthrough decorator to improve performance if DeprecationWarnings are disabled. rrerBc|Srgr>rs rrz/deprecate_default_argument_values..decoKr2rr>rs rrr     r2c dd}|S)rrrerBc|Srr>rs rrz!deprecate_arguments..decorr2rr>rs rrrrr2)r_)r`rarbrarBrc)"r/ __future__rrPrqr#r%collections.abcrrtypingrwraptastroidrrastroid.contextr astroid.exceptionsr r$r typing_extensionsrr decoratorrrrRrXr^check_warnings_filterrrr>r2rrs: /."""""" //////// ,,,,,,------w,       ++++++ WT]]Yt__   ********Z@   .4} %:::::z %#######P %      %       r2