| Z?dgd%Z@efdhd)ZAdid0ZB e dgd1 ZCdgd2ZDdjd5ZEdkd7ZFdld9ZGdmd;ZHdnd>ZI dodpdBZJdqdrdCZK dodsdGZL dodtdIZMdqdudJZN dvdwdNZOdvdxdPZPdydQZQdzdSZRd{dUZSdqd|dXZTd}dZZU dod~d\ZVdd]ZWdd_ZXddaZYddbZZddfZ[dS )aV Python 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)pypyw)dllpyd)r )sostdlib
platstdlibntdlls) lib_pypyz lib-python/3posixstrprefixpathreturnc | dt j d d z }t j t
| | S )Nz python%d.%d )sys version_infoosr! joinr )r! base_pythons b/builddir/build/BUILD/cloudlinux-venv-1.0.12/venv/lib/python3.11/site-packages/astroid/modutils.py _posix_pathr+ c s0 #c&6rr&:: w||FD+666 libl lib64purelibplatlibTc e Zd ZdZdS ) NoSourceFilezbException raised when we are not able to get a python
source file for a precompiled file.
N)__name__
__module__ __qualname____doc__ r, r* r2 r2 v s r, r2 c z t j t j | 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* 7 BG , ,T 2 2 3 33r, filename is_jythonboolc N |s| S | d \ }}}|r|dz S | S )Nz $py.class.py) partition)r= r> head has_pyclass_s r* _path_from_filenamerF s@ #--k::D+q e| Or, blacklist
Sequence[str]dirnames list[str] filenamesNonec v | D ]5}||v r| | ||v r| | 6dS )zaRemove files/directories in the black list.
dirnames/filenames are usually from os.walk
N)remove)rG rI rK norecurss r* _handle_blacklistrP s] ' ' x OOH % % % %
"
" X & & & ' 'r, c t | S N)r< r; s r* _cache_normalize_path_rS s 4 r, c B | st | S t | S )z Normalize path with caching.)r< rS r; s r* _cache_normalize_pathrU s(
% t$$$ !$ ' ''r, dotted_nametypes.ModuleTypec t j | S # t $ r Y nw xY wt t j 5 }t
t j 5 }t j | }ddd n # 1 swxY w Y ddd n # 1 swxY w Y | }|r t d| | | }|r t 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% modulesKeyErrorr ioStringIOr importlib
import_modulegetvalueloggererrorinfo)rV stderrstdoutmodule stderr_value stdout_values r* load_module_from_namerh s
{;''
' ' 66?
4 4 6 (556 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 6
??$$L
5{L
??$$L
5{L
MsB
!!!B %B: B B
B
B
B B!$B!partsc F t d | 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
.)rh r( )ri s r* load_module_from_modpathrl s !% 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_filerl )rm modpaths r* load_module_from_filerq s ))G #G , ,,r, mod_pathc g }|D ]r}| | t j | | } t | s,t j d | }|s dS sdS )z3Check there are some __init__.py all along the way.rk FT)appendr' r! r( _has_initr is_namespace)r! rr rp part
old_namespaces r* check_modpath_has_initry s| G t w||D$'' -chhw.?.? @ @M
uu 4r,
path_to_checklist[str] | Nonec b d}t j | }t j | }t j | | r|}t j | }t j | | r|}|ret j | d }|t | d }d | t j D S dS )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 c g | ]}||S r7 r7 ).0pkgs r*
z+_get_relative_base_path.. s GGG3GGGGr, )
r' r! r9 abspath
startswithr: splitextlensplitsep)r= rz importable_path abs_filename
real_filename base_pathrelative_base_paths r* _get_relative_base_pathr s OG$$]33M7??8,,L w %%00 ?? '&G$$X..M w
&&11-@@ ('
HG$$_55a8 &s='9'9';'; <GG 1 7 7 ? ?GGGG 4r, Sequence[str] | None
is_package_cb'Callable[[str, list[str]], bool] | Nonec t j t | } t j }|r||z
}t
j |t t | D ]4}|st | | }|s|J |||d d r|c S 5t d | d
t j )Nz"Unable to find module for {} in {}z,
)r' r!
expanduserrF r% copy itertoolschainmaprU r ImportErrorformatr( )r= r! r paths_to_checkpathnamerp s r* modpath_from_file_with_callbackr s
w!!"5h"?"?@@HX]]__N $ O 1>BB
)(H== ((( =73B3< 0 0 NNN ,33Hfkk#(>S>STT r, c . t | |t S )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
)r ry )r= r! s r* ro ro : s $ +8T;Q R RRr, rp context_file
str | Nonec . t | || j S rR )file_info_from_modpathlocation)rp r! r s r* file_from_modpathr O s
"'4 > > GGr, spec.ModuleSpecc | | t j | }n|}| d dk r? t dg| dd z || S # t $ r t | || cY S w xY w| ddgk r5t j dt j j t
j j S t | || S )
ax 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'
Nr xml_xmlplus r' r! os.path)namer type)
r' r! dirname_spec_from_modpathr r
ModuleSpec__file__
ModuleType PY_SOURCE)rp r! r contexts r* r r W s > gool ; ; qzU >%zlWQRR[&@$PP P > > >%gtW== = = = > T6N " "W% *
gtW 5 55s A A-,A-c | d rdS | d }|9|d t v r*t | dk rt | |d S d}d}|d dk r|
J d g }d}|t | k r[|| dk rO|dz
}|
J d t
j | }|t | k r || dk Ot |t | D ]t} t |||dz || !# t $ rG |t dt | dz
k r d |d| cY c S w xY w| S )
a Given 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)
r rk Nr r$ z.explicit relative import, but no context_file?r )r! r ) r r BUILTIN_MODULESr r r' r! r ranger maxr( )rV r ri r! startiis r* get_module_partr s . i(( y c " "E 8 & &5zzA~~!+...8O !D
F Qx2~~ $ $ ;
% $ $
3u::
%-2"5"5! $ $ ;
% $ $w|44 3u::
%-2"5"5 63u::
&
& ' ' ' fq1un%D|
' ' '3q#e**q.))))88E"1"I&& & & & & & ' s D44A FFF
src_directorylist_allc g }t j | D ]s\ }}}||v r t ||| |s d|vrd|dd< *|D ]F}t | r5t j || }| | Gt|S )a Given 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__.pyr7 N)r' walkrP _is_python_filer! r( rt ) r rG r files directoryrI rK r= srcs r* get_module_filesr s & E*,'-*@*@ " "& 8Y ! ! )Xy999 M : : HQQQK ! " "H x((
"gll9h77 S!!! " Lr, include_no_extc n t j t | } t j | \ }}t
D ],}| d| }t j | r|c S -|r#|s!t j | r|S t | )as Given 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
rk )r' r! r rF r PY_SOURCE_EXTSexistsr2 )r= r baseorig_extext source_paths r* get_source_filer s w 28 < <==HW%%h//ND( oooo
7>>+ & & h 27>>$+?+?
x
r, c r | sdS t j | d dd t v S )z5Return: True if the filename is a python source file.Fr N)r' r! r r r= s r* is_python_sourcer s8 u
7 H % %a ( , >>r, modnamec F | d d t v S )z6Return: True if the modname is in the standard libraryrk r )r r )r s r* is_stdlib_moduler s == a $7 77r, str | Iterable[str]c J | d d } t | g n# t $ r Y dS w xY wdS t t |t
r" t | S t fd|D S )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`
rk r FNc 3 \ K | ]&} t | V 'd S rR r rU )r~ entryr= s r* z!module_in_path..( s: SSUx""#8#?#?@@SSSSSSr, ) r r r r<
isinstancer r rU any)r r! r= s @r* module_in_pathr
s mmC #G$gY// uu u x((H$ @""#8#>#>??? SSSSdSSS S SSs /
==std_pathIterable[str] | Nonec t j dt d | d d } t | g n# t
$ r Y dS w xY wt
j | S t t D ]'}
t | r dS (|t }t fd|D S ) 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$ )
stacklevelrk r FNc 3 \ K | ]&} t | V 'd S rR r )r~ r! r= s r* r z%is_standard_module..Q s: UUDx""#8#>#>??UUUUUUr, )warningswarnDeprecationWarningr r r r rv r< EXT_LIB_DIRSr rU STD_LIB_DIRSr )r r r! r= s @r* is_standard_moduler + s
Ma mmC #G$gY// uu $W---- x((H 4T : : ; ; 55 UUUUHUUU U UUs A
AA from_filec : t j | s t j | }|t j v rdS t t j j |
dd d |g S )a6 Return 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`
Frk r )maxsplitr ) r' r! isdirr r% r? r] machinery
PathFinder find_specr )r r s r* is_relativer T s 7== # # /GOOI.. CH u &00 MM#M * *1 - {
r, r c | sJ d}|K t j | |g }|j }nA# t $ r t j | | }|j }Y nw xY wt j | | }|j t j j k rj |j J t |j }| |t j j S # t $ r | | cY S w xY w|j t j j k r| d S |j t j j k rC|j J t |j }| |t j j 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)r r )r )r r r r r r PY_COMPILEDr _replacer r2 C_BUILTIN
PKG_DIRECTORYru )rp r! r r
found_specs r* r r n s NN7H + ';;J!*HH + + + 66J!*HHH + ^GT22
$/555 : &222&z':;;H &&!(A '
: : : &&&99 9 9 9 : DO 5 5 5""D"111 DO 9 9 9"... Z 011""H4?;T"UUU s" ( &AAAC C*)C*c , | d S )zlReturn true if the given filename should be considered as a python file.
.pyc and .pyo are ignored
)rA z.soz.pydz.pyw)endswithr s r* r r s
; < <>++c1 2 2 + $s* * * * + 4r, specobjc 6 | j t j j k S rR )r r r PY_NAMESPACEr s r* rv rv s <4?7 77r, c 6 | j t j j k S rR )r r r r r s r* is_directoryr s <4?8 88r, module_namepackage_whitelistset[str]c | d t fdt dt dz D S )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
rk c 3 V K | ]#}d d| v V $dS )rk N)r( )r~ xr ri s r* r zEis_module_name_part_of_extension_package_whitelist.. sN 56rr 00 r, r )r r r r )r r ri s `@r* 2is_module_name_part_of_extension_package_whitelistr sk
c " "E :?3u::PQ>:R:R r, )r! r r" r )r= r r> r? r" r )rG rH rI rJ rK rJ r" rL )rV r r" rW )ri rH r" rW )rm r r" rW )r! r rr rJ r" r? )r= r rz r r" r{ )NN)r= r r! r r r r" rJ rR )r= r r! r r" rJ )rp rJ r! r r r r" r )rp rJ r! r r r r" r )rV r r r r" r )F)r r rG rH r r? r" rJ )r= r r r? r" r )r= r r" r? )r r r" r? )r r r! r r" r? )r r r r r" r? )r r r r r" r? )rp rJ r! r r r r" r )r= r r" r? )r r r" r )r r r" r? )r r r r r" r? )\r6
__future__r r] importlib.machineryimportlib.utilr[ r loggingr' r% sysconfigtypesr collections.abcr r r
contextlibr r functoolsr pathlibr
astroid.constr r r
astroid.interpreter._importr r r astroid._backport_stdlib_names getLoggerr3 r` platformr r PY_COMPILED_EXTSget_pathr r addr! r( r real_prefixAttributeErrorbase_exec_prefixr& r parent__annotations__r+ maxsizer dictfromkeysbuiltin_module_namesr Exceptionr2 r< rF rP rS rU rh rl rq ry r r ro r r r r r r r r r r r r ru rv r r r7 r, r* r$ s
# " " " " "
8 8 8 8 8 8 8 8 8 8 7 7 7 7 7 7 7 7 8 8 8 8 8 8 8 8 8 8 2 2 2 2 2 2 2 2
C'''''''BBBBBB 8 $ $ <5!! "N% N
# "8,,.@i.@ .N.NO 7d??RW\\#*f55666
cov>>???? RW\\#*> G G H H H H D
s &(( SS 0i 0 : :;;BZOPPQQQSS 0i 0 : :;;B^STTUUU SS 0i 0 > >??FSTTUUU DD##L11 2 2 9N JKK 7g
o%%%%% 7 7 7 7 [[''(((
{U W--..." "9--/Ay/A)/L/LM -- 8$?? 9 4 4 4 4 :C ' ' ' ' ! ! !
!( ( ( (" " " "J
2
2
2
2 - - - -
" " " "N "&=A 4S S S S S. "& #H H H H H "& #06 06 06 06 06f: : : : :| DI F! ! ! ! !.? ? ? ?8 8 8 8
T T T T<&V &V &V &V &VR 8 "& & & & & &R= = = = 8 8 8 89 9 9 9 sH 3D; ;F3E54F5E=:F<E==FF J J/.J/