ރ%= h d dl mZ d dlZd dlZd dlZd dlmZmZ d dlm Z d dl
m Z d dl m
Z
mZ d dlmZ d dlmZ d d lmZmZmZ d d
lmZ d d lmZmZm Z m Z d d l m Z d d
l m!Z!m"Z"m#Z#m$Z$m%Z% d dl&m'Z'm(Z( e
rd dl)m*Z* ej+ G d de Z, G d de, Z- G d de, Z.dS ) ) annotationsN)IterableSequence)cleandoc) TokenInfo)
TYPE_CHECKINGAny)nodes)_ArgumentsProvider)
_MSG_ORDERMAIN_CHECKER_NAME WarningScope)InvalidMessageError)
Confidence IRawChecker
ITokenChecker
implements)MessageDefinition)ExtraMessageOptionsMessageDefinitionTuple
OptionDictOptionsReportsCallable)get_rst_section
get_rst_title)PyLinterc e Zd ZU dZded< dZded< i Zded< dZd ed
< d Zd ed
< d=dZ d>dZ
d>dZ d?dZ d@dZ
d@dZ dAdBd"Z dCdDd.ZdEd/ZdFd3ZedGd5 ZdHd6ZdEd7ZdEd8ZdId9ZdJd<ZdS )K BaseChecker strname r options!dict[str, MessageDefinitionTuple]msgsz,tuple[tuple[str, str, ReportsCallable], ...]reportsTboolenabledlinterr returnNonec t | dd r t j dt d | j | j | _ || _ t j | | dS )z5Checker instances should have the linter as argument.__implements__NzUsing the __implements__ inheritance pattern for BaseChecker is no longer supported. Child classes should only inherit BaseChecker or any of the other checker types from pylint.checkers.
stacklevel) getattrwarningswarnDeprecationWarningr! lowerr) r __init__)selfr) s n/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pylint/checkers/base_checker.pyr6 zBaseChecker.__init__0 s{ 4)4 0 0 MC #
9 ))DI #D&11111 otherr c 8 t |t sdS | j t k rdS |j t k rdS t | j d r)t | j d sdS | j |j k S )zSorting of checkers.FTzpylint.checkers)
isinstancer r! r
type
__module__
startswithr7 r: s r8 __gt__zBaseChecker.__gt__@ s %-- 5 9) ) )5 :* * *4 :: + +,= > > t H
H
ZZ 122 5y5:%%r9 c t t |t sdS | j | j |j |j k S )z$Permit to assert Checkers are equal.F)r< r r! r% r@ s r8 __eq__zBaseChecker.__eq__N sB %-- 5)(TY((uz,G5:,G,GGGr9 intc < t | j | j S )zMake Checker hashable.)hashr! r% r7 s r8 __hash__zBaseChecker.__hash__T s ty-$)--...r9 c | j rdnd}d | j }| d| j d| dS )NCheckerzDisabled checkerz', 'z 'z' (responsible for 'z'))r( joinr% keysr! )r7 statusr% s r8 __repr__zBaseChecker.__repr__X sQ "lB0B{{49>>++,,CCDICC4CCCCr9 c t j 5 t j dt | | j | | j cddd S # 1 swxY w Y dS )zThis might be incomplete because multiple classes inheriting BaseChecker
can have the same name.
See: MessageHandlerMixIn.get_full_documentation()
ignorecategory)r% r# r& N)r2 catch_warningsfilterwarningsr4 get_full_documentationr% options_and_valuesr& rG s r8 __str__zBaseChecker.__str__] s
$
&
& #H7I J J J J..Y(?(?(A(A4< / s AA00A47A4N%Iterable[tuple[str, OptionDict, Any]]*Sequence[tuple[str, str, ReportsCallable]]doc
str | Nonemodule show_optionsc D d}| j dd d}|r |d| dz
}|t |d dz
}|r |d | d
z
}|d | j d z
}|r+|t | d
d z
}|t | dz
}t | } | rE|r-|t | dd z
}|t
d | dz
}n|d| j d| j dz
}|rw|t | dd z
}t | d D ]7\ }
} | |
| } ||
d dz
}8|dz
}|r0|t | dd z
}|D ]}
|d|
d d z z
}|dz
}|dz
}|S ) Nr _ z checkerz.. _z:
~
z This 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 Messagesc R t j | d d | d fS )Nr )r index)kvs r8 z4BaseChecker.get_full_documentation.. s" j.>r!uQx.H.H"Q%-P r9 )keyF)
checkerrefz Reportsz:%s: %s
r. ) r! replacetitler r listr sorteditems$create_message_definition_from_tuple format_help)r7 r% r# r& rZ r\ r] result
checker_title options_listmsgidmsgmsg_defreports r8 rU z"BaseChecker.get_full_documentationi sk 9,,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
s CCE3OOW 0 0E 0 B BFFFF dNF m}$>$>$>DD DF!
&!*,
dNF$
r9 ru line
int | Nonenodenodes.NodeNG | Noneargs
confidenceConfidence | None
col_offset
end_linenoend_col_offsetc
H | j |||||||| d S N)r) add_message) r7 ru ry r{ r} r~ r r r s r8 r zBaseChecker.add_message s9
4tZZ
r9 c d}g }| j D ]s}|j r
|>||j dd k r+d}|d|j d| dz
}|d| d z
}t | |j dd }| |j tdS )
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.
Nre z(Inconsistent checker part in message id 'z' (expected 'xzxx' zbecause we already had z).)messagessharedru r append)r7
checker_id existing_idsmessage error_msgs r8 check_consistencyz BaseChecker.check_consistency s
} / /G ~
%*
ac8J*J*J F N N Nj N N NN G| G G GG ))444 qs+J
. . . . / /r9 msg_tupler r c \ t j 5 t j dt t | t
t f r
t j }nOt | t t f r't j dt t j }n t j
}d d d n # 1 swxY w Y i }t | dk r|\ }}}}n+t | dk r|\ }}}nd}t | | d| t# | ||||fi |S )NrP rQ zCheckers should subclass BaseTokenChecker or BaseRawFileChecker instead of using the __implements__ mechanism. Use of __implements__ will no longer be supported in pylint 3.0 r zMessages should have a msgid, a symbol and a description. Something like this :
"W1234": (
"message",
"message-symbol",
"Message description with detail.",
...
),
scope)r2 rS rT r4 r< BaseTokenCheckerBaseRawFileCheckerr LINEr r r r3 NODElenr
setdefaultr ) r7 ru r
default_scoper# rv symboldescrr s r8 rp z0BaseChecker.create_message_definition_from_tuple s~
$
&
& 2 2 #H7I J J J J$!13E FGG
2 , 1
D;
">??
2
@ ' !- 1
, 1
2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 (* y>>Q ,5 )S&%
^^q
#, S&%%I &i00 07M222 uc5&LLGLLLs BB44B8;B8list[MessageDefinition]c h fdt j D S )Nc B g | ]\ }} || S r" )rp ).0ru r r7 s r8
z(BaseChecker.messages.. s=
y
5 5eY G G
r9 )rn r% ro rG s `r8 r zBaseChecker.messages sB
$*49??+<+<$=$=
r9 c t j dt d | j D ]}|j |k r|c S d| d}|dd | j D dz
}t | ) NzB'get_message_definition' is deprecated and will be removed in 3.0.r. r/ zMessageDefinition for 'z' does not exists. z Choose from c g | ] }|j
S r" )ru )r ms r8 r z6BaseChecker.get_message_definition.. s $D$D$DQW$D$D$Dr9 .)r2 r3 r4 r ru r )r7 ru message_definitionr s r8 get_message_definitionz"BaseChecker.get_message_definition s
P
#'- * * !'500)))) 1HeHHH G$D$Ddm$D$D$DGGGG !),,,r9 c dS )z5Called before visiting project (i.e. set of modules).Nr" rG s r8 openzBaseChecker.open r9 c dS )z3Called after visiting project (i.e set of modules).Nr" rG s r8 closezBaseChecker.close r r9 c d S r r" rG s r8 get_map_datazBaseChecker.get_map_data tr9 data list[Any]c d S r r" )r7 r) r s r8 reduce_map_datazBaseChecker.reduce_map_data r r9 )r) r r* r+ )r: r r* r' )r* rD )r* r )NNT)r% r$ r# rX r& rY rZ r[ r\ r[ r] r' r* r )NNNNNNN)ru r ry rz r{ r| r} r r~ r r rz r rz r rz r* r+ )r* r+ )ru r r r r* r )r* r )ru r r* r )r* r )r) r r r r* r+ )__name__r> __qualname__r! __annotations__r# r% r& r( r6 rA rC rH rN rW rU r r rp propertyr r r r r r r" r9 r8 r r # s DNNNNG.0D0000<>G>>>>G2 2 2 2 & & & & H H H H / / / /D D D D
" ! !. . . . .f $((,!%!%%)
/ / / /2#M #M #M #MJ
X
- - - - D D D DB B B B r9 r c 4 e Zd ZdZej dd ZdS ) r zEBase class for checkers that want to have access to the token stream.tokenslist[TokenInfo]r* r+ c t )z#Should be overridden by subclasses.NotImplementedError)r7 r s r8 process_tokensz BaseTokenChecker.process_tokens s "###r9 N)r r r* r+ )r r> r __doc__abcabstractmethodr r" r9 r8 r r s< OO$ $ $ $ $ $r9 r c 4 e Zd ZdZej dd ZdS ) r z9Base class for checkers which need to parse the raw file.r{ nodes.Moduler* r+ c t )z]Process a module.
The module's content is accessible via ``astroid.stream``
r )r7 r{ s r8 process_modulez!BaseRawFileChecker.process_module s "###r9 N)r{ r r* r+ )r r> r r r r r r" r9 r8 r r s< CC$ $ $ $ $ $r9 r )/
__future__r r functoolsr2 collections.abcr r inspectr tokenizer typingr r astroidr
pylint.config.arguments_providerr pylint.constantsr r
r pylint.exceptionsr pylint.interfacesr r r r !pylint.message.message_definitionr
pylint.typingr r r r r pylint.utilsr r pylint.lintr total_orderingr r r r" r9 r8 r s1
# " " " " "
. . . . . . . . % % % % % % % % ? ? ? ? ? ? H H H H H H H H H H 1 1 1 1 1 1 P P P P P P P P P P P P ? ? ? ? ? ? 8 7 7 7 7 7 7 7 %$$$$$$ b b b b b$ b b bJ$ $ $ $ ${ $ $ $ $ $ $ $ $ $ $ $ $ $r9