o g#@sdZddlmZddlmZmZmZmZmZddl Z ddl m Z ddl m Z ddl mZddlmZmZmZe je je je jfZGd d d eZdS) z+Checker mixin for deprecated functionality.)chain)Any ContainerIterableTupleUnionN)nodes)utils) BaseChecker)get_import_name infer_all safe_inferc@s0eZdZUdZddddddZeed<ed d d d e j d dfddZ edd d e j d dfddZ d efddZedd e jd dfddZedd d e jd dfddZd eefddZded eeeedfeffddZd efd d!Zd"ed efd#d$Zd%d&Zd'd(Zd)d*Zd+d,Z dS)-DeprecatedMixinzA mixin implementing logic for checking deprecated symbols. A class implementing mixin must define "deprecated-method" Message. )zUsing deprecated method %s()deprecated-methodzEThe method is marked as deprecated and will be removed in the future.)z+Using deprecated argument %s of method %s()deprecated-argumentzGThe argument is marked as deprecated and will be removed in the future.)zUses of a deprecated module %rdeprecated-modulez*A module marked as deprecated is imported.)z&Using deprecated class %s of module %sdeprecated-classzDThe class is marked as deprecated and will be removed in the future.)zUsing deprecated decorator %s()deprecated-decoratorzHThe decorator is marked as deprecated and will be removed in the future.)W1505W1511W0402W1512W1513msgsrrrnodereturnNcCs*||t|jD]}|||q dS)z2Called when a :class:`nodes.Call` node is visited.N)check_deprecated_class_in_callr funccheck_deprecated_method)selfrinferredr!X/home/ubuntu/cloudmapper/venv/lib/python3.10/site-packages/pylint/checkers/deprecated.py visit_call8s zDeprecatedMixin.visit_callrcCsNdd|jDD]}|||d|vr$|dd\}}||||fqdS)z*triggered when an import statement is seencs|]\}}|VqdSNr!.0name_r!r!r" Jz/DeprecatedMixin.visit_import...N)namescheck_deprecated_modulesplitcheck_deprecated_class)rrr(mod_name class_namer!r!r" visit_importDs zDeprecatedMixin.visit_importcCdS)zCallback returning the deprecated decorators. Returns: collections.abc.Container of deprecated decorator names. r!r!rr!r!r"deprecated_decoratorsQz%DeprecatedMixin.deprecated_decoratorsrcCstt|}|s dSt|dtjrt|dj}nt|d}|r&|nd}||vr8|j d||ddSdS)z,Triggered when a decorator statement is seenNrrrargs) list get_children isinstancerCallr rqnamer7 add_message)rrchildreninfr?r!r!r"visit_decoratorsZs   z DeprecatedMixin.visit_decoratorscCs>|j}t||}|||dd|jD}||||dS)z'triggered when a from statement is seencsr$r%r!r&r!r!r"r*qr+z3DeprecatedMixin.visit_importfrom..N)modnamer r/r.r1)rrbasename class_namesr!r!r"visit_importfromhs   z DeprecatedMixin.visit_importfromcCr5)zCallback returning the deprecated methods/functions. Returns: collections.abc.Container of deprecated function/method names. r!r!r6r!r!r"deprecated_methodstr8z"DeprecatedMixin.deprecated_methodsmethodcCr5)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!)rrIr!r!r"deprecated_arguments}sz$DeprecatedMixin.deprecated_argumentscCr5)zCallback returning the deprecated modules. Returns: collections.abc.Container of deprecated module names. r!r!r6r!r!r"deprecated_modulesr8z"DeprecatedMixin.deprecated_modulesmodulecCr5)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!)rrLr!r!r"deprecated_classess z"DeprecatedMixin.deprecated_classescCs8|D]}||ks||dr|jd||dqdS)z"Checks if the module is deprecatedr,rr9N)rK startswithr@)rrmod_pathr2r!r!r"r/s z'DeprecatedMixin.check_deprecated_modulec s>t|tsdSt|jtjr|jj}nt|jtjr|jj}ndSt|j dr<|j r<| |j d||h}n| |h}t fdd|DrXj d||fddSt |j}|jrhdd |jDni}fd d|D}t|D]%\}} | |vrj d || |fdqw|dur||krj d || |fdqwdS) zExecutes the checker for the given node. This method should be called from the checker implementing this mixin. Nr?r,c3s|] }|vVqdSr%)rH)r'r(r6r!r"r*sz:DeprecatedMixin.check_deprecated_method..rr9cSsh|]}|jqSr!)arg)r'kwr!r!r" sz:DeprecatedMixin.check_deprecated_method..c3s|]}|VqdSr%)rJ)r'qnr6r!r"r*sr)r=ACCEPTABLE_NODESrr AttributeattrnameNamer(hasattrparentr?anyr@lenr:keywordsr) rrr func_nameqnames num_of_argskwargsrJpositionarg_namer!r6r"rs<       z'DeprecatedMixin.check_deprecated_methodcCs0|D]}|||vr|jd|||fdqdS)z!Checks if the class is deprecatedrr9N)rMr@)rrr2rFr3r!r!r"r1s z&DeprecatedMixin.check_deprecated_classcCsLt|jtjr"t|jjtjr$|jjj}|jj}||||fdSdSdS)z#Checks if call the deprecated classN) r=rrrUexprrWr(rVr1)rrr2r3r!r!r"rs  z.DeprecatedMixin.check_deprecated_class_in_call)!__name__ __module__ __qualname____doc__rr__annotations__r check_messagesrr>r#Importr4rr7 DecoratorsrC ImportFromrGrstrrHrrintrJrKrMr/rr1rr!r!r!r"rsN        - r)rg itertoolsrtypingrrrrrastroidrpylint.checkersr pylint.checkers.base_checkerr pylint.checkers.utilsr r r BoundMethod UnboundMethod FunctionDefClassDefrTrr!r!r!r"s