e.$DddlmZddlZddlZddlmZmZddlmZddl m Z ddl m Z m Z ddlmZddlmZdd lmZmZmZdd lmZdd lmZdd lmZdd lmZmZmZm Z m!Z!ddl"m#Z#m$Z$e rddl%m&Z&ejNGddeZ(Gdde(Z)Gdde(Z*y)) annotationsN)IterableSequence)cleandoc) TokenInfo) TYPE_CHECKINGAny)nodes)_ArgumentsProvider) _MSG_ORDERMAIN_CHECKER_NAME WarningScope)InvalidMessageError) Confidence)MessageDefinition)ExtraMessageOptionsMessageDefinitionTuple OptionDictOptionsReportsCallable)get_rst_section get_rst_title)PyLinterc6eZdZUdZded<dZded<iZded<dZd ed <d Zd ed <ddZ ddZ ddZ d dZ d!dZ d!dZ d" d#dZ d$ d%dZd&dZ d'dZed(dZd&dZd&dZd)dZd*dZy)+ BaseCheckerstrnameroptions!dict[str, MessageDefinitionTuple]msgsz,tuple[tuple[str, str, ReportsCallable], ...]reportsTboolenabledc|j|jj|_||_tj||y)z5Checker instances should have the linter as argument.N)rlowerlinterr __init__)selfr(s >/usr/lib/python3/dist-packages/pylint/checkers/base_checker.pyr)zBaseChecker.__init__/s5 99  )DI ##D&1cBt|tsy|jtk(ry|jtk(ryt |j j d}|t |j j dz r| S|j|jkDS)zPermits sorting checkers for stable doc and tests. The main checker is always the first one, then builtin checkers in alphabetical order, then extension checkers in alphabetical order. FTzpylint.checkers) isinstancerrr type __module__ startswith)r*otherself_is_builtins r+__gt__zBaseChecker.__gt__6s %- 99) ) ::* *t*//::;LM T%[33>>?PQ Q&& &yy5::%%r,ct|tsy|j|j|j|jk(S)z$Permit to assert Checkers are equal.F)r.rrr")r*r2s r+__eq__zBaseChecker.__eq__Gs<%-))TYYK(uzzl5::,,GGGr,cHt|j|jS)zMake Checker hashable.)hashrr"r*s r+__hash__zBaseChecker.__hash__Mstyyk$))-..r,c|jrdnd}dj|jj}|d|jd|dS)NCheckerzDisabled checkerz', 'z 'z' (responsible for 'z'))r%joinr"keysr)r*statusr"s r+__repr__zBaseChecker.__repr__QsG"ll0B{{499>>+,DII;&:4&CCr,cn|j|j|j|jS)zThis might be incomplete because multiple classes inheriting BaseChecker can have the same name. See: MessageHandlerMixIn.get_full_documentation() )r"r r#)get_full_documentationr"_options_and_valuesr#r9s r+__str__zBaseChecker.__str__Vs4 **D$<$<$> +  r,Ncd}|jjddjd}|r |d|dz }|t|ddz }|r |d |d z }|d |jd z }|r#|t|d dz }|t |dz }t |} | rG|r%|t|ddz }|t d| dz }n |d|jd|jdz }|re|t|ddz }t|jdD]/\} } |j| | } || jddz }1|dz }|r0|t|ddz }|D]} |d| dd| ddz }|dz }|dz }|S)Nr_ z checkerz.. _z: ~ zThis checker is provided by ``z``. z"Verbatim name of the checker is ``z``. z Documentation^z z OptionszSee also :ref:`z# checker's options' documentation ` z MessagescBtj|dd|dfS)Nr)r index)kvs r+z4BaseChecker.get_full_documentation..s"j.>.>r!uQx.H"Q%-Pr,)keyF) checkerrefz Reports:rz: rL) rreplacetitlerrlistrsorteditems$create_message_definition_from_tuple format_help)r*r"r r#docmodule show_optionsresult checker_title options_listmsgidmsgmsg_defreports r+rBz"BaseChecker.get_full_documentation`s99,,S#6<<>?xH  VHE* *F]=#67r::  6vheD DF6tyykII  m}o^$DcJ JF #t, ,FG} -=/(BCHH_T<@ADDODII;6YZ^ZcZcYddrss  m}oY$?E EF$ "P G sCCE3OW00E0BC2FF  G dNF  m}oX$>D DF! 9AfQi[6!9+R88 9 dNF$ r,c H|jj||||||||yN)r( add_message) r*r`linenodeargs confidence col_offset end_linenoend_col_offsets r+rfzBaseChecker.add_messages'  4tZZ r,cd}g}|jD]y}|jr|>||jddk7r,d}|d|jd|dz }|d|d z }t||jdd}|j |j{y) a<Check the consistency of msgid. msg ids for a checker should be a string of len 4, where the two first characters are the checker id and the two last the msg id in this checker. :raises InvalidMessageError: If the checker id in the messages are not always the same. NrLz(Inconsistent checker part in message id 'z' (expected 'xzxx' zbecause we already had z).)messagessharedr`rappend)r* checker_id existing_idsmessage error_msgs r+check_consistencyzBaseChecker.check_consistencys  }} /G~~%* a8J*JF q~j\NN 6|nBGG ))44 q+J    . /r,c>t|ttfrtj}ntj }i}t |dk(r|\}}}}tdi|}n"t |dk(r|\}}}n d} t| |jd|t|||||fi|S)NrozMessages should have a msgid, a symbol and a description. Something like this : "W1234": ( "message", "message-symbol", "Message description with detail.", ... ), scoper) r.BaseTokenCheckerBaseRawFileCheckerrLINENODElenrr setdefaultr) r*r` msg_tuple default_scoper rasymboldescr msg_optionsrws r+rXz0BaseChecker.create_message_definition_from_tuples d-/AB C(--M(--M') y>Q 09 -S&%)8K8G ^q #, S&%I&i0 07M2 uc5&LGLLr,ct|jjDcgc]\}}|j||c}}Scc}}wre)rVr"rWrX)r*r`rs r+rqzBaseChecker.messagessE%+499??+<$=  y  5 5eY G   sAcy)z5Called before visiting project (i.e. set of modules).Nrr9s r+openzBaseChecker.openr,cy)z3Called after visiting project (i.e set of modules).Nrr9s r+closezBaseChecker.closerr,cyrerr9s r+ get_map_datazBaseChecker.get_map_datar,cyrer)r*r(datas r+reduce_map_datazBaseChecker.reduce_map_datarr,)r(rreturnNone)r2r rr$)rint)rr)NNT)r"r!r z%Iterable[tuple[str, OptionDict, Any]]r#z*Sequence[tuple[str, str, ReportsCallable]]rZ str | Noner[rr\r$rr)NNNNNNN)r`rrg int | Nonerhznodes.NodeNG | Nonerir rjzConfidence | Nonerkrrlrrmrrr)rr)r`rrrrr)rzlist[MessageDefinition])rr )r(rrz list[Any]rr)__name__r0 __qualname__r__annotations__r r"r#r%r)r4r6r:r@rDrBrfrxrXpropertyrqrrrrrr,r+rr"spD#NGW.0D +0<>G 9>GT2&"H /D  !!,/,7,< ,  ,  ,, ,b $((,!%!%%)      "    &      #     /2MM%;M M6  DBr,rc6eZdZdZej ddZy)r|zEBase class for checkers that want to have access to the token stream.ct)z#Should be overridden by subclasses.NotImplementedError)r*tokenss r+process_tokenszBaseTokenChecker.process_tokenss "##r,N)rzlist[TokenInfo]rr)rr0r__doc__abcabstractmethodrrr,r+r|r|sO$$r,r|c6eZdZdZej ddZy)r}z9Base class for checkers which need to parse the raw file.ct)z]Process a module. The module's content is accessible via ``astroid.stream`` r)r*rhs r+process_modulez!BaseRawFileChecker.process_modules "##r,N)rhz nodes.Modulerr)rr0rrrrrrr,r+r}r}sC$$r,r})+ __future__rr functoolscollections.abcrrinspectrtokenizertypingrr astroidr pylint.config.arguments_providerr pylint.constantsr r rpylint.exceptionsrpylint.interfacesr!pylint.message.message_definitionr pylint.typingrrrrr pylint.utilsrr pylint.lintrtotal_orderingrr|r}rr,r+rs # .%?HH1(?8$ @$@@F${$ $ $r,