7gYNUdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlmZmZmZddlmZmZddlmZddlmZmZddlmZmZerdd l mZndd lmZej>e Z!e jDjGd rd Z$d Z%d Z&ndZ$dZ%dZ&e jNde jNdhZ(e jRdk(rke(jUe jVjYe jZd e(jUe jVjYe j\de jRdk(rS e j\Z-de1d<d?dZ2e(jUe2de jfdkDre(jUe2de jNde jNdhZ4e5jme jndZ8Gdd e9Z:d?d!Z;efd@d"Z< dAd#Z=ed?d$Z>d?d%Z?dBd&Z@dCd'ZAdDd(ZBdEd)ZCdFd*ZD dG dHd+ZEdIdJd,ZF dG dKd-ZG dG dLd.ZHdIdMd/ZI dN dOd0ZJ dP dQd1ZKdRd2ZLdSd3ZMdTd4ZNdIdUd5ZOdVd6ZP dG dWd7ZQdXd8ZRed9:dYd;ZSdZd<ZTdZd=ZU d[d>ZVy#e/$rF e(jUe jVjYe j`dn #e/$rYnwxYwYwxYw#e/$re jZZ-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) IS_JYTHON PY310_PLUS)specutil)stdlib_module_nameswin)pypywpyi)rrr)dllpyd)rr)rr)sostdlib platstdlibntdllsposixstrprefixcxdtjddz}tjj t ||S)Nz python%d.%d)sys version_infoospathjoinr)r" base_pythons 0lib/python3.12/site-packages/astroid/modutils.py _posix_pathr&Vs0#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%r-r-isr'r-cztjjtjj|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_pathr7os( 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_filenamer@zs3 #--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_blacklistrGs8 x  OOH %  "   X & r'ct|SN)r7r6s r%_cache_normalize_path_rJs 4  r'c2|s t|St|S)zNormalize path with caching.)r7rJr6s r%_cache_normalize_pathrLs 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) rmodulesKeyErrorrioStringIOr importlib import_modulegetvalueloggererrorinfo) dotted_namestderrstdoutmodule stderr_value stdout_values r%load_module_from_namer^s {{;''     && &&((5 '&& '&& ??$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 .)r^r#)partss r%load_module_from_modpathrbs !% 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_filerb)filepathmodpaths r%load_module_from_filergs )G #G ,,r'cg}|D]g}|j|tjj||}t |r@t j dj|}|rgyy)z3Check there are some __init__.py all along the way.r`FT)appendr!r"r# _has_initr is_namespace)r"mod_pathrfpart old_namespaces r%check_modpath_has_initros\Gtww||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"r4abspath startswithr5splitextlensplitsep)r; path_to_checkimportable_path abs_filename real_filename base_pathrelative_base_pathpkgs r%_get_relative_base_pathr~s OGG$$]3M77??8,L ww %00?&GG$$X.M ww &11-@'GG$$_5a8 &s='9';<177?G?3?GG 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" expanduserr@rcopy itertoolschainmaprLr~ ImportErrorformatr#)r;r" is_package_cbpaths_to_checkpathnamerfs 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 )rro)r;r"s r%rdrd+s$ +8T;Q RRr'c0t|||jSrI)file_info_from_modpathlocation)rfr" context_files r%file_from_modpathr@s "'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)rfr"rcontexts r%rrHs> 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) rr`Nrrz.explicit relative import, but no context_file?r)r"r) rrruBUILTIN_MODULESrtrr!r"rrangermaxr#)rXrrar"startiis r%get_module_partr{sl.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__.pyir2N)r!walkrG isdisjoint_is_python_filer"r#ri) src_directoryrClist_allfiles directoryrDrEr;srcs r%get_module_filesrs&E*,''-*@& 8Y  ! )Xy9]N;FFyQHQK !Hx(ggll9h7 S!"+A Lr'ctjjt|}tjj |\}}|dk(r)tjj ||r||S|rt ntD],}|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 .pyir`) r!r"rqr@rsexistsPY_SOURCE_EXTS_STUBS_FIRSTPY_SOURCE_EXTSr-)r;include_no_ext prefer_stubsbaseorig_extext source_paths r%get_source_filersww28<=HWW%%h/ND(6bggnnvhZ-@Az""-9)~Mauo 77>>+ & Nh277>>$+? x  r'c^|sytjj|dddtvS)z5Return: True if the filename is a python source file.FrN)r!r"rsrr;s r%is_python_sourcers.  77  H %a ( , >>r'c6|jddtvS)z6Return: True if the modname is in the standard libraryr`r)rur)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` r`rFc3RK|]}jt| ywrIrrrL).0entryr;s r% z!module_in_path..s#SdUx""#8#?@d$') rurrr7 isinstancerrrrLany)rr"r;s @r%module_in_pathrsmmC #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) stacklevelr`rFc3RK|]}jt| ywrIr)rr"r;s r%rz%is_standard_module..Es#UHDx""#8#>?Hr)warningswarnDeprecationWarningrurrr rkr7 EXT_LIB_DIRSrrrL STD_LIB_DIRSr)rstd_pathr"r;s @r%is_standard_modulers 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` Fr`r)maxsplitr) r!r"isdirrrboolrR machinery PathFinder find_specru)r from_files r% is_relativerHsu 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)r rrrrr PY_COMPILEDr_replacerr- C_BUILTIN PKG_DIRECTORYrj)rfr"rr found_specs r%rrbs 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 )r9rz.soz.pydz.pyw)endswithrs r%rrs   C DDr'i)maxsizectjj|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__pycpyor`N)r!r"r#rr)r mod_or_packrs r%rjrjs` '',,y*5K.... 77>>++c1 2$s* */ r'cP|jtjjk(SrI)rr r PY_NAMESPACEspecobjs r%rkrks <<4??77 77r'cP|jtjjk(SrI)rr rrrs 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 r`c3JK|]}djd|vyw)r`N)r#)rxpackage_whitelistras r%rzEis_module_name_part_of_extension_package_whitelist..s+:RQr00:Rs #r)rurrrt) module_namerras `@r%2is_module_name_part_of_extension_package_whitelistrs?   c "E :?3u:PQ>:R r')r"rreturnr)r;rr<rrr)rC Sequence[str]rD list[str]rErrNone)rXrrtypes.ModuleType)rarrr)rerrr)r"rrlrrr)r;rrwrrzlist[str] | None)NN)r;rr"Sequence[str] | Nonerz'Callable[[str, list[str]], bool] | NonerrrI)r;rr"rrr)rfrr"rr str | Nonerr)rfrr"rrrrspec.ModuleSpec)rXrrrrr)F)rrrCrrrrr)FF)r;rrrrrrr)r;rrr)rrrr)rrr"zstr | Iterable[str]rr)rrrzIterable[str] | Nonerr)rrrrrr)rfrr"rrrrr)r;rrr)rrrr)rrrr)rrrzset[str]rr)Wr1 __future__rrRimportlib.machineryimportlib.utilrPrloggingr!r sysconfigtypesrcollections.abcrrr contextlibrr functoolsr astroid.constr r astroid.interpreter._importr r rastroid._backport_stdlib_names getLoggerr.rUplatformrrrrPY_COMPILED_EXTSget_pathrraddr"r#r real_prefixAttributeErrorbase_exec_prefix__annotations__r&rrdictfromkeysbuiltin_module_namesr Exceptionr-r7r@rGrJrLr^rbrgror~rrdrrrrrrrrrrrrrjrkrrr2r'r%rs #   887/2 'B   8 $<<5!)N!5%"N!. # ""8,.@i.@.@.NO 77d?RWW\\#**f56  coov>?77g oo%7['( {{U W-." ""9-/Ay/A/A)/LM -- 8 8$?9 4:C ' '(1 '>G '  ' ! !(#L 2 - H"&=A ; 4S."&#H H HH H"&#06 06 0606 06f:|DI  #0 <@  HGL!!#'!?C!!4?8 T<&VR8"&& & && &RE 489  )1   I     RWW\\#*>*>G H     sH5KLL 5K=<L =LL LL  L L$#L$