yIf(UdZddlmZddlZddlmZddlmZmZm Z m Z m Z ddl Z ddl m Z mZddlmZddlmZdd lmZmZmZdd lmZmZdd lmZerdd lmZe e eeefe efZ d Z!ge!ddRZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)ddhZ*dZ+hdZ,ddhZ-ddddidd d!d d"d d#d d$d d%d d&d d'd(d)d*d+d,d-d.d/d0d1d.d2d.d3d.d4d.d5d.d6d7d7d8d8d9d9d:d;dd?d@dAdBZ.dCe/dD<dEhhdFdGhdHZ0dIe/dJ<dKhdLihdMhdNdOhdPhdQhdRhdShdTdUhhdVdWdXhhdYhdZhd[hd\hd]hd^d_d`Z1dae/db<dcdddehidfhdgdhhhdidjdkdlhidmhdnhdohdphdqdrhhdshdtdudvZ2dwe/dx<dyhhdzd{Z3dIe/d|<ddZ4GddeeZ5ddZ6dS)z0Checkers for various standard library functions.) annotationsN)Iterable) TYPE_CHECKINGAnyDictSetTuple)nodesutil)InferenceResult) interfaces) BaseCheckerDeprecatedMixinutils)HIGH 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))type)r#choices)metavar))r/value)r& traceback))r/isdst))r&onerror)zargparse.BooleanOptionalActionzcoroutine.throwzemail.utils.localtimez shutil.rmtree)rrrr1rr1 rr1 rzIdict[tuple[int, int, int], dict[str, tuple[tuple[int | None, str], ...]]]DEPRECATED_ARGUMENTSzasyncio.coroutine>abc.abstractpropertyabc.abstractclassmethodabc.abstractstaticmethodz importlib.util.module_for_loader)r;r1r1rr1r#rDeprecationDictDEPRECATED_DECORATORSr:> 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&r4r>inspect.getargspecfailIfassert_ failUnless failIfEqual assertEqualsassertNotEqualsfailUnlessEqualfailUnlessRaisesfailIfAlmostEqualassertAlmostEqualsassertRaisesRegexpassertRegexpMatchesassertNotAlmostEqualsfailUnlessAlmostEqualassertNotRegexpMatches>ntpath.splituncos.path.splituncbase64.decodestringbase64.encodestringos.stat_float_timesturtle.RawTurtle.settiltangle> cgi.escape#configparser.RawConfigParser.readfprZr[r\r]> 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.ldngettextgettext.bind_textdomain_codeset'gettext.NullTranslations.output_charset+gettext.NullTranslations.set_output_charsetr> binascii.a2b_hqxbinascii.b2a_hqxbinascii.rlecode_hqxbinascii.rledecode_hqximportlib.resources.pathimportlib.resources.contentsimportlib.resources.open_textimportlib.resources.read_textimportlib.resources.is_resourceimportlib.resources.open_binaryimportlib.resources.read_binary>cgi.logpathlib.Path.link_tothreading.Event.isSetthreading.activeCountthreading.currentThreadthreading.Thread.getNamethreading.Thread.setNamethreading.Thread.isDaemonthreading.Thread.setDaemon_sqlite3.enable_shared_cachethreading.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.getTestCaseNamesunittest.TestProgram.usageExit$unittest.TestLoader.getTestCaseNames'unittest.TestLoader.loadTestsFromModule)unittest.TestLoader.loadTestsFromTestCase>pty.slave_openpty.master_openpkgutil.get_loaderpkgutil.find_loaderbuiltins.bool.__invert__datetime.datetime.utcnow"datetime.datetime.utcfromtimestamp&xml.etree.ElementTree.Element.__bool__))r1rr)r1r/rr1r&rrErF)r1r#r#)r1r$r)r1r^r)r1r4rr;r=)r1 rr1 rr?)rr&r1zdict[int, DeprecationDict]DEPRECATED_METHODS configparserLegacyInterpolationSafeConfigParserFinder ImpImporter ImpLoader>rSizedMappingCallableHashablerIteratorKeysViewSequence Awaitable Container Coroutine Generator ItemsView ByteString Collection MutableSet Reversible ValuesView MappingView AsyncIterable AsyncIteratorAsyncGeneratorMutableMappingMutableSequence) importlib.abcpkgutil collectionssmtpd MailmanProxyTextMacOSX)typing webbrowser>NumStrBytesEllipsis NameConstant>FastChildWatcherSafeChildWatcherAbstractChildWatcherMultiLoopChildWatcherr> TraversableResourceReaderTraversableResources>rrr)astasynciozcollections.abcrr)rrEr=rr?z/dict[tuple[int, int, int], dict[str, set[str]]]DEPRECATED_CLASSESz"configparser.ParsingError.filename> sys.last_typesys.last_valuecalendar.Januarycalendar.Februarysys.last_traceback)rr?DEPRECATED_ATTRIBUTESmoderreturnr cPt|tsdSt|}d}d|v}|t|z s t|t|krdSd|v}d|v}d|v}d|v}d|v}d |vr |s|s|rdSd }|r|rdS||z|z|z} | d krdS|s|s|s|sdSd S) NFzrwatb+UxrrwatbUTr/) isinstancestrsetlen) r modes_modecreatingreadingwriting appendingtextbinarytotals J/var/www/piapp/venv/lib/python3.11/site-packages/pylint/checkers/stdlib.py_check_mode_strr"s dC u IIE Ee|H s5zzSYYU33uUlGUlGu I %ddd@ZdddAZdddBZdedEZdfdGZdgdKZdhdLZdidRZdjdTZ dkdWZ!dldZZ"dmd[Z#dmd\Z$d]S)n 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)r1r$)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-fna0The 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-noneaOBy 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]msgslinterrr Nonectj||t|_i|_i|_t|_t|_ttj d D]/\}}|tj kr|j |0t D]/\}}|tj kr|j |0t D]/\}}|tj kr|j |0t D]/\}}|tj kr|j |0t D]/\}}|tj kr|j |0dS)Nr)r__init__r_deprecated_methods_deprecated_arguments_deprecated_classes_deprecated_decorators_deprecated_attributesrsys version_infoitemsupdaterArrHr )selfrH since_vers func_list args_list class_listdecorator_listattribute_lists r!rKzStdlibChecker.__init__sT6***-0UU TV"8: 03#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*?*E*E*G*G C C &JS---+22>BBB C Cr#node nodes.Callcd|jD}d|vrdSt|jdkr/|jrd|vr&|d|t jdSdSdS)Nch|] }|j Sarg).0keys r! z@StdlibChecker._check_bad_thread_instantiation..4s8883sw888r#targetr&r+r\ confidence)keywordsrargskwargs add_messager r)rUr\ func_kwargss r!_check_bad_thread_instantiationz-StdlibChecker._check_bad_thread_instantiation3s88$-888 { " " F ty>>A  t{ hk6Q6Q   **/        6Q6Qr#cp|jr,|jD]&}|jdkr|d|%dSdS)N preexec_fnr1r\)rirbrl)rUr\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#crd|jpdD}d|vr|d|tdSdS)Nch|] }|j Sr`rarcrrs r!rez;StdlibChecker._check_for_check_kw_in_run..DsCCC''+CCCr#r`checkr2rg)rirlr)rUr\rks r!_check_for_check_kw_in_runz(StdlibChecker._check_for_check_kw_in_runCsQCCdm.ArCCC &   3$9  U U U U U ! r#ct} tj|dd}n7#tj$r%tj|d}|sYdSt }YnwxYw |}n#tj$rYdSwxYw|D]:}| tkr| d||dS;dS)Nrrpositionrrrrr,rg) rrget_argument_from_callNoSuchArgumentErrorinfer_kwarg_from_callrinferredastroidInferenceErrorqname OS_ENVIRONrl)rUr\rhrb inferred_argsrs r!_check_shallow_copy_environz)StdlibChecker._check_shallow_copy_environHs   #.taMMMCC( # # #-dC@@@C "JJJ  #  LLNNMM%    FF %  H~~:--  **! .  s'!'A AAA..BBr'r*zdeprecated-methodzdeprecated-argumentr+r,r-r0r1r2zdeprecated-classr3r4c||tj|jD]O}t |t jr|jtvrd}t |jtj r |jj}t |jtj r |jj }|tvr.|||j|nj|jt kr|||n0t |tjrf|t(kr||n|t,kr||nt |tjr|}|t2kr||na|t6vr|||nA|t:kr||n |t>vr| d||!||QdS)zVisit a Call node.Nr4rq)"check_deprecated_class_in_callr infer_allr(rr UninferableBaserootname OPEN_MODULEr Name AttributeattrnameOPEN_FILES_FUNCS_check_open_call UNITTEST_CASE_check_redundant_assertClassDefrTHREADING_THREADrnSUBPROCESS_POPENrs FunctionDef COPY_COPYr ENV_GETTERS_check_env_functionSUBPROCESS_RUNrxDEBUG_BREAKPOINTSrlcheck_deprecated_method)rUr\ropen_func_namers r! visit_callzStdlibChecker.visit_call\sG" ++D111 22 9 9H(D$899 }}#{22-1di444%)Y^Ndi998%)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.UnaryOpcT|jdkr||jdSdS)Nnot)op_check_datetimeoperandrUr\s r! visit_unaryopzStdlibChecker.visit_unaryops3 7e     . . . . .  r#nodes.Ifc:||jdSNrtestrs r!visit_ifzStdlibChecker.visit_if TY'''''r# nodes.IfExpc:||jdSrrrs r! visit_ifexpzStdlibChecker.visit_ifexprr# nodes.BoolOpcD|jD]}||dSr)valuesr)rUr\r6s r! visit_boolopzStdlibChecker.visit_boolops4[ ( (E   ' ' ' ' ( (r#r.r/nodes.FunctionDefc|jrKt|jtjr.||||dSdSdSr) decoratorsrparentr r_check_lru_cache_decorators_check_dispatch_decoratorsrs r!visit_functiondefzStdlibChecker.visit_functiondefse ? 2z$+u~FF 2  , ,T 2 2 2  + +D 1 1 1 1 1 2 2 2 2r#ctd|jDrdSg}|jjD]} |D]}|}|tvrdS|tvrt|tj r} tj |dd}n*#tj $rtj|d}YnwxYwt|tjr|jn5||n|dkr||n#t$j$rY wxYw|D]$}|d|t*j%dS) zACheck if instance methods are decorated with functools.lru_cache.c3>K|]}tj|VdSr)ris_enum)rcancestors r! z.s,OO8u}X&&OOOOOOr#Nrmaxsizerzzfunctools.cacher5rg)anyr ancestorsrr inferrNON_INSTANCE_METHODS LRU_CACHErCallrr}r~rConstr6appendrrrlr r)rUr\lru_cache_nodesd_node infered_nodeq_namerblru_cache_nodes r!rz)StdlibChecker._check_lru_cache_decoratorss OOt{7L7L7N7NOOO O O  F.0o+  F $*LLNNL)//11F!555**z&%*/M/M*Q"'"> &I###CC %8QQQ"'"=fi"P"PCCCQ *#u{;;"sy?T!E'..v666!222'..v6663)    -  N   ,#%/       s=4D;<#D; B87D;8$CD;CAD;;E Eci}|jjD]}t|tjr|jr|t jf||j<:tj|r|t j f|d<`tj |r|t j f|d<d|vr6d|vr2| d|dd|dddSd|vr6d|vr4| d |dd|dddSdSdS) Nsingledispatchsingledispatchmethod classmethodr.rr/rg staticmethodr/) rr rrrr rr(is_registered_in_singledispatch_functionr.is_registered_in_singledispatchmethod_functionrl)rUr\decorators_map decorators r!rz(StdlibChecker._check_dispatch_decoratorssjPR.  I)UZ00 Y^ 2;Z_1My~..?EE 4=z?S3T/00EdKK (:56 ~ - -->2Q2Q   '#$45a8)*:;A>       #n 4 4.00   /#$:;A>)*@A!D       5 400r#rr ct|tjrf|jrat|jdtjr>|jdvr7|d|j|jdjf|dSdSdSdSdS)Nr> assertTrue assertFalser*)rjr\) rr BoundMethodrjr rrrlr6)rUr\rs r!rz%StdlibChecker._check_redundant_asserts ug1 2 2   49Q<55  ;;;   +j$)A,"45            <;r# nodes.NodeNGc t|}n#tj$rYdSwxYwt |tjr/|dvr|d|dSdSdS)zICheck that a datetime was inferred, if so, emit boolean-datetime warning.N> datetime.time_pydatetime.timer(rq)nextrrrrInstancerrl)rUr\rs r!rzStdlibChecker._check_datetimes DJJLL))HH%    FF  h 0 1 1 3x~+>+>) !' (EK00' ^' (+#hn2E2E'E'EJ )++y)[88','C 1j((( +|;;','C 1j((( (-'C 1j((( $)#?q*$$$L,   $:4TTT !*JJ$$.Tj%   $/ == lEK88\=O=W$$.Tj%K' ' (F'E<  =W=Ws%;A.A87A8=BGAH  H cd}d}|jrd|jD}nd}|jr|jd}n|r ||vr ||}nd}|r,||dtj||dt |jdkr|jd }n|r ||vr ||}nd}|r.|||d tj|d dSdS) Nrddefaultc(i|]}|j|jSr`)rbr6rvs r! z5StdlibChecker._check_env_function..XsNNNWgk7=NNNr#rr-F)r\messagecall_argr allow_noner&r/r0T)r\rrrr)rirj_check_invalid_envvar_valuerrr)rUr\renv_name_kwargenv_value_kwargrk env_name_arg env_value_args r!rz!StdlibChecker._check_env_functionTsC# = NN NNNFFF 9 9Q>Q   IaLMM  !611"?3MM M    , ,0)-88 -       r#rrInferenceResult | Nonerr c|t|tjrdS|}t|tjr[d}|j| }nt|jtsd}|r.||||| fdSdS||||| fdS)NFT)r\rj) rr rrr rr6rrlpytype)rUr\rrrrremits r!rz)StdlibChecker._check_invalid_envvar_value{s  z(D4HII  F{{}} h , , QD~%%~44  U  t4ARAR:S TTTTT U U   W4tX__=N=N6O  P P P P Pr#set[str]c|jSr)rLrUs r!deprecated_methodsz StdlibChecker.deprecated_methodss ''r#method"tuple[tuple[int | None, str], ...]c8|j|dSNr`)rMget)rUrs r!deprecated_argumentsz"StdlibChecker.deprecated_argumentss)--fb999r#module Iterable[str]c8|j|dSr)rNr)rUrs r!deprecated_classesz StdlibChecker.deprecated_classess'++FB777r#c|jSr)rOrs r!deprecated_decoratorsz#StdlibChecker.deprecated_decorators **r#c|jSr)rPrs r!deprecated_attributesz#StdlibChecker.deprecated_attributesr r#NrHrr rI)r\r]r rI)r\rr rI)r\rr rI)r\rr rI)r\rr rI)r\rr rI)r\r]rr r rI)r\rr rI)r\r]rrrrr rI)r\r]rrr rI) r\r]rrrrrrrr r rI)r r)rrr r)rrr r)r r)%__name__ __module__ __qualname__rrDEPRECATED_METHOD_MESSAGEDEPRECATED_ARGUMENT_MESSAGEDEPRECATED_CLASS_MESSAGEDEPRECATED_DECORATOR_MESSAGEDEPRECATED_ATTRIBUTE_MESSAGErG__annotations__rKrnrsrxrronly_required_for_messagesrrrrrrrrrrrrrrrr r rr`r#r!r%r%s Du/  3u/  5u/  2u/  6 u/  6 u/   8  D6 "              r ( 4 <4  Mu/u/u/DuuuunCCCC4OOOO VVVV (&U%#" %#9999B&U%&899///:9/&U%&899(((:9(&U%&899(((:9(&U%&899(((:9(&U%$' 222  2 ((((T<     < < < <IIIIV%%%%NQQQQ.((((::::8888++++++++++r#r%rHrrIcJ|t|dSr)register_checkerr%)rHs r!registerrs$ M&1122222r#)r rr r r)7__doc__ __future__rrQcollections.abcrrrrrrr rr r astroid.typingr pylintr pylint.checkersrrrpylint.interfacesrr pylint.typingr pylint.lintrrrrGrrrrrrrrrrrrrrArrHrrr r"r%rr`r#r!r&s 766"""""" $$$$$$77777777777777******??????????--------000000%$$$$$$uS#s]+SX56"@_@k@<@@ %    %!i R    01GH 0 1  1 !"3  /  %&7  45F 5n 0 , "#4 ; "#4 #$5 , 0!" +#$.C?NAP.C9N2Q? 1:()9:*W;!0* I**,,,,^$$ 33**            *   $              **    C $                "        KOOAp2p2ppppj  !          ##J                     -qTGTGTTTTr - * *    <@+@+@+@+@+O[@+@+@+F333333r#