e@\  UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZmZmZddlmZmZddlmZddlmZddlmZmZmZdd lmZmZerdd l m Z ndd l!m Z ejDe#Z$e jJjMd rd Z'd Z(ndZ'dZ(e jRde jRdhZ*e jVdk(rke*jYe jZj]e j^d e*jYe jZj]e j`dere jfdkre*jYe4ee jRdjjdz e*jYe4ee jRdjjdz e*jYe4ee jRdjjdz e*jYe4ee jRdjjdz e jVdk(rS e j`Z/de6d<d?dZ7e*jYe7de jpdkDre*jYe7de jRde jRdhZ9e:jwe jxd Z=Gd!d"e>Z?d?d#Z@efd@d$ZA dAd%ZBed?d&ZCd?d'ZDdBd(ZEdCd)ZFdDd*ZGdEd+ZHdFd,ZI dG dHd-ZJdIdJd.ZK dG dKd/ZL dG dLd0ZMdIdMd1ZN dN dOd2ZOdNdPd3ZPdQd4ZQdRd5ZRdSd6ZSdIdTd7ZTdUd8ZU dG dVd9ZVdWd:ZWdXd;ZXdYd<ZYdYd=ZZ dZd>Z[y#e1$rF e*jYe jZj]e jddn #e1$rYnwxYwYwxYw#e1$re j^Z/YwxYw)[aVPython 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)Path) IS_JYTHONIS_PYPY PY310_PLUS)specutil)stdlib_module_nameswin)pypywpyi)dllpyd)rr)sostdlib platstdlibntdlls)lib_pypyz lib-python/3posixstrprefixcxdtjddz}tjj t ||S)Nz python%d.%d)sys version_infoospathjoinr!)r' base_pythons 2/usr/lib/python3/dist-packages/astroid/modutils.py _posix_pathr+cs0#c&6&6r&:: ww||FD+66libllib64purelibplatlibTceZdZdZy) NoSourceFilezbException raised when we are not able to get a python source file for a precompiled file. N)__name__ __module__ __qualname____doc__r,r*r2r2vsr,r2cztjjtjj|S)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&r'normcaserealpathr's r*_normalize_pathr<|s( 77  BGG,,T2 33r,cF|s|S|jd\}}}|r|dzS|S)Nz $py.class.py) partition)filename is_jythonhead has_pyclass_s r*_path_from_filenamerEs3 #--k:D+qe| Or,cj|D].}||vr|j|||vs|j|0y)zaRemove files/directories in the black list. dirnames/filenames are usually from os.walk N)remove) blacklistdirnames filenamesnorecurss r*_handle_blacklistrLs=' x  OOH %  "   X & 'r,ct|SN)r<r;s r*_cache_normalize_path_rOs 4  r,c2|s t|St|S)zNormalize path with caching.)r<rOr;s r*_cache_normalize_pathrQs t$$ !$ ''r,c tj|S#t$rYnwxYwtt j 5}t t j 5}tj|}dddn #1swYnxYwdddn #1swYnxYwj}|rtjd||j}|rtjd||S)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) dotted_namestderrstdoutmodule stderr_value stdout_values r*load_module_from_namercs {{;''     '66? 46 ((5666666 ??$L 5{L ??$L 5{L  Ms0 !!BA>5 B>B BBc6tdj|S)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 .)rcr()partss r*load_module_from_modpathrgs !% 11r,c.t|}t|S)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_filerg)filepathmodpaths r*load_module_from_filerls )G #G ,,r,cg}|D]g}|j|tjj||}t |r@t j dj|}|rgyy)z3Check there are some __init__.py all along the way.reFT)appendr&r'r( _has_initr is_namespace)r'mod_pathrkpart old_namespaces r*check_modpath_has_initrtsaGtww||D$' --chhw.?@M   r,cPd}tjj|}tjj|}tjj|j |r|}tjj |}tjj|j |r|}|r`tjj |d}|t|d}|jtjDcgc]}|s| c}Sycc}w)a>Extracts 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 Nr) r&r'r9abspath startswithr:splitextlensplitsep)r@ path_to_checkimportable_path abs_filename real_filename base_pathrelative_base_pathpkgs r*_get_relative_base_pathrs OGG$$]3M77??8,L ww %00?&GG$$X.M ww &11-@'GG$$_5a8 &s='9';<177?G3GG Hs D#D#ctjjt|}tjj }|r||z }t j|tt|D](}|st||}|s|J|||dds&|cStdj|djtj)Nz"Unable to find module for {} in {}z, )r&r' expanduserrEr$copy itertoolschainmaprQr ImportErrorformatr()r@r' is_package_cbpaths_to_checkpathnamerks r*modpath_from_file_with_callbackrs ww!!"5h"?@HXX]]_N $OO1>B  )(H= ((( 73B< 0N  ,33Hfkk#((>ST r,c$t||tS)a*Get 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 path where the module or package should be searched (use sys.path if nothing or None is given) :raise ImportError: if the corresponding module's name has not been found :rtype: list(str) :return: the corresponding split module's name )rrt)r@r's r*riri7s$ +8T;Q RRr,c0t|||jSrN)file_info_from_modpathlocation)rkr' context_files r*file_from_modpathrLs "'4 > G GGr,ct| tjj|}n|}|ddk(r tdg|ddz||S|ddgk(rHt j dtjjt jj St|||S#t$rt|||cYSwxYw) axGiven 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' Nrxml_xmlplusr&r'os.path)namertype) r&r'dirname_spec_from_modpathrr ModuleSpec__file__ ModuleType PY_SOURCE)rkr'rcontexts r*rrTs> ggool;qzU >%zlWQR[&@$P P T6N "WW%%**  gtW 55 >%gtW= = >sBB76B7c h|jdry|jd}|)|dtvrt|dkDr t ||dSd}d}|ddk(r |Jdg}d}|t|krL||dk(rD|dz }|Jdt j j|}|t|kr ||dk(rDt|t|D]} t|||dz|| |S#t$r5|tdt|dz krdj|d|cYcSwxYw) aGiven 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) rreNrr#z.explicit relative import, but no context_file?r)r'r) rwrzBUILTIN_MODULESryrr&r'rrangermaxr()r]rrfr'startiis r*get_module_partrsq.i(   c "E 8 &5zA~!+..8O!D F Qx2~  $ < ; < $ 3u: %-2"5!   $ < ; < $ww|4 3u: %-2"5 63u: &' ' fq1u%D| '   '3q#e*q.))88E"1I& & 'sC339D10D1c(g}tj|D]w\}}}||vr t||||sddhj|rd|dd4|D]?}t |stj j ||}|j|Ay|S)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__.pyir7N)r&walkrL isdisjoint_is_python_filer'r(rn) src_directoryrHlist_allfiles directoryrIrJr@srcs r*get_module_filesrs&E*,''-*@ "& 8Y  ! )Xy9]N;FFyQHQK ! "Hx(ggll9h7 S! " " Lr,ctjjt|}tjj |\}}|dk(r)tjj ||r||St D],}|d|}tjj |s*|cS|r#|s!tjj |r|St|)aoGiven 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 .pyire)r&r'rvrErxexistsPY_SOURCE_EXTSr2)r@include_no_extbaseorig_extext source_paths r*get_source_filersww28<=HWW%%h/ND(6bggnnvhZ-@Az""auo 77>>+ & h277>>$+? x  r,c^|sytjj|dddtvS)z5Return: True if the filename is a python source file.FrN)r&r'rxrr@s r*is_python_sourcers.  77  H %a ( , >>r,c6|jddtvS)z6Return: True if the modname is in the standard libraryrer)rzr)modnames r*is_stdlib_modulers == a $7 77r,c|jdd} t|gytt |t rj t|Stfd|DS#t$rYywxYw)a Try 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` rerFc3RK|]}jt| ywrNrwrQ).0entryr@s r* z!module_in_path..&s"SUx""#8#?@S$') rzrrr< isinstancer rwrQany)rr'r@s @r*module_in_pathr smmC #G$gY/ x(H$""#8#>?? SdS SS s A// A;:A;chtjdtd|jdd} t |gt j| SttD]}jt|sy|t}tfd|DS#t $rYywxYw)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() insteadr#) stacklevelrerFc3RK|]}jt| ywrNr)rr'r@s r*rz%is_standard_module..Os"UDx""#8#>?Ur)warningswarnDeprecationWarningrzrrrrpr< EXT_LIB_DIRSrwrQ STD_LIB_DIRSr)rstd_pathr'r@s @r*is_standard_moduler)s MMa mmC #G$gY/$$W---x(H   4T: ; UHU UU! s B%% B10B1c4tjj|stjj|}|tjvryt t jjj|jddd|gS)a6Return 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` Frer)maxsplitr) r&r'isdirrr$boolrW machinery PathFinder find_specrz)r from_files r* is_relativerRsu 77== #GGOOI. CHH &&00 MM#M *1 - {  r,cz|sJd}|% tj||g}|j}ntj||}|jtj j k(rO |jJt|j}|j|tj jS|jtj jk(r|jdS|jtj jk(rN|jJt|j}|j|tj jS|S#t$r&tj||}|j}YTwxYw#t$r|j|cYSwxYw)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)rrrrrr PY_COMPILEDr_replacerr2 C_BUILTIN PKG_DIRECTORYro)rkr'rr found_specs r*rrls N7H +';J!**H ^^GT2 $//555 :&&2 22&z':':;H&&!(A(A'  DOO55 5""D"11 DOO99 9""...Z001""H4??;T;T"UU + +6J!**H + :&&&9 9 :s$#E*,A F*+FFF:9F:c$|jdS)zlReturn true if the given filename should be considered as a python file. .pyc and .pyo are ignored )r>rz.soz.pydz.pyw)endswithrs r*rrs   C DDr,ctjj|d}gtddD]1}tjj |dz|zs)|dz|zcSy)z]If the given directory has a valid __init__ file, return its path, else return None. __init__pycpyoreN)r&r'r(rr)r mod_or_packrs r*rorose'',,y*5K....+ 77>>++c1 2$s* *+ r,cP|jtjjk(SrN)rrr PY_NAMESPACEspecobjs r*rprps <<4??77 77r,cP|jtjjk(SrN)rrrrrs r* is_directoryrs <<4??88 88r,c ~|jdtfdtdtdzDS)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 rec3JK|]}djd|vyw)reN)r()rxpackage_whitelistrfs r*rzEis_module_name_part_of_extension_package_whitelist..s+56r00s #r)rzrrry) module_namerrfs `@r*2is_module_name_part_of_extension_package_whitelistrs?   c "E :?3u:PQ>:R r,)r'r returnr )r@r rArrr )rH Sequence[str]rI list[str]rJrrNone)r]r rtypes.ModuleType)rfrrr)rjr rr)r'r rqrrr)r@r r|r rzlist[str] | None)NN)r@r r'Sequence[str] | Nonerz'Callable[[str, list[str]], bool] | NonerrrN)r@r r'rrr)rkrr'rr str | Nonerr)rkrr'rrrrspec.ModuleSpec)r]r rrrr )F)rr rHrrrrr)r@r rrrr )r@rrr)rr rr)rr r'zstr | Iterable[str]rr)rr rzIterable[str] | Nonerr)rr rr rr)rkrr'rrrrr)r@r rr)rr rr)rrrr)rr rzset[str]rr)\r6 __future__rrWimportlib.machineryimportlib.utilrUrloggingr&r$ sysconfigtypesrcollections.abcrrr contextlibrr functoolsr pathlibr astroid.constr r r astroid.interpreter._importrrrastroid._backport_stdlib_names getLoggerr3rZplatformrwrPY_COMPILED_EXTSget_pathrraddr'r(r! real_prefixAttributeErrorbase_exec_prefixr%r parent__annotations__r+maxsizerdictfromkeysbuiltin_module_namesr Exceptionr2r<rErLrOrQrcrgrlrtrrrirrrrrrrrrrrrrorprrr7r,r*r!s #   887882 'B   8 $<<5!)N%"N # ""8,.@i.@.@.NO 77d?RWW\\#**f56  coov>? s&(S0i00:;BBZOPQS0i00:;BB^STUS0i00>?FFSTU D###L1 2 9 9N JK77g oo%7['( {{U W-." ""9-/Ay/A/A)/LM -- 8 8$?9 4:C ' '(1 '>G '  ' ! !("J 2 - H"&=A ; 4S."&#H H HH H"&#06 06 0606 06f:|DI  #0 <@  F!0?8 T<&VR8"&& & && &RE89  )1   ]     RWW\\#*>*>G H    < sH5N*O8*O505O&%O5&O.+O5-O..O54O58P  P