yIfx+dZddlmZddlmZmZddlmZddlZddlm Z ddl m Z ddl m Z dd lmZdd lmZmZmZdd lmZdd lmZejeje je jejfZGd deZdS)z+Checker mixin for deprecated functionality.) annotations) ContainerIterable)chainN)nodes)Instance)utils) BaseChecker)get_import_name infer_all safe_infer) INFERENCE)MessageDefinitionTuplec@eZdZUdZddddddifiZded <d d d d dgddfiZded<dddddgddfiZded<dddddgddfiZded<dddd d!gddfiZ ded"<d#d$d%d&d'gddfiZ ded(<e j ddNd-Z e j ddddOd/Ze j d ddPd1ZdQd3Ze j d%dRd5Ze j d ddSd7ZdTd9ZdUd=ZdQd>ZdVd@ZdQdAZdNdBZdWdEZdXdHZdYdKZdOdLZdMS)ZDeprecatedMixinzA mixin implementing logic for checking deprecated symbols. A class implementing mixin must define "deprecated-method" Message. W4906zUsing deprecated attribute %rdeprecated-attributezHThe attribute is marked as deprecated and will be removed in the future.sharedTz!dict[str, MessageDefinitionTuple]DEPRECATED_ATTRIBUTE_MESSAGEW4901zDeprecated module %rdeprecated-modulez*A module marked as deprecated is imported.)W0402zold-deprecated-module) old_namesrDEPRECATED_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_MESSAGEnodeastroid.AttributereturnNonec0||dS)z3Called when an `astroid.Attribute` node is visited.N)check_deprecated_attribute)selfr+s N/var/www/piapp/venv/lib/python3.11/site-packages/pylint/checkers/deprecated.pyvisit_attributezDeprecatedMixin.visit_attribute[s ''----- nodes.Callc||t|jD]}|||dS)z2Called when a :class:`nodes.Call` node is visited.N)check_deprecated_class_in_callr funccheck_deprecated_method)r1r+inferreds r2 visit_callzDeprecatedMixin.visit_call`sT ++D111!$),, 9 9H  ( (x 8 8 8 8 9 9r4 nodes.Importcd|jDD]M}|||d|vr1|dd\}}||||fNdS)z+Triggered when an import statement is seen.c3 K|] \}}|V dSN.0name_s r2 z/DeprecatedMixin.visit_import..rs&44gdAT444444r4.N)namescheck_deprecated_modulesplitcheck_deprecated_class)r1r+rCmod_name class_names r2 visit_importzDeprecatedMixin.visit_importls 54444 K KD  ( (t 4 4 4d{{'+zz#q'9'9$*++D(ZMJJJ  K Kr4 Iterable[str]cdS)zCallback returning the deprecated decorators. Returns: collections.abc.Container of deprecated decorator names. r@r@r1s r2deprecated_decoratorsz%DeprecatedMixin.deprecated_decoratorsy rr4nodes.Decoratorsct|}|sdSt|dtjrt |dj}nt |d}|r|nd}||vr| d||dSdS)z-Triggered when a decorator statement is seen.Nrr(r+args) list get_children isinstancerCallr r8qnamerR add_message)r1r+childreninfr\s r2visit_decoratorsz DeprecatedMixin.visit_decoratorss))++,,  F hqk5: . . *Xa[-..CCXa[))C",  D..00 0 0   3$U  K K K K K 1 0r4nodes.ImportFromc|j}t||}|||d|jD}||||dS)z(Triggered when a from statement is seen.c3 K|] \}}|V dSr?r@rAs r2rEz3DeprecatedMixin.visit_importfrom..s&66at666666r4N)modnamer rIrHrK)r1r+basename class_namess r2visit_importfromz DeprecatedMixin.visit_importfromsc <"422 $$T8444664:666  ##D(K@@@@@r4Container[str]cdS)zCallback returning the deprecated methods/functions. Returns: collections.abc.Container of deprecated function/method names. r@r@rQs r2deprecated_methodsz"DeprecatedMixin.deprecated_methodsrSr4methodstr Iterable[tuple[int | None, str]]cdS)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')) r@r@)r1rks r2deprecated_argumentsz$DeprecatedMixin.deprecated_argumentss 0rr4cdS)zCallback returning the deprecated modules. Returns: collections.abc.Container of deprecated module names. r@r@rQs r2deprecated_modulesz"DeprecatedMixin.deprecated_modulesrSr4modulecdS)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. r@r@)r1rrs r2deprecated_classesz"DeprecatedMixin.deprecated_classess rr4cdS)z-Callback returning the deprecated attributes.r@r@rQs r2deprecated_attributesz%DeprecatedMixin.deprecated_attributessrr4c^t|j}t|tjt tjfsdSd||j f}| D]'}||kr| d||ft(dS)z&Checks if the attribute is deprecated.NrFr)r+rW confidence) r exprrZrClassDefrModulejoinr\attrnamervr]r)r1r+ inferred_exprattribute_qnamedeprecated_names r2r0z*DeprecatedMixin.check_deprecated_attributes"49-- -%.(EL)QRR  F((M$7$7$9$94=#IJJ#99;;  O/11  *)+( !  r4mod_path str | Nonec|D]:}||ks|r0||dzr|d||;dS)z#Checks if the module is deprecated.rFrrVN)rq startswithr])r1r+rrLs r2rIz'DeprecatedMixin.check_deprecated_modulesp//11 P PH8##x#H4G4GSV4W4W#  !44h OOO P Pr4r: nodes.NodeNGct|tsdSt|jtjr |jj}n.t|jtjr |jj}ndS||h}tfd|Dr d||fdSt|j }|j rd|j Dni}fd|D}t|D]F\}} | |vr d|| |f$| ||kr d|| |fGdS)zExecutes the checker for the given node. This method should be called from the checker implementing this mixin. Nc3DK|]}|vVdSr?)rj)rBrCr1s r2rEz:DeprecatedMixin.check_deprecated_method..s4DDTtt..000DDDDDDr4rrVch|] }|j Sr@)arg)rBkws r2 z:DeprecatedMixin.check_deprecated_method..s111R"&111r4c3BK|]}|VdSr?)ro)rBqnr1s r2rEz:DeprecatedMixin.check_deprecated_method..s1OO" 9 9" = =OOOOOOr4r )rZACCEPTABLE_NODESr8r Attributer}NamerCr\anyr]lenrWkeywordsr) r1r+r: func_nameqnames num_of_argskwargsropositionarg_names ` r2r9z'DeprecatedMixin.check_deprecated_methods($455  F di 1 1  *II  5: . .  II F..""I. DDDDVDDD D D    0t9,  O O O F$)nn 59]J114=1111OOOOOOO"')=">   Hh6!!  )Hi;P!%([*@*@  )Hi;P!  r4rLrfcr|D]3}|||vr|d|||f4dS)z"Checks if the class is deprecated.r$rVN)rtr])r1r+rLrfrMs r2rKz&DeprecatedMixin.check_deprecated_classs` &  JT44X>>>>  &TX8N!  r4ct|jtjr[t|jjtjr9|jjj}|jj}||||fdSdSdS)z$Checks if call the deprecated class.N) rZr8rrryrrCr}rK)r1r+rLrMs r2r7z.DeprecatedMixin.check_deprecated_class_in_calls di 1 1 Gj INEJ7 7  Gy~*H+J  ' 'h F F F F F  G G G Gr4N)r+r,r-r.)r+r5r-r.)r+r<r-r.)r-rO)r+rTr-r.)r+rar-r.)r-rh)rkrlr-rm)rrrlr-rO)r+r<rrr-r.)r+r5r:rr-r.)r+rrLrlrfrOr-r.)__name__ __module__ __qualname____doc__r__annotations__rrr"r&r*r only_required_for_messagesr3r;rNrRr`rgrjrorqrtrvr0rIr9rKr7r@r4r2rrs  + " V t   G   "  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%&<==...>=.&U% 999  9&U%KKK K&U%&<== L L L>= L&U%AAA A4        PPPP ####J    GGGGGGr4r)r __future__rcollections.abcrr itertoolsrastroidr astroid.basesrpylint.checkersr pylint.checkers.base_checkerr pylint.checkers.utilsr r r pylint.interfacesr pylint.typingr BoundMethod UnboundMethod FunctionDefrzrrrr@r4r2rsK 21""""""////////""""""!!!!!!444444HHHHHHHHHH''''''000000    N  CGCGCGCGCGkCGCGCGCGCGr4