3 d Z ddlmZ ddlZddlZddlZddlZddlmZm Z ddl
m Z ddl Z ddl
mZmZ ddlmZ ddlmZ ej d k rdd
l
mZ ndd
lmZ e d Z ed Ze j d
Z G d d Zd Z e j d Z e j d Z ej r d d dZ d d dZ!dS d d dZ d d d Z!dS ) z(A few useful function/method decorators. ) annotationsN)Callable Generator)TypeVar)_cacheutil)InferenceContext)InferenceError)
) ParamSpec_R_Pc t |dd }|(i x|_ }t j | || S # t
$ r | |i |x|| < }|cY S w xY w)z>Simple decorator to cache result of method calls without args.__cacheN)getattrr r
CACHE_MANAGERadd_dict_cacheKeyError)funcinstanceargskwargscacheresults d/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/astroid/decorators.pycachedr s
Hi . .E }#%%5 ++E222T{ #tT 4V 4 44d f
s A A! A!c : e Zd ZdZdZd Zed ZddZdS )cachedpropertya Provides 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
)wrappedc t j dk r t j dt d |j n%# t $ r}t | d |d }~ww xY w|| _ d S )N)r z}cachedproperty has been deprecated and will be removed in astroid 3.0 for Python 3.8+. Use functools.cached_property instead.
stacklevelz must have a __name__ attribute) sys version_infowarningswarnDeprecationWarning__name__AttributeError TypeErrorr )selfr excs r __init__zcachedproperty.__init__@ s v % % M9"
R R R Rw G G GHHc Q R s 6
A AAc F t | j dd }d|rd|z ndz S )N__doc__z+%sz
%s )r r )r. docs r r2 zcachedproperty.__doc__N s2 dlIt44< 'FSLLR
Nc n || S | | }t || j j | |S N)r setattrr+ )r. instobjtypevals r __get__zcachedproperty.__get__U s9 <Kll4 dl+S111
r5 r7 )r+
__module__ __qualname__r2 __slots__r0 propertyr< r5 r r r / sc I
X
r5 r c H t j | 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 | Nonereturnr c ; K |t }| | rdS t } || |fi |D ]9}|j j dk r|j }n|}||vr|V | | :dS )z"Wrapper function handling context.NInstance)r pushset __class__r+ _proxiedadd)noderC _funcr yieldedresaress r r z path_wrapper..wrappedd s
?&((G << F%%5w11&11 " "C}%33|7"" D!!! " "r5 )rC rD rE r functoolswraps)r r s r path_wrapperrU ] s> _T15T" " " " "* Nr5 c # K | |i |} t | V n # t $ r t j V Y d S w xY w|E d {V d S r7 )next
StopIterationr Uninferable)r r r r generators r yes_if_nothing_inferredr[ } s d%f%%I9oo
s ::c # 6 K | |i |} t | V ns# t $ r4}|j rt di |j d |t d |d }~wt $ r*}t dt j d |d }~ww xY w|E d {V d S )Nr z3StopIteration raised without any error information.z!RecursionError raised with limit .rA )rW rX r r
RecursionErrorr& getrecursionlimit)r r r r rZ errors r raise_if_nothing_inferredra s d%f%%I
9oo : = 115:a=11u < A
J0E0G0G J J J
s
B/A
B$%B B3.0astroid_versionstr argumentsrE .Callable[[Callable[_P, _R]], Callable[_P, _R]]c d fd }|S )a Decorator 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.
r Callable[_P, _R]rE c N t j d fd }|S ) Decorator function.r _P.argsr _P.kwargsrE r c ` t t j j } D ]\ }} | | }n5# t $ r( t d| d| d j j d dw xY w||v r|| 8||vrx|dk s.t | |k st | |k rL| | Dt j d| d| d j j dj
d d
| d | d
t d
| i |S )z/Emit DeprecationWarnings if conditions are met.Can't find argument '' for 'r 'Nz#' will be a required argument for 'r] z
' in astroid z ('z' should be of type: 'z')r# r$ listinspect signature
parameterskeysitemsindex
ValueErrorrJ r> lenr( r) r+ r* ) r r rw argtype_annotationry re rc r s r wrapperz@deprecate_default_argument_values..deco..wrapper s G -d 3 3 > C C E EFF,5OO,=,= (C $ $
3% $ $ $ ( aC a aQ@Q@^ a a a #$$ 6#;+> f,, !RKK "4yyE 1 1 #D E 1 1d5k6I !
P P P $Q 1 > P PAE P P+: P P "% P P =L P P P /'(
tT,V,,, A**2B r rk r rl rE r rR r r~ re rc s ` r decoz/deprecate_default_argument_values..deco sK _T
"
"#
- #
- #
- #
- #
- #
- #
- #
"#
-J Nr5 r rh rE rh rA rc re r s `` r !deprecate_default_argument_valuesr s/ ) ) ) ) ) ) ) V r5 c d fd }|S )a Decorator 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.
r rh rE c N t j d fd }|S ) Nr rk r rl rE r c t t j j } D ]\ }} | | }n5# t $ r( t d| d| d j j d d w xY w||v st | |k rAt j d| d| d j j dj
d d| d t d
| i |S ) Nrn ro r rp zThe argument 'r] z/' is deprecated and will be removed in astroid z ()r# r$ rr ) r r rw r| notery re rc r s r r~ z2deprecate_arguments..deco..wrapper sc G -d 3 3 > C C E EFF!* !2!2 IC$ $
3% $ $ $ ( aC a aQ@Q@^ a a a #$$ f}}D E(9(9
YS Y Y $Q 1 > Y YAE Y Y>M Y YQU Y Y Y /'( tT,V,,,r r rR r s ` r r z!deprecate_arguments..deco sH
_T
"
"
-
-
-
-
-
-
- #
"
-& Nr5 r rA r s `` r deprecate_argumentsr s. . r5 c dd}|S )bPassthrough decorator to improve performance if DeprecationWarnings are
disabled.
r rh rE c | S rj rA r s r r z/deprecate_default_argument_values..deco Kr5 r rA r s r r r
r5 c dd}|S )r r rh rE c | S r rA r s r r z!deprecate_arguments..deco r r5 r rA r s r r r r r5 )rb )rc rd re rd rE rf )"r2
__future__r rS rt r& r( collections.abcr r typingr wraptastroidr r astroid.contextr astroid.exceptionsr
r' r
typing_extensionsr r decoratorr r rU r[ ra check_warnings_filterr r rA r5 r r s8
/ . " " " " " "
/ / / / / / / / , , , , , , - - - - - -w ++++++ WT]]Yt__
+ + + + + + + +\ @
. 4 %; ; ; ; ;| %$ $ $ $ $ $ $R % % r5