/0S#Z5 U d Z ddlmZ ddlZddlmZ ddlmZmZm Z m
Z
m Z ddl Z ddl m
Z
mZ ddlmZ ddlmZ dd lmZmZmZ dd
lmZ dd lmZ erdd lm Z e e e e e f e
e f Z d
Z e dz Z!dZ"dZ#dZ$dZ%dZ&dZ'dZ(ddhZ)dZ*h dZ+ddhZ,d d d d i d d d d d!d d"d d#d d$d d%d d&d'd(d)d*d+d,d-d.d/d0d-d1d-d2d-d3d-d4d-d5d6d6d7d7d8d8d9d:d;id<Z-d=e.d>< d?hh d@dAhdBZ/dCe.dD< dEh dFih dGh dHdIh dJh dKh dLh dMh dNdOhh dPdQdRhh dSh dTh dUh dVh dWdX
dYZ0dZe.d[< d\d]d^hid_hd`dahh dbdcdddehidfhdghdhdiZ1dje.dk< dwdpZ2 G dq dree Z3dxdvZ4dS )yz0Checkers for various standard library functions. ) annotationsN)Iterable)
TYPE_CHECKINGAnyDictSetTuple)nodesutil)InferenceResult)
interfaces) BaseCheckerDeprecatedMixinutils) INFERENCE)MessageDefinitionTuple)PyLinter)openfile) read_text
write_textz
unittest.casezthreading.Threadz copy.copyz os._Environ)z os.getenvzsubprocess.Popenzsubprocess.run_iopathlib)zbuiltins.breakpointzsys.breakpointhookz
pdb.set_trace> functools.lru_cache$functools._lru_cache_wrapper.wrapper'functools.lru_cache.decorating_functionzbuiltins.staticmethodzbuiltins.classmethod))Nx)intboolfloatzasyncio.tasks.sleep))Nloopzasyncio.tasks.gatherzasyncio.tasks.shieldzasyncio.tasks.wait_forzasyncio.tasks.waitzasyncio.tasks.as_completedz)asyncio.subprocess.create_subprocess_execz*asyncio.subprocess.create_subprocess_shell)) r! zgettext.translation)) codesetzgettext.install)) r$ zfunctools.partialmethod)Nfunczweakref.finalize)r& )Nobjzprofile.Profile.runcallzcProfile.Profile.runcallzbdb.Bdb.runcallztrace.Trace.runfunczcurses.wrapper))Nfunction))Nfn))Ncallback))Nc)Ntypeid)z!unittest.case.TestCase.addCleanupz3concurrent.futures.thread.ThreadPoolExecutor.submitz5concurrent.futures.process.ProcessPoolExecutor.submitz"contextlib._BaseExitStack.callbackz-contextlib.AsyncExitStack.push_async_callbackz&multiprocessing.managers.Server.createz2multiprocessing.managers.SharedMemoryServer.createzrandom.Random.shuffle)) random)r r r r r2 r zIdict[tuple[int, int, int], dict[str, tuple[tuple[int | None, str], ...]]]DEPRECATED_ARGUMENTSzasyncio.coroutine> abc.abstractpropertyabc.abstractclassmethodabc.abstractstaticmethodz importlib.util.module_for_loader)r1 r2 r2 r r2 r" r DeprecationDictDEPRECATED_DECORATORSr0 > cgi.parse_qs
cgi.parse_qslctypes.c_buffertkinter.Misc.tk_menuBar tkinter.Menu.tk_bindForTraversal,distutils.command.sdist.sdist.check_metadata2distutils.command.register.register.check_metadata> os.popen2 os.popen3 os.popen4commands.getstatusmacostools.touched> unittest.case.TestCase.assert_#unittest.case.TestCase.assertEquals&unittest.case.TestCase.assertNotEquals)unittest.case.TestCase.assertAlmostEquals,unittest.case.TestCase.assertNotAlmostEquals'xml.etree.ElementTree.XMLParser.doctype)xml.etree.ElementTree.Element.getchildren)xml.etree.ElementTree.Element.getiterator+xml.etree.ElementTree.XMLParser.getiterator))r% r )r% r > inspect.getargspecfailIfassert_
failUnless failIfEqual assertEqualsassertNotEqualsfailUnlessEqualfailUnlessRaisesfailIfAlmostEqualassertAlmostEqualsassertRaisesRegexpassertRegexpMatchesassertNotAlmostEqualsfailUnlessAlmostEqualassertNotRegexpMatches> ntpath.splituncos.path.splituncbase64.decodestringbase64.encodestringos.stat_float_times turtle.RawTurtle.settiltangle>
cgi.escape#configparser.RawConfigParser.readfprO rP rQ rR >
time.clock logging.warnplatform.popenlogging.Logger.warninspect.getmoduleinfonntplib._NNTPBase.xpathsqlite3.OptimizedUnicodelogging.LoggerAdapter.warn> plistlib.readPlistplistlib.writePlistimportlib.find_loaderplistlib.writePlistToBytesplistlib.readPlistFromBytes importlib.abc.Loader.load_module importlib.abc.Loader.module_repr)importlib.abc.PathEntryFinder.find_loader)importlib.abc.PathEntryFinder.find_modulezasyncio.tasks.async>
fractions.gcd
platform.distinspect.getcallargsinspect.formatargspecplatform.linux_distributionz4importlib._bootstrap_external.FileLoader.load_modulez_ssl.RAND_pseudo_bytes> aifc.openfp wave.openfp sunau.openfp
locale.formatssl.wrap_socketssl.match_hostnameasyncio.Task.all_taskasyncio.Task.current_tasksys.get_coroutine_wrappersys.set_coroutine_wrapperthreading.Thread.isAlive> gettext.lgettextgettext.ldgettextgettext.lngettextgettext.ldngettext gettext.bind_textdomain_codeset'gettext.NullTranslations.output_charset+gettext.NullTranslations.set_output_charsetr > binascii.a2b_hqxbinascii.b2a_hqxbinascii.rlecode_hqxbinascii.rledecode_hqx> cgi.logpathlib.Path.link_tothreading.Event.isSetthreading.activeCountthreading.currentThreadthreading.Thread.getNamethreading.Thread.setNamethreading.Thread.isDaemonthreading.Thread.setDaemon _sqlite3.enable_shared_cache threading.Condition.notifyAll importlib.abc.Finder.find_module!zipimport.zipimporter.find_loader!zipimport.zipimporter.find_module!zipimport.zipimporter.load_module> re.templatelocale.resetlocaleunittest.makeSuiteunittest.findTestCaseslocale.getdefaultlocaleunittest.getTestCaseNames$unittest.TestLoader.getTestCaseNames'unittest.TestLoader.loadTestsFromModule)unittest.TestLoader.loadTestsFromTestCase)
)r2 r r )r2 r. r r2 r% r r: r; )r2 r" r" )r2 r# r )r2 rS r )r2 rT r r1 r4 )r2
r r2 r )r r% r2 zdict[int, DeprecationDict]DEPRECATED_METHODS configparserLegacyInterpolationSafeConfigParserFinder ImpImporter ImpLoader> r SizedMappingCallableHashabler IteratorKeysViewSequence Awaitable Container Coroutine Generator ItemsView
ByteString
Collection
MutableSet
Reversible
ValuesView MappingView
AsyncIterable
AsyncIteratorAsyncGeneratorMutableMappingMutableSequence)z
importlib.abcpkgutil collectionssmtpd MailmanProxyTextMacOSX)typing
webbrowser)r r: r4 r z/dict[tuple[int, int, int], dict[str, set[str]]]DEPRECATED_CLASSESmoder returnr c P t | t sdS t | }d}d|v }|t | z
s t | t | k rdS d|v }d|v }d|v }d|v }d|v }d |v r
|s|s|rdS d
}|r|rdS ||z |z |z } | d k rdS |s|s|s|sdS d
S ) NFzrwatb+Uxr rwatbUTr. )
isinstancestrsetlen)
r modes_modecreatingreadingwriting appendingtextbinarytotals
h/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib/python3.11/site-packages/pylint/checkers/stdlib.py_check_mode_strr ? s dC u IIE Ee|H s5zz SYYU 3 3uUlGUlGu I % dcd@ ZdcdAZdcdBZdddEZdedGZdfdKZ dgdLZ dhdRZ didTZ djdWZ dkdZZ!dld[Z"d\S )m
StdlibCheckerstdlib)z""%s" is not a valid mode for open.
bad-open-modezPython supports: r, w, a[, x] modes with b, +, and U (only with r) options. See https://docs.python.org/3/library/functions.html#openz)Using datetime.time in a boolean context.boolean-datetimezUsing datetime.time in a boolean context can hide subtle bugs when the time they represent matches midnight UTC. This behaviour was fixed in Python 3.5. See https://bugs.python.org/issue13936 for reference.
maxversion)r2 r# )z*Redundant use of %s with constant value %rredundant-unittest-assertzThe first argument of assertTrue and assertFalse is a condition. If a constant is passed as parameter, that condition will be always true. In this case a warning should be emitted.)z*threading.Thread needs the target functionbad-thread-instantiationzThe warning is emitted when a threading.Thread class is instantiated without the target function being passed as a kwarg or as a second argument. By default, the first parameter is the group param, not the target param.)z;Using copy.copy(os.environ). Use os.environ.copy() instead.shallow-copy-environzos.environ is not a dict object but proxy object, so shallow copy has still effects on original object. See https://bugs.python.org/issue15373 for reference.)z$%s does not support %s type argumentinvalid-envvar-valuezwEnv manipulation functions support only string type arguments. See https://docs.python.org/3/library/os.html#os.getenv.)z[singledispatch decorator should not be used with methods, use singledispatchmethod instead.singledispatch-methodzrsingledispatch should decorate functions and not class/instance methods. Use singledispatchmethod for those cases.)z]singledispatchmethod decorator should not be used with functions, use singledispatch instead. singledispatchmethod-functionzrsingledispatchmethod should decorate class/instance methods and not functions. Use singledispatch for those cases.)z,%s default type is %s. Expected str or None.invalid-envvar-defaultzEnv manipulation functions return None or str values. Supplying anything different as a default may cause bugs. See https://docs.python.org/3/library/os.html#os.getenv.)zGUsing preexec_fn keyword which may be unsafe in the presence of threadssubprocess-popen-preexec-fna0 The preexec_fn parameter is not safe to use in the presence of threads in your application. The child process could deadlock before exec is called. If you must use it, keep it trivial! Minimize the number of libraries you call into. See https://docs.python.org/3/library/subprocess.html#popen-constructor)zH'subprocess.run' used without explicitly defining the value for 'check'.subprocess-run-checkzThe ``check`` keyword is set to False by default. It means the process launched by ``subprocess.run`` can exit with a non-zero exit code and fail silently. It's better to set it explicitly to make clear what the error-handling behavior is.)z4Using open without explicitly specifying an encodingunspecified-encodingzIt is better to specify an encoding when opening documents. Using the system default implicitly can create problems on other operating systems. See https://peps.python.org/pep-0597/)zLLeaving functions creating breakpoints in production code is not recommendedforgotten-debug-statementzCalls to breakpoint(), sys.breakpointhook() and pdb.set_trace() should be removed from code that is not actively being debugged.zc'lru_cache(maxsize=None)' or 'cache' will keep all method args alive indefinitely, including 'self'method-cache-max-size-noneaO By decorating a method with lru_cache or cache the 'self' argument will be linked to the function and therefore never garbage collected. Unless your instance will never need to be garbage collected (singleton) it is recommended to refactor code to avoid this pattern or add a maxsize to the cache. The default value for maxsize is 128. old_names)W1516zlru-cache-decorating-method)W1517zcache-max-size-none)W1501W1502W1503W1506W1507E1507E1519E1520W1508W1509W1510W1514W1515W1518z!dict[str, MessageDefinitionTuple]msgslinterr r Nonec t j | | t | _ i | _ i | _ t | _ t t j d
D ]/\ }}|t j k r| j | 0t
D ]/\ }}|t j k r| j | 0t
D ]/\ }}|t j k r| j | 0t
D ]/\ }}|t j k r| j | 0d S )Nr )r __init__r _deprecated_methods_deprecated_arguments_deprecated_classes_deprecated_decoratorsr sys version_infoitemsupdater6 r r= )selfr
since_vers func_list args_list
class_listdecorator_lists r r zStdlibChecker.__init__ sp T6***-0UU TV"8: 03#%78H8K%L%R%R%T%T ; ; !J S ---(// :::%9%?%?%A%A = = !J S ---*11)<<<&8&>&>&@&@ < < "J
S ---(//
;;;*?*E*E*G*G C C &JS ---+22>BBB C Cr node
nodes.Callc d |j D }d|v rd S t |j dk r/|j rd|vr&| d|t
j d S d S d S )Nc h | ] }|j
S arg).0keys r z@StdlibChecker._check_bad_thread_instantiation.. s 8883sw888r targetr% r r+
confidence)keywordsr argskwargs add_messager
HIGH)r% r+ func_kwargss r _check_bad_thread_instantiationz-StdlibChecker._check_bad_thread_instantiation s 88$-888 { " " F ty>>A t{ hk6Q6Q **/
6Q6Qr c p |j r,|j D ]&}|j dk r| d| %d S d S )N
preexec_fnr r+ )r8 r1 r; )r% r+ keywords r _check_for_preexec_fn_in_popenz,StdlibChecker._check_for_preexec_fn_in_popen s` = O =
O
O;,..$$%B$NNN O O
O
Or c r d |j pdD }d|vr | d|t d S d S )Nc h | ] }|j
S r/ r0 r2 rB s r r4 z;StdlibChecker._check_for_check_kw_in_run.. s CCC''+CCCr r/ checkr r6 )r8 r; r )r% r+ r: s r _check_for_check_kw_in_runz(StdlibChecker._check_for_check_kw_in_run sQ CCdm.ArCCC & 3$9 U U U U U ! r c t j |d } | }n# t j $ r Y d S w xY w|D ]9}| t k r| d| d S :d S )Nr )positionr rA )r get_argument_from_callinferredastroidInferenceErrorqname
OS_ENVIRONr; )r% r+ r1
inferred_argsrL s r _check_shallow_copy_environz)StdlibChecker._check_shallow_copy_environ s *4!<<< LLNNMM% FF % H~~ :-- !7d CCC . s - A A r r zdeprecated-methodzdeprecated-argumentr r r r r r zdeprecated-classr r c | | t j |j D ]O}t |t
j r | j t v rd}t |j t j r |j j }t |j t j r |j j
}|t v r.| || j | nj| j t k r| || n0t |t j rf| t( k r| | n| t, k r| | nt |t j r| }|t2 k r| | na|t6 v r| || nA|t: k r| | n |t> v r| d| | ! || QdS )zVisit a Call node.Nr rA )" check_deprecated_class_in_callr infer_allr' r r UninferableBaserootname OPEN_MODULEr
Name AttributeattrnameOPEN_FILES_FUNCS_check_open_call
UNITTEST_CASE_check_redundant_assertClassDefrO THREADING_THREADr> SUBPROCESS_POPENrC FunctionDef COPY_COPYrR ENV_GETTERS_check_env_functionSUBPROCESS_RUNrH DEBUG_BREAKPOINTSr; check_deprecated_method)r% r+ rL open_func_namerX s r
visit_callzStdlibChecker.visit_call sG "
++D111 22 9 9H(D$899
}}#{22-1 di44 4%)Y^N di 99 8%)Y%7N!%555))$
0DnUUU % 66,,T8<<<<Hen55
M>>##'77788>>>> ^^%%)99977===He&788
M ~~''9$$44T::::[((,,T8<<<<^++33D9999 ...$$%@t$LLL ( (x 8 8 8 89 9 9r
nodes.UnaryOpc T |j dk r | |j d S d S )Nnot)op_check_datetimeoperandr% r+ s r
visit_unaryopzStdlibChecker.visit_unaryop< s3 7e . . . . . r nodes.Ifc : | |j d S Nrq testrs s r visit_ifzStdlibChecker.visit_ifA TY'''''r nodes.IfExpc : | |j d S rw rx rs s r visit_ifexpzStdlibChecker.visit_ifexpE r{ r nodes.BoolOpc D |j D ]}| | d S rw )valuesrq )r% r+ values r visit_boolopzStdlibChecker.visit_boolopI s4 [ ( (E ' ' ' ' ( (r r r nodes.FunctionDefc |j rKt |j t j r.| | | | d S d S d S rw )
decoratorsr parentr
ra _check_lru_cache_decorators_check_dispatch_decoratorsrs s r visit_functiondefz StdlibChecker.visit_functiondefN se ? 2z$+u~ F F 2 , ,T 2 2 2 + +D 1 1 1 1 1 2 2 2 2r c t d |j D rdS g }|j j D ]} | D ]}| }|t v r dS |t v rt |t j
ri t j |dd }n# t j
$ r Y n\w xY wt |t j r|j n5| | n |dk r| | n͌# t" j $ r Y w xY w|D ]$}| d|t( j %dS ) zACheck if instance methods are decorated with functools.lru_cache.c 3 > K | ]}t j | V d S rw )r is_enum)r2 ancestors r z.Z s, OO8u}X&&OOOOOOr Nr maxsizerJ rB zfunctools.cacher r6 )anyr ancestorsr r
inferrO NON_INSTANCE_METHODS LRU_CACHEr Callr rK NoSuchArgumentErrorConstr appendrM rN r; r
r )r% r+ lru_cache_nodesd_node infered_nodeq_namer1 lru_cache_nodes r r z)StdlibChecker._check_lru_cache_decoratorsX s OOt{7L7L7N7NOOO O O F.0o+ F
$*LLNN L ) / / 1 1F !555 **z&%*/M/M*""'"> &I# # # CC % 8 " " " !EE" *#u{ ; ; "sy?T !E'..v666 !222'..v666 3 )
- N ,#%/
s= 4D&;#D& B76D&7C
D& C
AD&&D87D8c i }|j j D ]}t |t j r |j r|t
j f||j < :t j | r|t
j f|d< `t j
| r|t
j f|d< d|v r6d|v r2| d|d d |d d d S d|v r6d|v r4| d |d d |d d d S d S d S )
Nsingledispatchsingledispatchmethod classmethodr r r. r6 staticmethodr ) r r
r rZ rX r
r< r (is_registered_in_singledispatch_functionr .is_registered_in_singledispatchmethod_functionr; )r% r+ decorators_map decorators r r z(StdlibChecker._check_dispatch_decorators sj PR . I)UZ00
Y^
2;Z_1My~..?EE
4=z?S3T /00EdKK
(: 56
~ - -->2Q2Q '#$45a8)*:;A>
#n 4 4 .00 /#$:;A>)*@A!D
5 400r r r c t |t j rf|j rat |j d t j r>|j dv r7| d|j |j d j f| d S d S d S d S d S )Nr >
assertTrue assertFalser )r9 r+ ) r rM BoundMethodr9 r
r rX r; r )r% r+ r s r r` z%StdlibChecker._check_redundant_assert s ug 1 2 2
49Q<55
;;; +j$)A,"45
<;r nodes.NodeNGc t | }n# t j $ r Y dS w xY wt |t j r1| dk r| d| dS dS dS )zICheck that a datetime was inferred, if so, emit boolean-datetime warning.Nz
datetime.timer rA )nextr rM rN r InstancerO r; )r% r+ rL s r rq z StdlibChecker._check_datetime s DJJLL))HH% FF
x!1 2 2 < O33 /d ; ; ; ; ; < <33s !$ 77 open_moduler func_namec : d} |dk rt j |dd }n |dk rt j |dd }n# t j $ r Y nw xY w|r|t j | }|t v r_t |t j rEt |j s1|
d||j pt |j |r9t |t j r#|j rd
t |j vrd} |dk rh|j j
d k rt j |dd }nW|j j
d
k rt j |dd }n/t j |dd }nt j |dd }n,# t j $ r |
d| Y nw xY w|rRt j | }t |t j r&|j !|
d| dS dS dS dS dS dS )z Various checks for an open call.Nr r. r r r r r r+ r9 r r encodingr r% r2 r rA )r rK r
safe_inferOPEN_FILES_MODEr r
r r r r; r r' r\ )r% r+ r r mode_arg encoding_args r r^ z StdlibChecker._check_open_call s
e## 71f )) 71f ( D '11H _,, x55 -'77 - # ! >3x~+>+> ! H(EK00 H ^ H (+#hn2E2E'E'E L
D )++y)[88','C 1j( ( ( +|;;','C 1j( ( ( (-'C 1j( ( ( $)#? q*$ $ $L ,
D
D
D !7d CCCCC
D
H $ / = = lEK88 H\=O=W$$%;$$GGGGG? H H (F'E0
H
HH H=W=Ws$ ;A AABF &G ?G c d}d}|j rd |j D }nd }|j r|j d }n|r
||v r || }nd }|r,| |dt j | |d t |j dk r|j d }n|r
||v r || }nd }|r.| ||d
t j | d d S d S )
Nr3 defaultc ( i | ]}|j |j S r/ )r1 r rF s r
z5StdlibChecker._check_env_function.. s NNNWgk7=NNNr r r F)r+ messagecall_argr
allow_noner% r. r T)r+ r r r r )r8 r9 _check_invalid_envvar_valuer r r )r% r+ r env_name_kwargenv_value_kwargr: env_name_arg
env_value_args r rg z!StdlibChecker._check_env_function sC # = NN
NNNFFF 9 9Q>Q IaLMM
!611 "? 3MM M , ,0 )-88
-
r r r InferenceResult | Noner r c |t |t j rd S | }t |t j r[d}|j | }n t |j t sd}|r.| |||| f d S d S | |||| f d S )NFTr )
r r rV rO r
r r r r; pytype)r% r+ r r r r rX emits r r z)StdlibChecker._check_invalid_envvar_value s z(D4H I I F{{}} h , , QD~%%~ 44
U t4 ARAR:S TTTTT
U
U
W4tX__=N=N6O P P P P Pr set[str]c | j S rw )r r% s r deprecated_methodsz StdlibChecker.deprecated_methods7 s ''r method"tuple[tuple[int | None, str], ...]c 8 | j |d S Nr/ )r get)r% r s r deprecated_argumentsz"StdlibChecker.deprecated_arguments: s )--fb999r module
Iterable[str]c 8 | j |d S r )r r )r% r s r deprecated_classesz StdlibChecker.deprecated_classes= s '++FB777r c | j S rw )r r s r deprecated_decoratorsz#StdlibChecker.deprecated_decorators@ s **r Nr r r r )r+ r, r r )r+ rm r r )r+ ru 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+ 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 )#__name__
__module__ __qualname__rX r DEPRECATED_METHOD_MESSAGEDEPRECATED_ARGUMENT_MESSAGEDEPRECATED_CLASS_MESSAGE DEPRECATED_DECORATOR_MESSAGEr __annotations__r r> rC rH rR r only_required_for_messagesrl rt rz r~ r r r r r` rq r^ rg r r r r r r/ r r r r ] s Dt/
3t/
5t/
2t/
6 t/
8
D 6 "
r (
4 <4
Kt/ t/ t/D t t t tlC C C C, O O O O V V V V
&U%# " % # 9 9 9 9B &U%&899/ / / :9/ &U%&899( ( ( :9( &U%&899( ( ( :9( &U%&899( ( ( :9( &U%$ '
2 2 2
2
( ( ( (T <
<
<
<
<>H >H >H >H@% % % %NQ Q Q Q.( ( ( (: : : :8 8 8 8+ + + + + +r r r r r c J | t | d S rw )register_checkerr )r s r registerr D s$
M& 1 122222r )r r r r r )5__doc__
__future__r r! collections.abcr r r r r r r rM r
r astroid.typingr pylintr
pylint.checkersr r r pylint.interfacesr
pylint.typingr pylint.lintr r r r< r r] r_ rb re rP rf rc rh rY ri r r r6 r r= r r r r r r/ r r r sJ
7 6 6 " " " " " "
$ $ $ $ $ $ 7 7 7 7 7 7 7 7 7 7 7 7 7 7 * * * * * * ? ? ? ? ? ? ? ? ? ? ' ' ' ' ' ' 0 0 0 0 0 0 %$$$$$$uS#s]+SX56""%@@
%
% !i R
01GH
0 1 1 !"3
/ %&7
45F 5n 0 , "#4 ; "#4 #$5 , 0! " +# $ .C?NAP.C9N2Q?
1 : ()9:G$ $ & & & &R $$
33* *
*
$
**
C $
"
e} }A^2 ^2 ^ ^ ^ ^F !
# #J
a8G 8G 8 8 8 8v