yIf$TddlmZddlZddlZddlmZmZddlmZddl 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&ej'GddeZ(Gdde(Z)Gdde(Z*dS)) annotationsN)IterableSequence)cleandoc) TokenInfo) TYPE_CHECKINGAny)nodes)_ArgumentsProvider) _MSG_ORDERMAIN_CHECKER_NAME WarningScope)InvalidMessageError) Confidence)MessageDefinition)ExtraMessageOptionsMessageDefinitionTuple OptionDictOptionsReportsCallable)get_rst_section get_rst_title)PyLinterceZdZUdZded<dZded<iZded<dZd ed <d Zd ed <ddZ d?dZ d?dZ d@dAd"Z dBdCd.ZdDd/ZdEd3ZedFd5ZdDd6ZdDd7ZdGd8ZdHd;ZdS)I BaseCheckerstrnameroptions!dict[str, MessageDefinitionTuple]msgsz,tuple[tuple[str, str, ReportsCallable], ...]reportsTboolenabledlinterrreturnNonec|j|j|_||_tj||dS)z5Checker instances should have the linter as argument.N)rlowerr&r __init__)selfr&s P/var/www/piapp/venv/lib/python3.11/site-packages/pylint/checkers/base_checker.pyr+zBaseChecker.__init__/s= 9  ))DI #D&11111otherr c@t|tsdS|jtkrdS|jtkrdSt |jd}|t |jdz r| S|j|jkS)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,r/self_is_builtins r-__gt__zBaseChecker.__gt__6s %-- 5 9) ) )5 :* * *4t**/::;LMM T%[[3>>?PQQ Q '&& &y5:%%r.ctt|tsdS|j|j|j|jkS)z$Permit to assert Checkers are equal.F)r1rrr")r,r/s r-__eq__zBaseChecker.__eq__GsB%-- 5)(TY((uz,G5:,G,GGGr.intc<t|j|jS)zMake Checker hashable.)hashrr"r,s r-__hash__zBaseChecker.__hash__Msty-$)--...r.c|jrdnd}d|j}|d|jd|dS)NCheckerzDisabled checkerz', 'z 'z' (responsible for 'z'))r%joinr"keysr)r,statusr"s r-__repr__zBaseChecker.__repr__QsQ"lB0B{{49>>++,,CCDICC4CCCCr.cj||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#r<s r-__str__zBaseChecker.__str__Vs8 **D$<$<$>$> +   r.N%Iterable[tuple[str, OptionDict, Any]]*Sequence[tuple[str, str, ReportsCallable]]doc str | Nonemodule show_optionscTd}|jddd}|r |d|dz }|t|ddz }|r |d |d z }|d |jd z }|r+|t|d dz }|t |dz }t |} | rE|r-|t|ddz }|t d| dz }n|d|jd|jdz }|rw|t|ddz }t|dD]7\} } | | | } || ddz }8|dz }|r8|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 MessagescRtj|dd|dfS)Nr)r index)kvs r-z4BaseChecker.get_full_documentation..s"j.>r!uQx.H.H"Q%-Pr.)keyF) checkerrefz Reports:rz: rU) rreplacetitlerrlistrsorteditems$create_message_definition_from_tuple format_help)r,r"r r#rJrLrMresult checker_title options_listmsgidmsgmsg_defreports r-rEz"BaseChecker.get_full_documentation`su9,,S#66<<>>HHH  + *V*** *F]=#66::::  E DvDDD DFItyIIII  - m}$D$D$DcJJ JF #,,, ,FG}}  t t-=(B(B(BCHHH_T<@@DDDDsDIssZ^Zcssss   m}$?$?$?EE EF$ "P"P G G sCCE3OOW00E0BBFFFF dNF   m}$>$>$>DD DF! 9 98fQi886!98888 dNF$ r.rfline int | Nonenodenodes.NodeNG | Noneargs confidenceConfidence | None col_offset end_linenoend_col_offsetc H|j||||||||dSN)r& add_message) r,rfrjrlrnrorqrrrss r-rvzBaseChecker.add_messages9  4tZZ     r.cd}g}|jD]s}|jr |>||jddkr+d}|d|jd|dz }|d|d z }t||jdd}||jtdS) 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. NrUz(Inconsistent checker part in message id 'z' (expected 'xzxx' zbecause we already had z).)messagessharedrfrappend)r, checker_id existing_idsmessage error_msgs r-check_consistencyzBaseChecker.check_consistencys  } / /G~ %* ac8J*J*JF NNNjNNNN G|GGGG ))444 qs+J    . . . . / /r. msg_tuplerrcbt|ttfr tj}n tj}i}t |dkr|\}}}}tdi|}n+t |dkr|\}}}nd} t| | d|t|||||fi|S)NrxzMessages should have a msgid, a symbol and a description. Something like this : "W1234": ( "message", "message-symbol", "Message description with detail.", ... ), scoper) r1BaseTokenCheckerBaseRawFileCheckerrLINENODElenrr setdefaultr) r,rfr default_scoper rgsymboldescr msg_optionsrs r-raz0BaseChecker.create_message_definition_from_tuples d-/AB C C .(-MM(-M') y>>Q  09 -S&%)88K88GG ^^q #, S&%%I&i00 07M222 uc5&LLGLLLr.list[MessageDefinition]chfdtjDS)NcBg|]\}}||Sr)ra).0rfrr,s r- z(BaseChecker.messages..s=    y  5 5eY G G   r.)r_r"r`r<s`r-rzzBaseChecker.messagessB    $*49??+<+<$=$=    r.cdS)z5Called before visiting project (i.e. set of modules).Nrr<s r-openzBaseChecker.openr.cdS)z3Called after visiting project (i.e set of modules).Nrr<s r-closezBaseChecker.closerr.cdSrurr<s r- get_map_datazBaseChecker.get_map_datatr.data list[Any]cdSrur)r,r&rs r-reduce_map_datazBaseChecker.reduce_map_datarr.)r&rr'r()r/r r'r$)r'r9)r'r)NNT)r"r!r rHr#rIrJrKrLrKrMr$r'r)NNNNNNN)rfrrjrkrlrmrnr rorprqrkrrrkrsrkr'r()r'r()rfrrrr'r)r'r)r'r )r&rrrr'r()__name__r3 __qualname__r__annotations__r r"r#r%r+r6r8r=rCrGrErvrrapropertyrzrrrrrr.r-rr"sDNNNNG.0D0000<>G>>>>G2222&&&&"HHHH ////DDDD     !!,,,,,b $((,!%!%%)      ////2MMMM6   X DDDDBBBBr.rc4eZdZdZejddZdS) rzEBase class for checkers that want to have access to the token stream.tokenslist[TokenInfo]r'r(ct)z#Should be overridden by subclasses.NotImplementedError)r,rs r-process_tokenszBaseTokenChecker.process_tokenss"###r.N)rrr'r()rr3r__doc__abcabstractmethodrrr.r-rrs<OO$$$$$$r.rc4eZdZdZejddZdS) rz9Base class for checkers which need to parse the raw file.rl nodes.Moduler'r(ct)z]Process a module. The module's content is accessible via ``astroid.stream`` r)r,rls r-process_modulez!BaseRawFileChecker.process_modules "###r.N)rlrr'r()rr3rrrrrrr.r-rrs<CC$$$$$$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_orderingrrrrr.r-rs #""""" ........%%%%%%%%??????HHHHHHHHHH111111((((((??????87777777%$$$$$$ @@@@@$@@@F$$$$${$$$ $ $ $ $ $ $ $ $ $ $r.