e%dZddlmZddlmZmZddlmZddlZddlm Z ddl m Z ddl m Z dd lmZmZmZdd lmZej(ej*e j,e j.fZGd d e Zy) z+Checker mixin for deprecated functionality.) annotations) ContainerIterable)chainN)nodes)utils) BaseChecker)get_import_name infer_all safe_infer)MessageDefinitionTupleceZdZUdZdddddgddfiZd ed <d d d ddgddfiZd ed<dddddgddfiZd ed<dddddgddfiZd ed<dddd d!gddfiZ d ed"<e jd ddd1d#Z e jddd2d$Z d3d%Ze jdd4d&Ze jddd5d'Zd6d(Zd7d)Zd3d*Zd8d+Zd9d,Zd:d-Z d;d.Zd1d/Zy0)<DeprecatedMixinzA 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_MESSAGEW4902zUsing 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_MESSAGEW4905zUsing deprecated decorator %s()deprecated-decoratorzHThe decorator is marked as deprecated and will be removed in the future.)W1513zold-deprecated-decoratorDEPRECATED_DECORATOR_MESSAGEc~|j|t|jD]}|j||y)z2Called when a :class:`nodes.Call` node is visited.N)check_deprecated_class_in_callr funccheck_deprecated_method)selfnodeinferreds z/DeprecatedMixin.visit_import..as4gdAT4.N)namescheck_deprecated_modulesplitcheck_deprecated_class)r*r+r6mod_name class_names r- visit_importzDeprecatedMixin.visit_import[s^ 54 KD  ( (t 4d{'+zz#q'9$*++D(ZMJ  Kr/cy)zCallback returning the deprecated decorators. Returns: collections.abc.Container of deprecated decorator names. r3r3r*s r-deprecated_decoratorsz%DeprecatedMixin.deprecated_decoratorsh r/c:t|j}|syt|dtjrt |dj }nt |d}|r|jnd}||jvr|jd||yy)z-Triggered when a decorator statement is seen.Nrr#r+args) list get_children isinstancerCallr r(qnamerE add_message)r*r+childreninfrNs r-visit_decoratorsz DeprecatedMixin.visit_decoratorsps))+,  hqk5:: .Xa[--.CXa[)C"  D..0 0   3$U  K 1r/c|j}t||}|j||d|jD}|j |||y)z(Triggered when a from statement is seen.c3&K|] \}}| ywr2r3r4s r-r8z3DeprecatedMixin.visit_importfrom..s6at6r9N)modnamer r=r<r?)r*r+basename class_namess r-visit_importfromz DeprecatedMixin.visit_importfrom~sI <<"42 $$T8464::6  ##D(K@r/cy)zCallback returning the deprecated methods/functions. Returns: collections.abc.Container of deprecated function/method names. r3r3rDs r-deprecated_methodsz"DeprecatedMixin.deprecated_methodsrFr/cy)aPCallback 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')) r3r3)r*methods r-deprecated_argumentsz$DeprecatedMixin.deprecated_argumentss0r/cy)zCallback returning the deprecated modules. Returns: collections.abc.Container of deprecated module names. r3r3rDs r-deprecated_modulesz"DeprecatedMixin.deprecated_modulesrFr/cy)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. r3r3)r*modules r-deprecated_classesz"DeprecatedMixin.deprecated_classessr/c|jD]3}||k(s|s |j|dzs |jd||5y)z#Checks if the module is deprecated.r:rrHN)r_ startswithrO)r*r+mod_pathr@s r-r=z'DeprecatedMixin.check_deprecated_modulesN//1 PH8#xH4G4GSV4W  !44h O Pr/ct|tsyt|jtjr|jj }n.sDTtt..00DsrrHc3@K|]}j|ywr2)r])r5qnr*s r-r8z:DeprecatedMixin.check_deprecated_method..sO" 9 9" =Osr)rLACCEPTABLE_NODESr(r AttributeattrnameNamer6rNanyrOlenrIkeywordsargr) r*r+r, func_nameqnames num_of_argskwkwargsr]positionarg_names ` r-r)z'DeprecatedMixin.check_deprecated_methods>($45  dii 1 **I  5:: . I .."I. DVD D   0t9,  O $))n 59]]4==1R"&&1OO"')=">  Hh6!  )Hi;P!%([*@  )Hi;P! 2s5E#cf|D],}||j|vs|jd|||f.y)z"Checks if the class is deprecated.rrHN)rbrO)r*r+r@rWrAs r-r?z&DeprecatedMixin.check_deprecated_classsE & JT44X>>  &TX8N! r/c@t|jtjrzt|jjtj rK|jjj }|jj}|j|||fyyy)z$Checks if call the deprecated class.N) rLr(rrkexprrmr6rlr?)r*r+r@rAs r-r'z.DeprecatedMixin.check_deprecated_class_in_callsn dii 1j IINNEJJ7 yy~~**H++J  ' 'h F 7 1r/N)r+ nodes.CallreturnNone)r+ nodes.Importr}r~)r} Iterable[str])r+znodes.Decoratorsr}r~)r+znodes.ImportFromr}r~)r}zContainer[str])r\strr}z Iterable[tuple[int | None, str]])rarr}r)r+rrez str | Noner}r~)r+r|r, nodes.NodeNGr}r~)r+rr@rrWrr}r~)__name__ __module__ __qualname____doc__r__annotations__rrr!r%ronly_required_for_messagesr.rBrErRrXrZr]r_rbr=r)r?r'r3r/r-rrs  "  8=>$ O  D@  *  S=>$ O  D@  9 ! U?@D Q  F!B  4  R<= N  C?  - " V@AT R  G "C&U%% 9  9&U%%K K&U%%&<= L> L&U%%A A4 P #J   ,/ >K   Gr/r)r __future__rcollections.abcrr itertoolsrastroidrpylint.checkersrpylint.checkers.base_checkerr pylint.checkers.utilsr r r pylint.typingr BoundMethod UnboundMethod FunctionDefClassDefrjrr3r/r-rsd 2"/!4HH0    NN bGkbGr/