TsdT P U d Z ddlmZ ddlZddlZddlZddlZddlmZ ddlm Z m
Z
ddl m Z ddl
Z
ddl
mZmZmZ ddlmZ dd lmZmZmZmZ dd
lmZ dd lmZ dd l m Z e rdd
l m Z ej dk rddl m!Z! nddl"m!Z! dZ#h dZ$ ej% dd& e$ d Z' ej% dd& e$ d Z( ej% dd& e$ dej) Z*i dddddd d d d d d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d5d6d7d8d9d:d;d<Z+d=e,d>< ej- ej. ej/ ej0 ej1 ej2 ej3 fZ4dYdEZ5dZdJZ6 G dK dLe Z7 G dM dNee Z8d[dRZ9d\dTZ:d]dVZ;d^dWZ BFRUbfruBRBrFRFrRBRFRbRfbRbrfRfrrBrFrbrf(|z)?'''z)?"""z)?("|')E1300)z3Unsupported format character %r (%#02x) at index %dbad-format-characterzEUsed when an unsupported format character is used in a format string.E1301)z4Format string ends in middle of conversion specifiertruncated-format-stringzNUsed when a format string terminates before the end of a conversion specifier.E1302)z?Mixing named and unnamed conversion specifiers in format stringmixed-format-stringzUsed when a format string contains both named (e.g. '%(foo)d') and unnamed (e.g. '%d') conversion specifiers. This is also used when a named conversion specifier contains * for the minimum field width and/or precision.E1303)z*Expected mapping for format string, not %sformat-needs-mappingzoUsed when a format string that uses named conversion specifiers is used with an argument that is not a mapping.W1300)z7Format string dictionary key should be a string, not %sbad-format-string-keyzyUsed when a format string that uses named conversion specifiers is used with a dictionary whose keys are not all strings.W1301)z)Unused key %r in format string dictionaryunused-format-string-keyzUsed when a format string that uses named conversion specifiers is used with a dictionary that contains keys not required by the format string.E1304)z*Missing key %r in format string dictionarymissing-format-string-keyzUsed when a format string that uses named conversion specifiers is used with a dictionary that doesn't contain all the keys required by the format string.E1305)z$Too many arguments for format stringtoo-many-format-argsz^Used when a format string that uses unnamed conversion specifiers is given too many arguments.E1306)z&Not enough arguments for format stringtoo-few-format-argsz\Used when a format string that uses unnamed conversion specifiers is given too few argumentsE1307)z)Argument %r does not match format type %rbad-string-format-typezSUsed when a type required by format string is not suitable for actual argument typeE1310)z!Suspicious argument in %s.%s callbad-str-strip-callzFThe argument to a str.{l,r,}strip call contains a duplicate character,W1302)zInvalid format stringbad-format-stringz.Used when a PEP 3101 format string is invalid.W1303)z-Missing keyword argument %r for format stringmissing-format-argument-keyzhUsed when a PEP 3101 format string that uses named fields doesn't receive one or more required keywords.W1304)zUnused format argument %r unused-format-string-argumentz}Used when a PEP 3101 format string that uses named fields is used with an argument that is not required by the format string.W1305)zTFormat string contains both automatic field numbering and manual field specification format-combined-specificationzUsed when a PEP 3101 format string contains both automatic field numbering (e.g. '{}') and manual field specification (e.g. '{0}').W1306)z2Missing format attribute %r in format specifier %rmissing-format-attributezUsed when a PEP 3101 format string uses an attribute specifier ({0.length}), but the argument passed for formatting doesn't have that attribute.W1307)z2Using invalid lookup key %r in format specifier %rinvalid-format-indexzUsed when a PEP 3101 format string uses a lookup specifier ({a[1]}), but the argument passed for formatting doesn't contain or doesn't have that key as an attribute.)zKDuplicate string formatting argument %r, consider passing as named argument$duplicate-string-formatting-argumentzmUsed when we detect that a string formatting is repeating an argument instead of using named string arguments)z?Using an f-string that does not have any interpolated variables f-string-without-interpolationzUsed when we detect an f-string that does not use any interpolation variables, in which case it can be either a normal string or a bug in the code.)zKUsing formatting for a string that does not have any interpolated variables#format-string-without-interpolationzUsed when we detect a string that does not have any interpolation variables, in which case it can be either a normal string without formatting or a bug in the code.)W1308W1309W1310z!dict[str, MessageDefinitionTuple]MSGSkeystr | Literal[0]partslist[tuple[bool, str]]returnstrc g }|D ]9\ }}|r| d| | d|d :t | d | z S )z]Given a list of format specifiers, returns
the final access path (e.g. a.b.c[0][1]).
.[] )appendr` join)r[ r] path is_attribute specifiers i/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pylint/checkers/strings.pyget_access_pathrl s| D#( , , i , KKI ( ( ( ( KK*I*** + + + + s88bggdmm ## arg_typer format_typeboolc |dv rdS t | t j r4| } | dk r|dk S | dk r|dv S | dk rdS dS dS ) NsrTr czbuiltins.floatz deEfFgGn%z builtins.intF)
isinstanceastroidInstancepytype)rn ro s rk arg_matches_format_typerx s dt(G ,-- ??$$ ~ % % #% % ' ' ' +- - ~ % %4u 4rm c
e Zd ZdZdZeZ eddddddd d
d d d
d%d Z ed d&d Z d&dZ
d'dZ d(dZ d)d Z
d*d#Zd$S )+StringFormatCheckerzChecks string formatting operations to ensure that the format string
is valid and the arguments match the format string.
stringr3 r5 r7 r; r? r= rE r9 rA rC rV node nodes.BinOpr_ Nonec |j dk rd S |j }|j }t |t j rt |j t sd S |j } t j | \ }}}}n# t j
$ rE} || j }
| d||
t |
| j f Y d } ~ d S d } ~ wt j $ r | d| Y d S w xY w|s|s| d| d S |r|r| d| d S |rt |t j r{t! } d} |j D ]l\ }
}t |
t j rK|
j }t |t r| | Q| d || jd
} m| s!|D ] }|| vr| d || | D ] }||vr| d || |j D ]\ }}t |t j s | |j d }t j | }|X|rVt |t* j s> Fyz4-- *TZ2M2M F
)-88
!"""/ %ci0I & Y ;
FFFFF+ 6T B B B FF %6 B N N N F o . o
2 > > > > >
k
$
++ /
Tuu $ J , ,DAq!!U[11
, g%c3// HHSMMMM , , 7d - (, # , d?? , , ;$S - C-// (( 6T ) !%
HC%c5;77 ! "4"8"8D"I"IK $ / 4 4H#/ $ 0 *8T5I J J 0 !8+ N N 0
(( 4!%"*//"3"3[!A ) D; "<==
T JJ / !7d SSSSS
T
T I$ ,,
! ,T 2 2 i)<== . )I "9~~HD;U^0L"MNN
!F D%*--
+D11 h 44 $ !)
I "9~~HH %+66 $!)
I HH #HH
# ///$$%;$$GGGG 111$$%:$FFF(+I7I(J(J
$C ! $ / 4 4H *8T5I J J !8+ N N
(( 4!%"*//"3"3[!A ) $#
s A4 4C0:C)C0/C0rU nodes.JoinedStrc 0 | | d S N)_check_interpolationr r| s rk visit_joinedstrz#StringFormatChecker.visit_joinedstr s !!$'''''rm c t |j t j rd S |j D ] }t |t j r d S | d| d S )NrU r )rt parentr FormattedValuevaluesr )r r| r s rk r z(StringFormatChecker._check_interpolation sp dk5#7 8 8 F[ E%!566
9EEEEErm
nodes.Callc t j |j }t |t j rt |j t j r|j j dv r|j dv r|j rt j |j d }t |t j rt |j t sd S t |j t t |j k r+| d||j j |j f d S d S |j dk r | || d S d S d S d S d S )N> r` bytesunicode> striplstriprstripr rG r format)r r funcrt ru BoundMethodboundrv namer r r r r` r r r _check_new_format)r r| r r s rk
visit_callz StringFormatChecker.visit_call s_ ** tW 0 1 1 34:w'788 3
#>>>y 999di9&ty|44!#u{33 :ciQT;U;U Fsy>>SSY %8%888$$, ! "joty 9 % 98 h&&&&tT22222! 3 3 3 3 ?> '&rm positional_arguments list[SuccessfulInferenceResult]c t j d |D }| D ]%\ }}|dk r | d||f &d S )Nc 3 X K | ]%}t |t j |j V &d S r )rt r r r ).0r s rk zAStringFormatChecker._detect_vacuous_formatting.. sI &
&
3
8S8S&
H&
&
&
&
&
&
rm r rT r ) collectionsr r r )r r| r counterr counts rk _detect_vacuous_formattingz.StringFormatChecker._detect_vacuous_formatting s % &
&
4&
&
&
#==?? KD%zz 6T
rm r bases.BoundMethodc ~ t |j t j r&t |j j t j sdS |j s|j rdS t |j
}n# t j $ r Y dS w xY wt |t j rt |j
t sdS t j j | }n# t j $ r Y dS w xY w t% j |j
\ }}}n-# t$ j $ r | d| Y dS w xY w|j }|j } d |D }
|r|r| d| dS d} |t1 d |
D z
}|
ro|
D ]!} | r | | vr| d|| f "| D ] } | |
vr| d
|| f |p|}|s|r t3 d |
D }
| s|
rd } nd } | rt|p|}|s| d
| dS t5 | |k r| d| n*t5 | |k r| d| | || | ||| dS )z Check the new string formatting.NrI r c T h | ]%}t |d t |d &S )r )rt r` r fields rk z8StringFormatChecker._check_new_format.. s/ RRRU
58S8Q8QRaRRRrm rO Fc 3 K | ]}|d V dS )r N r s rk r z8StringFormatChecker._check_new_format.. s' AAe5AAAAAAArm rK r rM c 3 K | ]}|V d S r r r s rk r z8StringFormatChecker._check_new_format.. s" @ @% @ @ @ @ @ @rm TrV rA rC ) rt r r Attributeexprr starargskwargsnextr inferru InferenceErrorr r` argumentsCallSite from_callr parse_format_method_stringr r r keyword_argumentssumallr r _check_new_format_specifiers)r r| r strnode call_sitefieldsr
manual_posr named_arguments named_fields
check_argsr emptys rk r z%StringFormatChecker._check_new_format s di 1 1 * INEK;
;
F = DK F 4:++--..GG% FF 7EK00 Z
s5S5S F )2< >BB $C0 0DD D% %&EEr (list[tuple[str, list[tuple[bool, str]]]]named$dict[str, SuccessfulInferenceResult]c |D ]\ }}|sd}t |t r, t j || }n"# t j $ r Y Gw xY w||vrP|| }|t |t
j ru t j | }n# t j $ r Y w xY w|r|s|j
r t |j
t j r|}g } |D ]\ }
} t |t
j r n|
|
| f |
r | | d }n]# t j $ rW t! |d r| rY n`t% || } | d| | f| Y n2w xY wd}
t! |d r | t j | }n?# t j t j t j f$ r d}
Y nt j $ r Y nw xY wt |t
j r nn/ | d n# t j $ r d}
Y nw xY w|
r,t% || } | d
| | f| n: t3 | }# t j $ r Y nw xY wdS ) z^Check attribute and index access in the format
string ("{0.a}" and "{0[a]}").
r Nhas_dynamic_getattrrQ )r r| FgetitemT __getitem__rS )rt intr get_argument_from_callNoSuchArgumentErrorr
r r ru r r r Argumentsrf getattr
NotFoundErrorhasattrr rl r r r AstroidIndexErrorAstroidTypeErrorAttributeInferenceErrorr r )r r| r r r[
specifiersargnameargumentpreviousparsedri rj rh
warn_errors rk r z0StringFormatChecker._check_new_format_specifiers s & Y Y OC
#s##
% # :4 E EGG 0 H e## **Wd6J"K"K
+G44)
X
:hou#O#O
H-/F+5 8
8
' i h(<== E
|Y 7888 . #+#3#3I#>#>q#A"0
#H.C D D" ( < < > >"
"EE .sF ; ; (( 6"+T!2!% )
"'J x33 . "'/'7'7 I8N8N'O'OHH # 5 # 4 # ; . . .
*.JJJ & 5 " " " !EE"%h0DEE " !E". % , ,] ; ; ; !E & 4 . . .)-JJJ.! .sF ; ; (( 2)T9JQU ) #HNN$4$4 5 5HH - EEoY Y su 9A
A 9BB B D//3F&*FF+'G(H=HH0III
!J00KKN)r| r} r_ r~ )r| r r_ r~ r| r r_ r~ )r| r r r r_ r~ )r| r r r r_ r~ )r| r r r r r r_ r~ )r
__module__ __qualname____doc__r rZ msgsr r r r r r r r r rm rk rz rz s% D D ! #" - M M M M^ @AA( ( ( BA(F F F F3 3 3 3( RI RI RI RIjc c c c c crm rz c e Zd ZdZdZddddddd gifd
d d Zd
dddddfddddddffZdZdZd@ fd Z dAd Z
dBd!Z e d dCd# Z
e d dDd% Z e d dEd' Z e d dFd) ZdGd+ZdHd-ZdId2ZdJd7ZdKd;Z e d< dLd> ZdLd?Z xZS )MStringConstantCheckerzCheck string literals.r{ )zRAnomalous backslash in string: '%s'. String constant might be missing an r prefix. anomalous-backslash-in-stringzBUsed when a backslash is in a literal string but not as an escape.)zaAnomalous Unicode escape in byte string: '%s'. String constant might be missing an r or u prefix."anomalous-unicode-escape-in-stringzSUsed when an escape like \u is encountered in a byte string where it has no effect.z)Implicit string concatenation found in %simplicit-str-concatziString literals are implicitly concatenated in a literal iterable definition : maybe a comma is missing ? old_names)W1403z implicit-str-concat-in-sequence)z=3.0redundant-u-string-prefixzUsed when we detect a string with a u prefix. These prefixes were necessary in Python 2 to indicate a string was Unicode, but since Python 3.0 strings are Unicode by default.)W1401W1402W1404W1405W1406z check-str-concat-over-line-jumpsFynzzThis flag controls whether the implicit-str-concat should generate a warning on implicit string concatenation in sequences defined over several lines.)defaultr metavarhelpzcheck-quote-consistencyzThis flag controls whether inconsistent-quotes generates a warning when the character used as a quote delimiter is used inconsistently within a module.zabfnrtvx
\'"01234567uUNlinterr r_ r~ c X t | i | _ d S r )super__init__
string_tokens)r r% __class__s rk r( z StringConstantChecker.__init__ s0
;:rm r| nodes.Modulec " d|j v | _ d S )Nunicode_literals)future_imports_unicode_literalsr s rk process_modulez$StringConstantChecker.process_module s !3t7J!J rm tokenslist[tokenize.TokenInfo]c * d}t | D ]W\ }\ }}}}}|t j k r|} |t j k r'| ||d |d |dz } | t | k rx|| j t j t j t j fv rH| dz
} | t | k r0|| j t j t j t j fv H| t | k r|| nd }
|dk r8|d t |d |d
| f}t | |
f| j |< Y| j
j j r| | d S d S )Nasciir r ) enumeratetokenizeENCODINGSTRINGprocess_string_tokenr r NEWLINENLCOMMENTencodestr_evalr) r% configcheck_quote_consistency&check_for_consistent_string_delimiters) r r1 encodingi
token_typetokenstartr linej
next_tokens rk process_tokensz$StringConstantChecker.process_tokens s 6?6G6G J J 2A2
E5!TX ... x.. ))%q58DDDE#f++oo&). $ K $= + +
FA #f++oo&). $ K $= + + +,c&kk//VAYYt
w&& #1Xs4
%(
+;+B+B8+L+L'M'M NE-5e__j,I"5) ; 5 @ 7 7 ? ? ? ? ? @ @rm r c < | |j d d S )Ncall) check_for_concatenated_stringsr r s rk r z StringConstantChecker.visit_call ++DIv>>>>>rm
nodes.Listc < | |j d d S )NlistrM r r s rk
visit_listz StringConstantChecker.visit_list rN rm nodes.Setc < | |j d d S )Nr rR r s rk visit_setz StringConstantChecker.visit_set s ++DIu=====rm nodes.Tuplec < | |j d d S )NtuplerR r s rk visit_tuplez!StringConstantChecker.visit_tuple s ++DIw?????rm nodes.Assignc t |j t j r=t |j j t r | |j gd d S d S d S )N
assignment)rt r r r r` rM r s rk visit_assignz"StringConstantChecker.visit_assign si dj%+ . . L:dj>NPS3T3T L / / l K K K K K L L L Lrm Iterable[tokenize.TokenInfo]c t j }|D ]D\ }}}}}|t j k r,t | r |t | xx dz
cc< Et
| dk r| d d d }|D ]^\ }}}}}|t j k rt | }t | r%||k r | d|d |f ]dS dS )a\ Adds a message for each string using inconsistent quote delimiters.
Quote delimiters are used inconsistently if " and ' are mixed in a module's
shortstrings without having done so to avoid escaping an internal quote
character.
Args:
tokens: The tokens to be checked against for consistent usage.
r r r )rG r N) r r r6 r8 !_is_quote_delimiter_chosen_freely_get_quote_delimiterr most_commonr ) r r1 string_delimiterstok_typerE r most_common_delimiterrF quote_delimiters rk rA z f - -CKK',6
rm r} r string_start_colc d} | d| }|dk rd
S ||dz }|||dz }| dd| }|dk r|} ||z }
n"|| dd| z } ||z
dz
}
|| j v r%d|v rnCd |vrn>| d
| |f|
n#|| j vr| d | |f|
|dz
})aJ Check for bad escapes in a non-raw string.
prefix: lowercase string of string prefix markers ('ur').
string_body: the un-parsed body of the string, not including the quote
marks.
start_row: line number in the source.
string_start_col: col number of the string start in the source.
r T\r
r r r )rG r rn r N)findrfindr UNICODE_ESCAPE_CHARACTERSr ESCAPE_CHARACTERS) r r} r rt r r next_charmatch last_newlinerG rn s rk ry z2StringConstantChecker.process_non_raw_string_token^ sY & ( $$T511E{{ $EAI.I 12E ',,T1e< > > 76> 566@ @ @ 76@L L L L D > 4< < < <| ;<</ / / =</ rm r r% r r~ c | t | | t | d S r )register_checkerrz r )r% s rk registerr sB
/ 7 7888
1& 9 9:::::rm rE c | dd dv r | dd } n&| d dv r
| dd } | dd dv r
| dd S | dd
S ) a! Mostly replicate `ast.literal_eval(token)` manually to avoid any performance hit.
This supports f-strings, contrary to `ast.literal_eval`.
We have to support all string literal notations:
https://docs.python.org/3/reference/lexical_analysis.html#string-and-bytes-literals
r r > r+ r/ N> r r r r r > """'''rw r )rx )rE s rk r> r> s
QqSz\))abb q _ , ,abb QqSz^##QrT{ 2;rm string_tokenc t t | pt | S )ar Is this string token a "longstring" (is it triple-quoted)?
Long strings are triple-quoted as defined in
https://docs.python.org/3/reference/lexical_analysis.html#string-and-bytes-literals
This function only checks characters up through the open quotes. Because it's meant
to be applied only to tokens that represent string literals, it doesn't bother to
check for close-quotes (demonstrating that the literal is a well-formed string).
Args:
string_token: The string token to be parsed.
Returns:
A boolean representing whether this token matches a longstring
regex.
)rp SINGLE_QUOTED_REGEXr DOUBLE_QUOTED_REGEX)r s rk _is_long_stringr s= " !!,// 3 $ $\ 2 2 rm c t | }|st d| d | d S )a} Returns the quote character used to delimit this token string.
This function checks whether the token is a well-formed string.
Args:
string_token: The token to be parsed.
Returns:
A string containing solely the first quote delimiter character in the
given string.
Raises:
ValueError: No quote delimiter characters are present.
z
string token z is not a well-formed stringr )QUOTE_DELIMITER_REGEXr
ValueErrorgroup)r r s rk rb rb sJ
" ' ' 5 5E US SSSTTT ;;q>>rm c t | }|dk rdnd}t |o t | o|t | v S )a Was there a non-awkward option for the quote delimiter?
Args:
string_token: The quoted string whose delimiters are to be checked.
Returns:
Whether there was a choice in this token's quote character that would
not have involved backslash-escaping an interior quote character. Long
strings are excepted from this analysis under the assumption that their
quote characters are set by policy.
'")rb rp r r> )r rg unchosen_delimiters rk ra ra sb +<88O /3 6 6C = -- - = h|&<&< < rm )r[ r\ r] r^ r_ r` )rn r ro r` r_ rp r )rE r` r_ r` )r r` r_ rp )r r` r_ r` )>r
__future__r r resysr6 r collections.abcr r typingr ru r r r
astroid.typingr pylint.checkersr r
r r pylint.checkers.utilsr pylint.interfacesr
pylint.typingr pylint.lintr version_infor typing_extensionsrm _PREFIXEScompilerg r r DOTALLr rZ __annotations__r ListLambda FunctionDefListCompSetComp GeneratorExpr rl rx rz r r r> r rb ra r rm rk r s
0 / / " " " " " "
. . . . . . . . & & & & & & & & & & 4 4 4 4 4 4 T T T T T T T T T T T T < < < < < < " " " " " " 0 0 0 0 0 0 %$$$$$$v )))))) Q
4 !bj!?SXXi%8%8!?!?!?@@ bj!BSXXi%8%8!B!B!BCC "
#Dsxx ':':#D#D#DbiPP
( )4 5@ AN O\ ]h it u@ AJ KT U` an o~ L MZ s A A A AH
K J L N M
$
$
$
$ &J J J J J+ J J JZ k k k k k ,.@ k k k\ ; ; ; ;
. * rm