+ i \a0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RI t ^RI t ^RI t ^RI t ^RI t ^RIt^RIHtHtHt^RIHtHt^RIHt^RI Ht^RIHt^RIHtHt] P<!]4t ] PBPER 4'dRXt#RYt$RZt%MR[t#R\t$R]t%] PL!R 4] PL!R 40t'] PPR 8Xdl]'PS] PTPW] PXR 44]'PS] PTPW] PZR 44] PPR8XdX] PZt,R]0R&RRlt1]'PS]1!R44] PdR^8d]'PS]1!R44] PL!R4] PL!R40t3]4Pk] PlR4t7!RR]84t9RRlt:]3RRllt;RRlt<]R R!l4t=R"R#lt>R$R%lt?R&R'lt@R(R)ltAR*R+ltBR,R-ltCR.R/ltDR_R0R1lltER`R2R3lltFR_R4R5lltGR_R6R7lltHR`R8R9lltIRaR:R;lltJRbR<R=lltKR>R?ltLR@RAltMRBRCltNR`RDRElltORFRGltP]!RHRI7RJRKl4tQR_RLRMlltRRNROltS]!RHRI7RPRQl4tTRRRSltURTRUltVRVRWltWR# ].dJ]'PS] PTPW] P^R 44EL ].dELi;ii;i ].d] PXt,ELi;i)caVPython modules manipulation utility functions. :type PY_SOURCE_EXTS: tuple(str) :var PY_SOURCE_EXTS: list of possible python source file extension :type STD_LIB_DIRS: set of str :var STD_LIB_DIRS: directories where standard modules are located :type BUILTIN_MODULES: dict :var BUILTIN_MODULES: dictionary with builtin module names has key ) annotationsN)CallableIterableSequence)redirect_stderrredirect_stdout) lru_cache)stdlib_module_names) IS_JYTHON)specutilwinstdlib platstdlibntdllsposixstrprefixc V^8dQhRRRR/#pathrreturn)formats"2/usr/lib/python3/dist-packages/astroid/modutils.py __annotate__rRs77#7#7cR\PR,,p\PP \ W4#)z python%d.%d:NrN)sys version_infoosrjoinr)r base_pythons& r _posix_pathr%Rs,#c&6&6r&:: ww||FD66rliblib64purelibplatlibTc]tRt^etRtRtR#) NoSourceFilezZException raised when we are not able to get a python source file for a precompiled file. rN)__name__ __module__ __qualname____firstlineno____doc____static_attributes__rrrr+r+esrr+c V^8dQhRRRR/#rr)rs"rrrks44#4#4rcz\PP\PPV44#)zResolve symlinks in path and convert to absolute path. Note that environment variables and ~ in the path need to be expanded in advance. This can be cached by using _cache_normalize_path. )r"rnormcaserealpathrs&r_normalize_pathr7ks( 77  BGG,,T2 33rc$V^8dQhRRRRRR/#)rfilenamer is_jythonboolrr)rs"rrrvs!#$srcdV'gV#VPR4wr#pV'd VR,#V#)z $py.class.py) partition)r9r:head has_pyclass_s&& r_path_from_filenamerBvs1 #--k:Dqe| Orc(V^8dQhRRRRRRRR/#)r blacklist Sequence[str]dirnames list[str] filenamesrNoner)rs"rrrs, ' ' '(1 '>G '  'rc|VF5pW19dVPV4KW29gK$VPV4K7 R#)zYRemove files/directories in the black list. dirnames/filenames are usually from os.walk N)remove)rDrFrHnorecurss&&& r_handle_blacklistrMs4   OOH %  "   X & rc V^8dQhRRRR/#rr)rs"rrrs!!!!rc\V4#N)r7r6s&r_cache_normalize_path_rQs 4  rc V^8dQhRRRR/#rr)rs"rrrs((((rc>V'g \V4#\V4#)zNormalize path with caching.)r7rQr6s&r_cache_normalize_pathrTs t$$ !$ ''rc V^8dQhRRRR/#)r dotted_namerrtypes.ModuleTyper)rs"rrrs##s#/?#rc H\PV,# \dMi;i\\P !44;_uu_4p\ \P !44;_uu_4p\P!T4pRRR4M +'giM;iRRR4M +'giM;iXP4pT'd\PRY4XP4pT'd\PRY4X#)zLoad a Python module from its name. :type dotted_name: str :param dotted_name: python name of a module or package :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module Nz&Captured stderr while importing %s: %sz&Captured stdout while importing %s: %s) r modulesKeyErrorrioStringIOr importlib import_modulegetvalueloggererrorinfo)rVstderrstdoutmodule stderr_value stdout_values& rload_module_from_namerhs {{;''     &&& &&&((5 '&&& '&&& ??$L 5{ ??$L 5{  Ms0 '''B37B  B3 B' "B33 C c V^8dQhRRRR/#)rpartsrErrWr)rs"rrrs 2 2M 26F 2rc6\RPV44#)zLoad a python module from its split name. :param parts: python name of a module or package split on '.' :raise ImportError: if the module or package is not found :return: the loaded module .)rhr#)rjs&rload_module_from_modpathrms !% 11rc V^8dQhRRRR/#)rfilepathrrrWr)rs"rrrs - -C -,< -rc.\V4p\V4#)zLoad a Python module from it's path. :type filepath: str :param filepath: path to the python module or package :raise ImportError: if the module or package is not found :rtype: module :return: the loaded module )modpath_from_filerm)romodpaths& rload_module_from_filerss )G #G ,,rc$V^8dQhRRRRRR/#)rrrmod_pathrGrr;r)rs"rrrs!    d rc.pVFvpVPV4\PPW4p\ V4'dKF\ P !RPV44pV'dKuR# R#)z3Check there are some __init__.py all along the way.rlFT)appendr"rr# _has_initr is_namespace)rrurrpart old_namespaces&& rcheck_modpath_has_initr|s^Gtww||D' --chhw.?@M =  rc$V^8dQhRRRRRR/#)rrrbaserr;r)rs"rrrs!  c   rc\PP\PPV44p\PP\PPV44pVP V4'gR#\ V4\ V48H;'gV\ V4,\PP 8H;'gfVP\PP 4;'d5V\ V4^, ,\PP 8H#F)r"rr4normpath startswithlensependswith)rr~s&&r _is_subpathrs 77  BGG,,T2 3D 77  BGG,,T2 3D ??4  Tc$i  O O TOrww{{ * O O MM"''++ & M M4D A +>"''+++Mrc$V^8dQhRRRRRR/#)rr9r path_to_checkrlist[str] | Noner)rs"rrrs"c#BRrc\PP\PPV44p\PP V4p\ W!4'd\PP V4^,pV\V4RP\PP4pVP\P4Uu.uFqU'gK VNK up#\PPV4p\ Wa4'd\PP V4^,pV\V4RP\PP4pVP\P4Uu.uFqU'gK VNK up#R#uupiuupi)aExtracts the relative mod path of the file to import from. Check if a file is within the passed in path and if so, returns the relative mod path from the one passed in. If the filename is no in path_to_check, returns None Note this function will look for both abs and realpath of the file, this allows to find the relative base path even if the file is a symlink of a file in the passed in path Examples: _get_relative_base_path("/a/b/c/d.py", "/a/b") -> ["c","d"] _get_relative_base_path("/a/b/c/d.py", "/dev") -> None N) r"rr4rabspathrsplitextrlstriprsplitr5)r9r abs_filename base_pathrelative_base_pathpkg real_filenames&& r_get_relative_base_pathrsD GG$$RWW%5%5m%DEM77??8,L<//GG$$\215 &s='9';<CCBGGKKP177?G?3?GGGG$$X.M=00GG$$]3A6 &s='9';<CCBGGKKP177?G?3?GG H Hs) G7G, G :G c(V^8dQhRRRRRRRR/#) rr9rrr is_package_cbz'Callable[[str, list[str]], bool] | NonerrGr)rs"rrrs0 ; rc\PP\V44p\PP 4pV'd W,p\ P!V\\V44F=pV'gK \W4pV'gK"VfQhV!WERR4'gK;Vu# \RPVRPV444h)Nz"Unable to find module for {} in {}z, )r"r expanduserrBr copy itertoolschainmaprTr ImportErrorrr#)r9rrpaths_to_checkpathnamerrs&&& rmodpath_from_file_with_callbackrs ww!!"5h"?@HXX]]_N .OO1>B )(= ((( 3B< 0 0N ,33 fkk.1  rc$V^8dQhRRRRRR/#)rr9rrrrrGr)rs"rrr4s'SSS+;SySrc"\W\4#)aGet the corresponding split module's name from a filename. This function will return the name of a module or package split on `.`. :type filename: str :param filename: file's path for which we want the module's name :type Optional[List[str]] path: Optional list of paths where the module or package should be searched, additionally to sys.path :raise ImportError: if the corresponding module's name has not been found :rtype: list(str) :return: the corresponding split module's name )rr|)r9rs&&rrqrq4s$ +8;Q RRrc(V^8dQhRRRRRRRR/#)rrrrGrSequence[str] | None context_file str | Nonerr)rs"rrrIs6HH H HH Hrc.\WV4P#rP)file_info_from_modpathlocation)rrrrs&&&rfile_from_modpathrIs "' > G GGrc(V^8dQhRRRRRRRR/#) rrrrGrrrrrspec.ModuleSpecr)rs"rrrQs00606 06 0606 06rcVe!\PPV4pMTpV^,R8Xd\R.VR,OW4#VRR.8XdJ\ P !R\PP\ PPR7#\WV4# \d\YT4u#i;i)a,Given a mod path (i.e. split module / package name), return the corresponding file. Giving priority to source file over precompiled file if it exists. :param modpath: split module's name (i.e name of a module or package split on '.') (this means explicit relative imports that start with dots have empty strings in this list!) :param path: optional list of path where the module or package should be searched (use sys.path if nothing or None is given) :param context_file: context file to consider, necessary if the identifier has been introduced using a relative import unresolvable in the actual context (i.e. modutils) :raise ImportError: if there is no such module in the directory :return: the path to the module's file or None if it's an integrated builtin module such as 'sys' xml_xmlplusNNr"ros.path)namertype) r"rdirname_spec_from_modpathrr ModuleSpec__file__ ModuleType PY_SOURCE)rrrrcontexts&&& rrrQs> ggool;qzU >%z&@GBK&@$P P T6N "WW%%**  gW 55 >%gW= = >sB**CCc$V^8dQhRRRRRR/#)rrVrrrrr)rs"rrrs!:::J:#:rc VPR4'dR#VPR4pVe7V^,\9d%\V4^8d \ V4hV^,#Rp^pV^,R8XdVfQR4h.p^pV\V48dCW$,R8Xd6V^, pVfQR4h\ P PV4pKR\V\V44Fp\W$V^,W1R7K V# \d<T\^\T4^, 48dhRPTRT4uu#i;i)auGiven a dotted name return the module part of the name : >>> get_module_part('astroid.as_string.dump') 'astroid.as_string' :param dotted_name: full name of the identifier we are interested in :param context_file: context file to consider, necessary if the identifier has been introduced using a relative import unresolvable in the actual context (i.e. modutils) :raise ImportError: if there is no such module in the directory :return: the module part of the name or None if we have not been able at all to import the given name XXX: deprecated, since it doesn't handle package precedence over module (see #10066) rrlNz.explicit relative import, but no context_file?)rr) rrBUILTIN_MODULESrrr"rrrangermaxr#)rVrrjrstartiis&& rget_module_partrsN.i((   c "E 8 &5zA~!+..8O!D F Qx2~  $ < ; < $ 3u: %-2"5!   $ < ; < $ww|4 63u: & ' q1u%D '   '3q#e*q.))88E"1I& & 's1D  AEEc(V^8dQhRRRRRRRR/#) r src_directoryrrDrElist_allr;rrGr)rs"rrrs,   #0 <@  rcZ.p\P!V4FwrEpWA9dK\WV4V'g!RR0PV4'dRVR&KBVFFp\ V4'gK\P P WG4pVPV4KH K V#)aGiven a package directory return a list of all available python module's files in the package and its subpackages. :param src_directory: path of the directory corresponding to the package :param blacklist: iterable list of files or directories to ignore. :param list_all: get files from all paths, including ones without __init__.py :return: the list of all available python module's files in the package and its subpackages z __init__.pyz __init__.pyi:NNNr)r"walkrM isdisjoint_is_python_filerr#rw) rrDrfiles directoryrFrHr9srcs &&& rget_module_filesrs&E*,''-*@& Y  ! )y9]N;FFyQQHQK !Hx((ggll97 S!"+A Lrc(V^8dQhRRRRRRRR/#)rr9rinclude_no_extr; prefer_stubsrr)rs"rrrs,!!!#'!?C!!rcH\PP\V44p\PP V4wr4VP R4pV\ 9d2\PPV RV 24'dV RV 2#V'd\M\ F3pV RV 2p\PPV4'gK1Vu# V'd0V'g(\PPV4'dV#\V4h)aWGiven a python module's file name return the matching source file name (the filename will be returned identically if it's already an absolute path to a python source file). :param filename: python module's file name :raise NoSourceFile: if no source file exists on the file system :return: the absolute path of the source file if it exists rl) r"rrrBrrPY_SOURCE_EXTSexistsPY_SOURCE_EXTS_STUBS_FIRSTr+)r9rrr~orig_extext source_paths&&& rget_source_filersww28<=HWW%%h/NDs#H~%"''..D68*9M*N*Nq ##-9)~Mauo 77>>+ & & Nh277>>$+?+? x  rc V^8dQhRRRR/#)rr9rrr;r)rs"rrrs??z?d?rc~V'gR#\PPV4^,R,\9#)z5Return: True if the filename is a python source file.Fr)r"rrrr9s&ris_python_sourcers,  77  H %a ( , >>rc V^8dQhRRRR/#)rmodnamerrr;r)rs"rrrs88c8d8rc@VPR4^,\9#)z6Return: True if the modname is in the standard libraryrl)rr )rs&ris_stdlib_modulers == a $7 77rc$V^8dQhRRRRRR/#)rrrrzstr | Iterable[str]rr;r)rs"rrr s'TTCT':TtTrchaVPR4^,p\V.4oSfR#\S4o\ T\ 4'dSP \T44#\;QJdT3RlT4F 'gK R# R#!T3RlT44# \dR#i;i)zTry to determine if a module is imported from one of the specified paths :param modname: name of the module :param path: paths to consider :return: true if the module: - is located on the path listed in one of the directory in `paths` rlFc3X<"TFpSP\V44xK! R#5irPrrT).0entryr9s& r !module_in_path..&s%SdUx""#8#?@@d'*T) rrrr7 isinstancerrrTany)rrr9s&&@rmodule_in_pathr smmC #G$gY/ x(H$""#8#>?? 3SdS33S3S3SdS SS s B"" B10B1c$V^8dQhRRRRRR/#)rrrstd_pathzIterable[str] | Nonerr;r)rs"rrr)s'&V&V&V/C&Vt&Vrca\P!R\^R7VPR4^,p\ V.4oSf\ P!T4'*#\S4o\F&pSP\T44'gK%R# Tf\p\;QJdT3RlT4F 'gK R# R#!T3RlT44# \ dR#i;i)a\Try to guess if a module is a standard python module (by default, see `std_path` parameter's description). :param modname: name of the module we are interested in :param std_path: list of path considered has standard :return: true if the module: - is located on the path listed in one of the directory in `std_path` - is a built-in module zWis_standard_module() is deprecated. Use, is_stdlib_module() or module_in_path() instead) stacklevelrlFc3X<"TFpSP\V44xK! R#5irPr)rrr9s& rr%is_standard_module..Os%UHDx""#8#>??HrT)warningswarnDeprecationWarningrrrr ryr7 EXT_LIB_DIRSrrT STD_LIB_DIRSr)rrrr9s&& @ris_standard_moduler)s MMa mmC #G$gY/$$W---x(H   4T: ; ; 3UHU33U3U3UHU UU! s C"" C10C1c$V^8dQhRRRRRR/#)rrr from_filerr;r)rs"rrrRs!rc P\PPV4'g \PPV4pV\P9dR#\ \ PPPVPR^R7^,V.44#)aReturn true if the given module name is relative to the given file name. :param modname: name of the module we are interested in :param from_file: path of the module from which modname has been imported :return: true if the module has been imported relatively to `from_file` Frl)maxsplit) r"risdirrr r;r] machinery PathFinder find_specr)rrs&&r is_relativerRsx 77== # #GGOOI. CHH &&00 MM#M *1 - {  ri)maxsizec V^8dQhRRRR/#)rrzstr | os.PathLike[str]rr;r)rs"rrrjs  6 4 rc@\PPV4#)zBA cached version of os.path.isfile that helps avoid repetitive I/O)r"risfiler6s&rcached_os_path_isfiler is 77>>$ rc(V^8dQhRRRRRRRR/#) rrrrGrrrrrrr)rs"rrrrs0&& & && &rcV'gQhRpVe&\P!W.4pVPpM\P!W4pVP\P P 8XdRVPfQh\VP4pVPV\P PR7#VP\P P8XdVPRR7#VP\P P8XdQVPfQh\VP4pVPV\P PR7#V# \d'\P!Y4pTPpEL`i;i \dTPTR7u#i;i)zGiven a mod path (i.e. split module / package name), return the corresponding spec. this function is used internally, see `file_from_modpath`'s documentation for more information N)rr)r)r rrrrr PY_COMPILEDr_replacerr+ C_BUILTIN PKG_DIRECTORYrx)rrrrr found_specs&&& rrrrs N7H +;J!**H ^^G2 $//555 :&&2 22&z':':;H&&!(A(A'  DOO55 5""D"11 DOO99 9""...Z001""H4??;T;T"UU + +6J!**H + :&&&9 9 :s$#E<6AF0<-F-,F-0GGc V^8dQhRRRR/#)rr9rrr;r)rs"rrrsEEcEdErc$VPR4#)zdReturn true if the given filename should be considered as a python file. .pyc and .pyo are ignored )r=z.pyiz.soz.pydz.pyw)rrs&rrrs   C DDrc V^8dQhRRRR/#)rrrrrr)rs"rrrsrc\PPVR4p.\ORNRNFHp\PP VR,V,4'gK8VR,V,u# R#)zUIf the given directory has a valid __init__ file, return its path, else return None. __init__pycpyorlN)r"rr#rr)r mod_or_packrs& rrxrxsc '',,y*5K.... 77>>++c1 2 2$s* */ rc V^8dQhRRRR/#rspecobjrrr;r)rs"rrrs88/8d8rcPVP\PP8H#rP)rr r PY_NAMESPACErs&rryrys <<4??77 77rc V^8dQhRRRR/#rr)rs"rrrs99/9d9rcPVP\PP8H#rP)rr rrrs&r is_directoryr!s <<4??88 88rc$V^8dQhRRRRRR/#)r module_namerpackage_whitelistzset[str]rr;r)rs"rrrs$   )1   rc aaVPR4o\;QJd:VV3Rl\^\S4^,44F 'gK R# R#!VV3Rl\^\S4^,444#)z Returns True if one part of the module name is in the package whitelist. >>> is_module_name_part_of_extension_package_whitelist('numpy.core.umath', {'numpy'}) True rlc3R<"TFpRPSRV4S9xK R#5i)rlN)r#)rxr$rjs& rrEis_module_name_part_of_extension_package_whitelist..s*:RQr00:Rs$'TF)rrrr)r#r$rjs&f@r2is_module_name_part_of_extension_package_whitelistr)sp   c "E 3:?3u:PQ>:R3333:?3u:PQ>:R r)pypywpyi)r,r+r*)dllpyd)r*r,)r,r*)sol)NNrPr)FF)X__conditional_annotations__r0 __future__rr]importlib.machineryimportlib.utilr[rloggingr"r sysconfigtypesrcollections.abcrrr contextlibrr functoolsrr astroid.constr astroid.interpreter._importr r getLoggerr,r`platformrrrPY_COMPILED_EXTSget_pathrraddrr#r real_prefixAttributeErrorbase_exec_prefix__annotations__r%rrdictfromkeysbuiltin_module_namesr Exceptionr+r7rBrMrQrTrhrmrsr|rrrrqrrrrrrrrrrr rrrxryr!r))r0s@rrIs #   887##2   8 $<<5!!)N!5%"N!. ""8,i.@.@.NO 77d?RWW\\#**f56  coov>?77g oo%7['( {{U W-.""9-y/A/A)/LM -- 8 8$?9 4:C ' ! !(#L 2 -  B8S*H06f:z F!6?8 T<&VR. 4  &RE 489 q     RWW\\#*>*>G H     s<5K L3 L0(5L  L,'L0+L,,L03M  M