e!zdZddlmZddlZddlZddlZddlZddlmZm Z ddl m Z ddl m Z ddlmZddlmZdd lmZej(d k\rdd l mZndd lmZe d Zed ZdZ ddZ ddZe j8r d ddZ d ddZy d ddZ d ddZy)z(A few useful function/method decorators.) annotationsN)Callable Generator)TypeVar)util)InferenceContext)InferenceError)InferenceResult) ) ParamSpec_R_PcJtj|d|f dd}|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 Nc;K| t}|j|ryt}|||fi|D]D}|jjdk(r |j }n|}||vs0||j |Fyw)z"Wrapper function handling context.NInstance)rpushset __class____name___proxiedadd)nodecontext_funckwargsyieldedresaress 4/usr/lib/python3/dist-packages/astroid/decorators.pywrappedzpath_wrapper..wrapped%s ?&(G <<  %w1&1 "C}}%%3||7"  D! "s A"A=%A=)rzInferenceContext | Nonereturnr functoolswraps)funcr!s r path_wrapperr's;__T15T"." ""* Nc dfd }|S)Nc?K|i|} t||Ed{y#t$rtjYywxYw7&w)N)next StopIterationr Uninferable)argsr generatorr&s r innerz&yes_if_nothing_inferred..innerAsW$)&)  y/ !   "" "   s/ A %AAAAAAAr._P.argsr _P.kwargsr"z&Generator[InferenceResult, None, None]r&r0s` r yes_if_nothing_inferredr6>s'  "+  /  Lr(c dfd }|S)Nc?2K|i|} t||Ed{y#t$r6}|jrtdi|jd|td|d}~wt$r'}tdt j d|d}~wwxYw7uw)Nrz3StopIteration raised without any error information.z!RecursionError raised with limit .r4)r+r,r.r RecursionErrorsysgetrecursionlimit)r.rr/errorr&s r r0z(raise_if_nothing_inferred..innerUs$)&)  y/ ! zz$5uzz!}55@ E   3C4I4I4K3LAN   s: B %BBB B1A B+"B  BBr1r4r5s` r raise_if_nothing_inferredr>Rs'"+ /( Lr(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. cJtjdfd }|S)Decorator function.cNttjjj }j D]\}} |j |}||vr||-||vs&|dk(s#t||kst||kDsH||Ntjd|d|djjdjd d |d |d td |i|S#t$r+td|d|djjddwxYw)z/Emit DeprecationWarnings if conditions are met.Can't find argument '' for 'r'Nz#' will be a required argument for 'r9z ' in astroid z ('z' should be of type: 'z') stacklevellistinspect signature parameterskeysitemsindex ValueErrorr __qualname__lenwarningswarnrDeprecationWarning) r.rrOargtype_annotationrQ argumentsastroid_versionr&s r wrapperz@deprecate_default_argument_values..deco..wrappersYG--d3>>CCEF,5OO,=(C$ $ 36#;+> f,!RK"4yE1 #D E 1d5k6I! u% $Q 1 1 > >?qP++:*;T,V,,9&$(3C5Q@Q@Q@^@^?__`a#$$s C004D$r.r2rr3r"rr#r&r\rZr[s` r decoz/deprecate_default_argument_values..decos(__T "# -## -JNr(r&Callable[_P, _R]r"rar4r[rZr_s`` r !deprecate_default_argument_valuesrcqs ) V r(c 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. cJtjdfd }|S)Ncttjjj }j D]w\}} |j |}||vst||kDs+tjd|d|djjdjdd|d td y|i|S#t$r+td|d|djjddwxYw) NrCrDrrEzThe argument 'r9z/' is deprecated and will be removed in astroid z ()rGrHrJ) r.rrOrXnoterQrZr[r&s r r\z2deprecate_arguments..deco..wrappersG--d3>>CCEF!*!2IC$ $ 3 f}D E(9 ,SE2 $Q 1 1 > >?qP>>M=NbQUPVVWY/'( T,V,,&$(3C5Q@Q@Q@^@^?__`a#$$s C  4C>r]r#r^s` r r_z!deprecate_arguments..decos% __T " -# -&Nr(r`r4rbs`` r deprecate_argumentsris . r(c dd}|S)bPassthrough decorator to improve performance if DeprecationWarnings are disabled. c|SrAr4r&s r r_z/deprecate_default_argument_values..decoKr(r`r4rbs r rcrc  r(c dd}|S)rkc|Srmr4rns r r_z!deprecate_arguments..decoror(r`r4rbs r ririrpr()r&4Callable[_P, Generator[InferenceResult, None, None]]r"rs)z3.0)r[strrZrtr"z.Callable[[Callable[_P, _R]], Callable[_P, _R]])__doc__ __future__rr$rLr;rUcollections.abcrrtypingrastroidrastroid.contextrastroid.exceptionsr astroid.typingr version_infor typing_extensionsrrr'r6r>check_warnings_filterrcrir4r(r rs /" /,-*w + T]t_@ >9( >9:4 %;;36; 7;| %$$36$ 7$R %  36  7  %  36  7 r(