cBV ~UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl mZmZmZddlmZmZddlmZddlmZddlmZmZdd lmZmZejeZ e j!"d rd Z#d Z$nd Z#dZ$e j%de j%dhZ&e j'dkre&(e j)*e j+d e&(e j)*e j,dnK#e-$rC e&(e j)*e j.dn #e-$rYnwxYwYnwxYwere j/dkre&(e0ee j%dj1dz e&(e0ee j%dj1dz e&(e0ee j%dj1dz e&(e0ee j%dj1dz e j'dkrk e j,Z+de2d<n#e-$r e j+Z+YnwxYwdcdZ3e&(e3de j4dkre&(e3de j%de j%d hZ5e67e j8d!Z9Gd"d#e:Z;dcd$Zedcd0Z?dcd1Z@dfd4ZAdgd6ZBdhd8ZCdid:ZDdjd=ZE dkdldAZFdmdndBZG dkdodFZH dkdpdHZIdmdqdIZJ drdsdMZKdrdtdOZLdudPZMdmdvdTZNdwdVZO dkdxdXZPdydYZQdzd[ZRd{d]ZSd{d^ZTd|dbZUdS)}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)specutilwin)pypyw)dllpyd)r)sostdlib platstdlibntdlls)lib_pypyz lib-python/3posixstrprefixpathreturnc|dtjddz}tjt ||S)Nz python%d.%d)sys version_infoosrjoinr)r base_pythons 0lib/python3.11/site-packages/astroid/modutils.py _posix_pathr)]s0#c&6rr&:: w||FD+666libllib64purelibplatlibTceZdZdZdS) NoSourceFilezbException raised when we are not able to get a python source file for a precompiled file. N)__name__ __module__ __qualname____doc__r*r(r0r0psr*r0cztjtj|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%rnormcaserealpathrs r(_normalize_pathr:vs* 7  BG,,T22 3 33r*filename is_jythonboolcN|s|S|d\}}}|r|dzS|S)Nz $py.class.py) partition)r;r<head has_pyclass_s r(_path_from_filenamerDs@ #--k::D+qe| Or* blacklist Sequence[str]dirnames list[str] filenamesNonecv|D]5}||vr||||vr||6dS)zaRemove files/directories in the black list. dirnames/filenames are usually from os.walk N)remove)rErGrInorecurss r(_handle_blacklistrNsa'' x  ' OOH % % % %  " '   X & & & ''r*c t|SN)r:r9s r(_cache_normalize_path_rQs 4  r*cB|st|St|S)zNormalize path with caching.)r:rQr9s r(_cache_normalize_pathrSs( %t$$$ !$ ' ''r* dotted_nametypes.ModuleTypec tj|S#t$rYnwxYwtt j5}t t j5}tj|}dddn #1swxYwYdddn #1swxYwY| }|rt d||| }|rt d|||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)rTstderrstdoutmodule stderr_value stdout_values r(load_module_from_namerfs {;''       ' '66? 446 (55666666666666666666666666666666 ??$$L  5{L   ??$$L  5{L    MsB !!!B%B: BB B B BB!$B!partscFtd|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 .)rfr&)rgs r(load_module_from_modpathrjs !% 1 11r*filepathc>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_filerj)rkmodpaths r(load_module_from_fileros ))G #G , ,,r*mod_pathcg}|D]r}||tj||}t |s,t jd|}|sdSsdS)z3Check there are some __init__.py all along the way.riFT)appendr%rr& _has_initr is_namespace)rrprnpart old_namespaces r(check_modpath_has_initrws|Gtw||D$''  -chhw.?.?@@M  uu 4r* path_to_checklist[str] | Nonecbd}tj|}tj|}tj||r|}tj|}tj||r|}|retj|d}|t|d}d|tj DSdS)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 Nrcg|]}||Sr5r5).0pkgs r( z+_get_relative_base_path..sGGG3GGGGr*) r%rr7abspath startswithr8splitextlensplitsep)r;rximportable_path abs_filename real_filename base_pathrelative_base_paths r(_get_relative_base_pathrs OG$$]33M7??8,,L w %%00??'&G$$X..M w &&11-@@(' HG$$_55a8 &s='9'9';';<GG177??GGGG 4r*Sequence[str] | None is_package_cb'Callable[[str, list[str]], bool] | Nonectjt|}tj}|r||z }t j|tt|D]4}|st||}|s|J|||ddr|cS5td |d tj)Nz"Unable to find module for {} in {}z, )r%r expanduserrDr#copy itertoolschainmaprSr ImportErrorformatr&)r;rrpaths_to_checkpathnamerns r(modpath_from_file_with_callbackrs w!!"5h"?"?@@HX]]__N $O1>BB    )(H==  ((( =73B3< 0 0 NNN  ,33Hfkk#(>S>STT  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 )rrw)r;rs r(rmrm4s$ +8T;Q R RRr*rn context_file str | Nonec.t|||jSrP)file_info_from_modpathlocation)rnrrs r(file_from_modpathrIs "'4 > > GGr*spec.ModuleSpecc|| tj|}n|}|ddkr? tdg|ddz||S#t$rt|||cYSwxYw|ddgkr5t jdtjjt jj St|||S) 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%ros.path)namertype) r%rdirname_spec_from_modpathrr ModuleSpec__file__ ModuleType PY_SOURCE)rnrrcontexts r(rrQs> gool;;qzU   >%zlWQRR[&@$PP P > > >%gtW== = = = > T6N " W%*    gtW 5 55sAA-,A-c |drdS|d}|9|dtvr*t|dkrt ||dSd}d}|ddkr| Jdg}d}||dkr<|dz }| Jdt j|}||dk>> 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) rriNrr"z.explicit relative import, but no context_file?r)rr) rrBUILTIN_MODULESrrr%rrrangermaxr&)rTrrgrstartiis r(get_module_partrs.i((y   c " "E 8 & 5zzA~ /!+...8O!D F Qx2~  < < ; < < < -2 5!   < < ; < < <w|44 -2 5 63u:: & &'' ' fq1un%D|      ' ' '3q#e**q.))) 88E"1"I&& & & & & & ' s0DA EEF src_directorylist_allcg}tj|D]s\}}}||vr t||||s d|vrd|dd<*|D]F}t|r5tj||}||Gt|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__.pyr5N)r%walkrN_is_python_filerr&rr) rrErfiles directoryrGrIr;srcs r(get_module_filesrs&E*,'-*@*@ " "& 8Y  !  )Xy999 M: HQQQK ! " "Hx(( "gll9h77 S!!! " Lr*include_no_extcntjt|}tj|\}}t D],}|d|}tj|r|cS-|r#|s!tj|r|St|)asGiven 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 ri)r%rrrDrPY_SOURCE_EXTSexistsr0)r;rbaseorig_extext source_paths r(get_source_filersw28<<==HW%%h//ND(oooo 7>>+ & &     h27>>$+?+? x  r*cr|sdStj|dddtvS)z5Return: True if the filename is a python source file.FrN)r%rrrr;s r(is_python_sourcers8 u 7  H % %a ( , >>r*modnamestd_pathIterable[str] | Nonecr|dd} t|gn#t$rYdSwxYwtj| St t D]'}t|rdS(|t}tfd|DS)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 rirFNc3\K|]&}t|V'dSrP)rrS)r|rr;s r( z%is_standard_module..!s:UUDx""#8#>#>??UUUUUUr*) rrrrrtr: EXT_LIB_DIRSrrS STD_LIB_DIRSany)rrrr;s @r(is_standard_modulersmmC  #G$gY// uu .$W----x((H   4T:: ; ; 55   UUUUHUUU U UUs / == from_filec:tj|stj|}|tjvrdSt t jj | ddd|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` Frir)maxsplitr) r%risdirrr#r=r[ machinery PathFinder find_specr)rrs r( is_relativer$s 7== # #/GOOI.. CHu &00 MM#M * *1 - {    r*rc|sJd}|K tj||g}|j}nA#t$rtj||}|j}YnwxYwtj||}|jtjjkrj |jJt|j}||tjj S#t$r||cYSwxYw|jtjj kr|dS|jtjj krC|jJt|j}||tjj S|S)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_replacerr0 C_BUILTIN PKG_DIRECTORYrs)rnrrr found_specs r(rr>s NNNH3 +';;J!*HH + + +66J!*HHH +^GT22 $/55V :& 2 2 2&z':;;H&&!(A'  : : :&&&99 9 9 9 : DO5 5V""D"111 DO9 9V"...Z011""H4?;T"UUU s"(&AAAC C*)C*c,|dS)zlReturn true if the given filename should be considered as a python file. .pyc and .pyo are ignored )r?z.soz.pydz.pyw)endswithrs r(rrgs   ; < <>++c1 2 2 +$s* * * * + 4r*specobjc6|jtjjkSrP)rr r PY_NAMESPACErs r(rtrtzs <4?7 77r*c6|jtjjkSrP)rr rrrs r( is_directoryr~s <4?8 88r* module_namepackage_whitelistset[str]c |dtfdtdtdzDS)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 ric3VK|]#}dd|vV$dS)riN)r&)r|xrrgs r(rzEis_module_name_part_of_extension_package_whitelist..sN56rr00r*r)rrrr)rrrgs `@r(2is_module_name_part_of_extension_package_whitelistrsk   c " "E :?3u::PQ>:R:R  r*)rrr r)r;rr<r=r r)rErFrGrHrIrHr rJ)rTrr rU)rgrFr rU)rkrr rU)rrrprHr r=)r;rrxrr ry)NN)r;rrrrrr rHrP)r;rrrr rH)rnrHrrrrr r)rnrHrrrrr r)rTrrrr r)F)rrrErFrr=r rH)r;rrr=r r)r;rr r=)rrrrr r=)rrrrr r=)rnrHrrrrr r)r;rr r=)rrr r)rrr r=)rrrrr r=)Vr4 __future__rr[importlib.machineryimportlib.utilrYrloggingr%r# sysconfigtypescollections.abcrrr contextlibrr functoolsr pathlibr astroid.constr r astroid.interpreter._importr r getLoggerr1r^platformrrPY_COMPILED_EXTSget_pathrraddrr&r real_prefixAttributeErrorbase_exec_prefixr$rparent__annotations__r)maxsizerdictfromkeysbuiltin_module_namesr Exceptionr0r:rDrNrQrSrfrjrorwrrrmrrrrrrrrrrrsrtrrr5r*r(rs&   #"""""   888888888877777777,,,,,,,,22222222  8 $ $<5!!"N%N # "8,,.@i.@.N.NO 7d?RW\\#*f55666  cov>>????     RW\\#*>GG H H H H    D   s&( SS0i0::;;BZOPPQQQSS0i0::;;B^STTUUUSS0i0>>??FSTTUUU DD##L11 2 2 9N JKK7g/ o%%%%% 7777[[''((( {U/ W--..." "9--/Ay/A)/L/LM -- 8$??9 4444:C ' ' ' ' !!! !((((""""J 2 2 2 2 - - - -    """"N"&=A4SSSSS."&#HHHHH"&#0606060606f99999zDI     F!!!!!.???? V V V V VF8"&&&&&&R====88889999      sH23D&&E.,3E E. E(%E.'E((E.-E.> J JJ