o{荜 d Z ddlmZ ddlmZmZ ddlmZ ddlZddlm Z ddl
m Z ddl m
Z
dd lmZmZmZ dd
lmZ ej ej e j e j fZ G d d e
ZdS )
z+Checker mixin for deprecated functionality. ) annotations) ContainerIterable)chainN)nodes)utils) BaseChecker)get_import_name infer_all
safe_infer)MessageDefinitionTuplec e Zd ZU dZdddddgddfiZd ed
< d d d
ddgddfiZd ed< dddddgddfiZd ed< dddddgddfiZd ed < d d d d d!gddfiZ d ed"< e
j d
dd dDd' Z e
j dd dEd) Z
dFd+Z e
j d dGd- Z e
j dd dHd/ ZdId1ZdJd5ZdFd6ZdKd8ZdLd;ZdMd>ZdNdAZdDdBZdCS )ODeprecatedMixinzA mixin implementing logic for checking deprecated symbols.
A class implementing mixin must define "deprecated-method" Message.
W4901zDeprecated module %rdeprecated-modulez*A module marked as deprecated is imported.)W0402zold-deprecated-moduleT) old_namessharedz!dict[str, MessageDefinitionTuple]DEPRECATED_MODULE_MESSAGEW4902z Using deprecated method %s()deprecated-methodzEThe method is marked as deprecated and will be removed in the future.)W1505zold-deprecated-methodDEPRECATED_METHOD_MESSAGEW4903z+Using deprecated argument %s of method %s()deprecated-argumentzGThe argument is marked as deprecated and will be removed in the future.)W1511zold-deprecated-argumentDEPRECATED_ARGUMENT_MESSAGEW4904z&Using deprecated class %s of module %sdeprecated-classzDThe class is marked as deprecated and will be removed in the future.)W1512zold-deprecated-classDEPRECATED_CLASS_MESSAGEW4905z Using deprecated decorator %s()deprecated-decoratorzHThe decorator is marked as deprecated and will be removed in the future.)W1513zold-deprecated-decorator DEPRECATED_DECORATOR_MESSAGEnode
nodes.CallreturnNonec | | t |j D ]}| || dS )z2Called when a :class:`nodes.Call` node is visited.N) check_deprecated_class_in_callr funccheck_deprecated_method)selfr& inferreds l/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pylint/checkers/deprecated.py
visit_callzDeprecatedMixin.visit_callO sT
++D111!$),, 9 9H ( (x 8 8 8 8 9 9 nodes.Importc d |j D D ]M}| || d|v r1| dd \ }}| |||f NdS )z+Triggered when an import statement is seen.c 3 K | ] \ }}|V
d S N .0name_s r0 z/DeprecatedMixin.visit_import..a s& 44gdAT444444r2 . N)namescheck_deprecated_modulesplitcheck_deprecated_class)r. r& r: mod_name
class_names r0 visit_importz DeprecatedMixin.visit_import[ s 54444 K KD ( (t 4 4 4d{{'+zz#q'9'9$*++D(ZMJJJ K Kr2
Iterable[str]c dS )zCallback returning the deprecated decorators.
Returns:
collections.abc.Container of deprecated decorator names.
r7 r7 r. s r0 deprecated_decoratorsz%DeprecatedMixin.deprecated_decoratorsh rr2 nodes.Decoratorsc t | }|sdS t |d t j rt |d j }nt |d }|r| nd}|| v r| d|| dS dS )z-Triggered when a decorator statement is seen.Nr r# r& args)
list get_children
isinstancer Callr r, qnamerI add_message)r. r& childreninfrS s r0 visit_decoratorsz DeprecatedMixin.visit_decoratorsp s ))++,, F hqk5: . . * Xa[ -..CC Xa[))C ", D..00 0 0 3$U K K K K K 1 0r2 nodes.ImportFromc |j }t || }| || d |j D }| ||| dS )z(Triggered when a from statement is seen.c 3 K | ] \ }}|V
d S r6 r7 r8 s r0 r< z3DeprecatedMixin.visit_importfrom.. s& 66at666666r2 N)modnamer
r@ r? rB )r. r& basename class_namess r0 visit_importfromz DeprecatedMixin.visit_importfrom~ sc <"422 $$T8444664:666 ##D(K@@@@@r2 Container[str]c dS )zCallback returning the deprecated methods/functions.
Returns:
collections.abc.Container of deprecated function/method names.
r7 r7 rH s r0 deprecated_methodsz"DeprecatedMixin.deprecated_methods rJ r2 methodstr Iterable[tuple[int | None, str]]c dS )aP Callback returning the deprecated arguments of method/function.
Args:
method (str): name of function/method checked for deprecated arguments
Returns:
collections.abc.Iterable in form:
((POSITION1, PARAM1), (POSITION2: PARAM2) ...)
where
* POSITIONX - position of deprecated argument PARAMX in function definition.
If argument is keyword-only, POSITIONX should be None.
* PARAMX - name of the deprecated argument.
E.g. suppose function:
.. code-block:: python
def bar(arg1, arg2, arg3, arg4, arg5='spam')
with deprecated arguments `arg2` and `arg4`. `deprecated_arguments` should return:
.. code-block:: python
((1, 'arg2'), (3, 'arg4'))
r7 r7 )r. rb s r0 deprecated_argumentsz$DeprecatedMixin.deprecated_arguments s 0 rr2 c dS )zCallback returning the deprecated modules.
Returns:
collections.abc.Container of deprecated module names.
r7 r7 rH s r0 deprecated_modulesz"DeprecatedMixin.deprecated_modules rJ r2 modulec dS )zCallback returning the deprecated classes of module.
Args:
module (str): name of module checked for deprecated classes
Returns:
collections.abc.Container of deprecated class names.
r7 r7 )r. ri s r0 deprecated_classesz"DeprecatedMixin.deprecated_classes s rr2 mod_path
str | Nonec | D ]:}||k s|r0| |dz r| d|| ;dS )z#Checks if the module is deprecated.r= r rM N)rh
startswithrT )r. r& rl rC s r0 r@ z'DeprecatedMixin.check_deprecated_module sp //11 P PH8##x#H4G4GSV4W4W# !44h OOO P Pr2 r/ nodes.NodeNGc t |t sdS t |j t j r
|j j }n.t |j t j r
|j j }ndS | |h}t fd|D r
d||f dS t |j }|j
rd |j
D ni } fd|D }t | D ]F\ }} | |v r
d|| |f $| ||k r
d|| |f GdS )zExecutes the checker for the given node.
This method should be called from the checker implementing this mixin.
Nc 3 D K | ]}| v V d S r6 )ra )r9 r: r. s r0 r< z:DeprecatedMixin.check_deprecated_method.. s4 DDTtt..000DDDDDDr2 r rM c h | ] }|j
S r7 )arg)r9 kws r0 z:DeprecatedMixin.check_deprecated_method.. s 111R"&111r2 c 3 B K | ]} | V d S r6 )rf )r9 qnr. s r0 r< z:DeprecatedMixin.check_deprecated_method.. s1 O O" 9 9" = = O O O O O Or2 r )rQ ACCEPTABLE_NODESr, r AttributeattrnameNamer: rS anyrT lenrN keywordsr )
r. r& r/ func_nameqnames num_of_argskwargsrf positionarg_names
` r0 r- z'DeprecatedMixin.check_deprecated_method s ($455 F di 1 1 *II
5:
.
. II
F..""I. DDDDVDDD D D 0t9, O O O F$)nn 59]J114=1111 O O O O O O O "')=">
Hh6!! )Hi;P ! %([*@*@ )Hi;P !
r2 rC r] c r |D ]3}|| | v r| d|||f 4dS )z"Checks if the class is deprecated.r rM N)rk rT )r. r& rC r] rD s r0 rB z&DeprecatedMixin.check_deprecated_class s`
& JT 4 4X > >>> &TX8N ! r2 c t |j t j r[t |j j t j r9|j j j }|j j }| |||f dS dS dS )z$Checks if call the deprecated class.N) rQ r, r rz exprr| r: r{ rB )r. r& rC rD s r0 r+ z.DeprecatedMixin.check_deprecated_class_in_call s di 1 1 Gj INEJ7
7
G y~*H +J ' 'h
F F F F F G G G Gr2 N)r& r' r( r) )r& r3 r( r) )r( rF )r& rK r( r) )r& rX r( r) )r( r_ )rb rc r( rd )ri rc r( rF )r& r3 rl rm r( r) )r& r' r/ rp r( r) )r& rp rC rc r] rF r( r) )__name__
__module__ __qualname____doc__r __annotations__r r r! r% r only_required_for_messagesr1 rE rI rW r^ ra rf rh rk r@ r- rB r+ r7 r2 r0 r r s " 8=>$ O O
D * S=>$ O O
D 9 ! U?@D Q Q
F 4 R<= N N
C - " V@AT R R
G &U%
9 9 9
9 &U% K K K K &U%&<== L L L >= L &U% A A A A 4
P P P P # # # #J G G G G G Gr2 r )r
__future__r collections.abcr r itertoolsr astroidr pylint.checkersr pylint.checkers.base_checkerr pylint.checkers.utilsr
r r
pylint.typingr
BoundMethod
UnboundMethod FunctionDefClassDefry r r7 r2 r0 r s!
2 1 " " " " " " / / / / / / / / ! ! ! ! ! ! 4 4 4 4 4 4 H H H H H H H H H H 0 0 0 0 0 0 N bG bG bG bG bGk bG bG bG bG bGr2