fb
R d Z daddlZddlZddlZddlZddlZej dk Zer ddl Z
ddl Z nddl Z
erddgZ
ndgZ
ed e
D sJ e
d Z ee
Zd e
Z
d e
D Zd Zd
Zeez Zd Z e Zd Zd
Zd Zerd Z nd Z d Z d Z d Z d Z d Z!erd Z"nd Z"dOdZ# e$e#j% Z&d' dd d z Z(e)* e(d Z+d Z,d Z-d gZ.ere./ d! ej0 Z1d"gZ2e2xZ3Z4dPdd#d$Z5d% Z6d& Z7d' Z8d( Z9d) Z:d* Z;d+ Z<d, Z=d- Z>dQd.Z?dRd/Z@dSd1ZAd2 ZB eC ZDdPdeDd3d4ZE G d5 d6 ZF G d7 d8 ZG G d9 d:eG ZH G d; d< ZI G d= d>eIeH ZJ G d? d@eIeG ZK G dA dBeIeG ZL G dC dD ZM G dE dF ZNeNZO G dG dH ZP G dI dJ ZQdPdKZRdL ZSdM ZTdN ZUdS )Ta^ Core implementation of path-based import.
This module is NOT meant to be directly imported! It has been designed such
that it can be bootstrapped into Python as the implementation of import. As
such it requires the injection of specific modules and attributes in order to
work. One should use importlib as the public-facing version of this module.
N win32\/c # < K | ]}t | d k V dS ) N)len).0seps D/opt/alt/python311/lib64/python3.11/importlib/_bootstrap_external.py <genexpr>r . s,
4
4S3s88q=
4
4
4
4
4
4 c h | ]}d | S ): )r ss r <setcomp>r 2 s 999AA999r
)win)cygwindarwinc t j t r/t j t rdndfd} nd } | S )N PYTHONCASEOKs PYTHONCASEOKc D t j j o
t j v S )z^True if filenames must be checked case-insensitively and ignore environment flags are not set.)sysflagsignore_environment_osenvironkeys r _relax_casez%_make_relax_case.<locals>._relax_caseC s y33Js{8J Jr
c dS )z5True if filenames must be checked case-insensitively.Fr r r
r r! z%_make_relax_case.<locals>._relax_caseG s 5r
)r platform
startswith_CASE_INSENSITIVE_PLATFORMS#_CASE_INSENSITIVE_PLATFORMS_STR_KEY)r! r s @r _make_relax_caser' < s|
| :;; < " "#F G G " CC!C K K K K K K r
c N t | dz dd S )z*Convert a 32-bit integer to little-endian. little)intto_bytes)xs r _pack_uint32r/ O s# FFZ ) )!X 6 66r
c b t | dk sJ t | d S )z/Convert 4 bytes in little-endian to an integer.r* r+ r r,
from_bytesdatas r _unpack_uint32r5 T ) t99>>>> >>$ ) ))r
c b t | dk sJ t | d S )z/Convert 2 bytes in little-endian to an integer. r+ r1 r3 s r _unpack_uint16r9 Y r6 r
c | sdS t | dk r| d S d}g }t t j | D ]\ }}| t
s| t
r(| t p|}t |z g}a| d rF|
|
k r|}|g}| | |p|}| | d |D }t | dk r|d s
|t z S |t | z S ) Replacement for os.path.join().r r r r c F g | ] }|| t S r rstrippath_separators)r ps r
<listcomp>z _path_join.<locals>.<listcomp>w s) ===a1= ))===r
)
r mapr _path_splitrootr$ path_sep_tupleendswithr> r? path_sepcasefoldappendjoin)
path_partsrootpathnew_roottails r
_path_joinrO ` sg 2 z??a a= !#"5z B B " "NHd"">22
"h6G6G6W6W
" 77?4 4(""3''
"==??h&7&7&9&999 $D 6DDKK%%%% '4 D!!!!==4=== t99>>$q'>(? "hmmD))))r
c J t d | D S )r; c F g | ] }|| t S r r= )r parts r rA z _path_join.<locals>.<listcomp> s8 > > >"& >dkk/ : : > > >r
)rF rI )rJ s r rO rO ~ s4 }} > >*4 > > > ? ? ?r
c t fdt D }|dk rd fS d| |dz d fS )z Replacement for os.path.split().c 3 B K | ]} | V d S N)rfind)r r@ rL s r r z _path_split.<locals>.<genexpr> s- 3 3aDJJqMM 3 3 3 3 3 3r
r r Nr )maxr? )rL is ` r _path_splitrY sV 3 3 3 3? 3 3 333A1uu4x 8T!a%&&\ !!r
c * t j | S )z~Stat the path.
Made a separate function to make it easier to override in experiments
(e.g. cache stat results).
)r statrL s r
_path_statr] s 8D>>r
c b t | }n# t $ r Y dS w xY w|j dz |k S )z1Test whether the path is the specified mode type.Fi )r] OSErrorst_mode)rL mode stat_infos r _path_is_mode_typerc sK t$$ uu (T 11s
c " t | d S )z Replacement for os.path.isfile.i )rc r\ s r _path_isfilere s dH - --r
c L | st j } t | d S )z Replacement for os.path.isdir.i @ )r getcwdrc r\ s r _path_isdirrh s% z|| dH - --r
c | sdS t j | d dd }t | dk o)| d p| d S ) Replacement for os.path.isabs.Fr r r r z\\)r rC replacer r$ rE )rL rK s r _path_isabsrl sf 5"4((+33C>>4yy1}Q$//&"9"9"PT]]4=P=PQr
c 6 | t S )rj )r$ r? r\ s r rl rl s ///r
c d | t | }t j |t j t j z t j z |dz } t j |d 5 }| | ddd n # 1 swxY w Y t j
|| dS # t $ r( t j | n# t $ r Y nw xY w w xY w)zBest-effort function to write data to a path atomically.
Be prepared to handle a FileExistsError if concurrent writing of the
temporary file is attempted.{}.{}rn wbN)
formatidr openO_EXCLO_CREATO_WRONLY_ioFileIOwriterk r_ unlink)rL r4 ra path_tmpfdfiles r
_write_atomicr s6
~~dBtHH--H (*s{*S\94%<
I
IB ZD
!
! T JJt Hd##### Jx D
sT "B; 7B
B; B B; B !B; ;
C-CC-
C(%C-'C((C-i
r8 r+ s
__pycache__zopt-z.pyz.pywz.pyc) optimizationc |3t j dt |d}t | |rdnd}t j | } t
| \ }}| d \ }}}t j j
} | t d d |r|n||| g }
|)t j
j dk rd}nt j
j }t | }|dk rR| s"t# d | d
|
t& | }
|
t( d z } t j t- | s!t/ t j | }|d d k r|d t2 vr
|d d }t/ t j | t2 | S t/ |t6 | S )
a Given the path to a .py file, return the path to its .pyc file.
The .py file does not need to exist; this simply returns the path to the
.pyc file calculated as if the .py file were imported.
The 'optimization' parameter controls the presumed optimization level of
the bytecode file. If 'optimization' is not None, the string representation
of the argument is taken and verified to be alphanumeric (else ValueError
is raised).
The debug_override parameter is deprecated. If debug_override is not None,
a True value is the same as setting 'optimization' to the empty string
while a False value is equivalent to setting 'optimization' to '1'.
If sys.implementation.cache_tag is None then NotImplementedError is raised.
NzFthe debug_override parameter is deprecated; use 'optimization' insteadz2debug_override or optimization must be set to Noner r .$sys.implementation.cache_tag is Noner z{!r} is not alphanumericz{}.{}{}r r8 ) _warningswarnDeprecationWarning TypeErrorr fspathrY
rpartitionr implementation cache_tagNotImplementedErrorrI r optimizestrisalnum
ValueErrorrr _OPTBYTECODE_SUFFIXESpycache_prefixrl rO rg r? lstrip_PYCACHE) rL debug_overrider messageheadrN baser
resttagalmost_filenamefilenames r cache_from_sourcer s $ ! 01C E E E #JGG$$ $ +2rr :d D T""JD$ooc**OD#t
&C
{!"HIIIgg 6$c BCCO 9 " " LL 9-L|$$Lr##%% N 7 > >| L LMM M#**?D,OO !21!55H
% 4 2 cjllD11D
7c>>d1g_ < <8D KK ( (
dHh / //r
c t j j t d t j | } t
| \ }}d}t j Zt j t }|
|t z r|t | d }d}|s6t
| \ }}|t k rt t d| | d }|dvrt d| |d k r| dd
d }|
t" st d t" |t t" d }| st d
|d | d d } t) || t* d z S )an Given the path to a .pyc. file, return the path to its .py file.
The .pyc file does not need to exist; this simply returns the path to
the .py file calculated to correspond to the .pyc file. If path does
not conform to PEP 3147/488 format, ValueError will be raised. If
sys.implementation.cache_tag is None then NotImplementedError is raised.
Nr FTz not bottom-level directory in r > r8 z expected only 2 or 3 dots in r r8 z5optimization portion of filename does not start with zoptimization level z is not an alphanumeric valuer )r r r r r r rY r r> r? r$ rF r r r countrsplitr r partitionrO SOURCE_SUFFIXES)
rL r pycache_filenamefound_in_pycache_prefix
stripped_pathpycache dot_countr opt_level
base_filenames
r source_from_cacher s #+!"HIII :d D ( . .D
#
%*11/BB
??=83 4 4 +M**++,D&* # " *#D))
g h ) ) $ ) ) * *
* &&s++I M9IMMNNN a '..sA66r: &&t,, / .%) . . / /
/ T, "" 3 2< 2 2 2 3 3
3$..s33A6M dMOA,> > ? ??r
c 0 t | dk rdS | d \ }}}|r | dd dk r| S t | }n!# t t
f$ r
| dd }Y nw xY wt
| r|n| S )zConvert a bytecode file path to a source path (if possible).
This function exists purely for backwards-compatibility for
PyImport_ExecCodeModuleWithFilenames() in the C API.
r Nr py)r r lowerr r r re )
bytecode_pathr _ extension source_paths r _get_sourcefiler $ s =Q t&11#66D!Y 9??$$RU+t33 )'
66 , ) ) )#CRC( )&{33 F;; Fs A$ $BBc | t t r! t | S # t $ r Y d S w xY w| t t
r| S d S rU )rE tupler r r r )r s r _get_cachedr 7 s~ //00 $X.. ." DD 5!233 4 4 ts 8
AAc ` t | j }n# t $ r d}Y nw xY w|dz }|S )z3Calculate the mode permissions for a bytecode file.rn )r] r` r_ )rL ra s r
_calc_moder C sM $ ' EMD Ks &&c Z d fd }t
t j }nd } || |S )zDecorator to verify that the module being requested matches the one the
loader can handle.
The first argument (self) must define _name which the second argument is
compared against. If the comparison fails then ImportError is raised.
Nc || j }n'| j |k r t d| j d|| | |g|R i |S )Nz loader for z cannot handle name)r ImportError)selfr argskwargsmethods r _check_name_wrapperz(_check_name.<locals>._check_name_wrapperW sn <9DD
Y$
+!%DD 28<> > >
>vdD242226222r
c dD ]1}t || r t | |t || 2| j |j d S )N)
__module____name__ __qualname____doc__)hasattrsetattrgetattr__dict__update)newoldrk s r _wrapz_check_name.<locals>._wrapd sa P
A
A3(( AC'#w*?*?@@@ L - - - - -r
rU )
_bootstrapr )r r r s ` r _check_namer O s] 3 3 3 3 3 3 . . .
E
v&&& r
c t j dt | | \ }}|Dt | r5d}t j | |d t |S )zTry to find a loader for the specified module by delegating to
self.find_loader().
This method is deprecated in favor of finder.find_spec().
zZfind_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadNz,Not importing directory {}: missing __init__r )r r r find_loaderr rr
ImportWarning)r fullnameloaderportionsmsgs r _find_module_shimr n sv N P%' ' ' ''11FH
~#h--~<szz(1+..
>>> Mr
c v | dd }|t k r0d|d|}t d| t |fi |t | dk r/d|}t d| t | t
| dd }|d z rd
|d |}t |fi ||S ) aT Perform basic validity checking of a pyc header and return the flags field,
which determines how the pyc should be further validated against the source.
*data* is the contents of the pyc file. (Only the first 16 bytes are
required, though.)
*name* is the name of the module being imported. It is used for logging.
*exc_details* is a dictionary passed to ImportError if it raised for
improved debugging.
ImportError is raised when the magic number is incorrect or when the flags
field is invalid. EOFError is raised when the data is found to be truncated.
Nr* zbad magic number in z: {} z(reached EOF while reading pyc header of zinvalid flags z in ) MAGIC_NUMBERr _verbose_messager r EOFErrorr5 )r4 r exc_detailsmagicr r s r
_classify_pycr s
!HE <<<5<<##D'222'11[111
4yy2~~ETEE##D'222w 4!9 % %E u} 2858888'11[111 Lr
c t | dd |dz k r-d|}t d| t |fi ||.t | dd |dz k rt d|fi |dS dS )a Validate a pyc against the source last-modified time.
*data* is the contents of the pyc file. (Only the first 16 bytes are
required.)
*source_mtime* is the last modified timestamp of the source file.
*source_size* is None or the size of the source file in bytes.
*name* is the name of the module being imported. It is used for logging.
*exc_details* is a dictionary passed to ImportError if it raised for
improved debugging.
An ImportError is raised if the bytecode is stale.
r r) zbytecode is stale for r Nr )r5 r r r )r4 source_mtime source_sizer r r s r _validate_timestamp_pycr s & d1R4j!!lZ&?@@3433##D'222'11[111 tBrE{## j(@AA;4;;KK{KKK AAr
c B | dd |k rt d|fi |dS )a Validate a hash-based pyc by checking the real source hash against the one in
the pyc header.
*data* is the contents of the pyc file. (Only the first 16 bytes are
required.)
*source_hash* is the importlib.util.source_hash() of the source file.
*name* is the name of the module being imported. It is used for logging.
*exc_details* is a dictionary passed to ImportError if it raised for
improved debugging.
An ImportError is raised if the bytecode is stale.
r r z.hash in bytecode doesn't match hash of source N)r )r4 source_hashr r s r _validate_hash_pycr sI " AbDz[ Fd F F
! r
c t j | }t |t r4t d| |t
j || |S t d | || )z#Compile bytecode as found in a pyc.zcode object from {!r}NzNon-code object in {!r}r rL )
marshalloads
isinstance
_code_typer r _imp_fix_co_filenamer rr )r4 r r r codes r _compile_bytecoder s = D$
## 9##$;]KKK " !$ 4 4 4 3::=II #-9 9 9 9r
c H t t }| t d | t | | t | | t j | |S )z+Produce the data for a timestamp-based pyc.r ) bytearrayr extendr/ r dumps)r mtimer r4 s r _code_to_timestamp_pycr s| \ " "DKK Q KK U##$$$KK [))***KK
d##$$$ Kr
Tc $ t t }d|dz z }| t | t | dk sJ | | | t j | |S )z&Produce the data for a hash-based pyc.r r )r r r r/ r r r )r r checkedr4 r s r _code_to_hash_pycr s \ " "D 'Q, EKK U##$$$ { q KK KK
d##$$$ Kr
c ddl }t j | j }| | }t j dd }| | |d S )zyDecode bytes representing source code and return the string.
Universal newline support is used in the decoding.
r NT)tokenizerx BytesIOreadlinedetect_encodingIncrementalNewlineDecoderdecode) source_bytesr source_bytes_readlineencodingnewline_decoders r
decode_sourcer sl
OOO K 5 5 >''(=>>H3D$??O ! !,"5"5hqk"B"B C CCr
r submodule_search_locationsc * |:d}t |d r' | | }ng# t $ r Y n[w xY wnVt j | }t | s3 t
t j | }n# t $ r Y nw xY wt
| || }d|_ |Mt D ]<\ }}|
t | r || | }||_ n=dS |t u rAt |d r0 | | }|rg |_ n# t $ r Y n w xY wn||_ |j g k r1|r/t' | d }|j | |S )a= Return a module spec based on a file location.
To indicate that the module is a package, set
submodule_search_locations to a list of directory paths. An
empty list is sufficient, though its not otherwise useful to the
import system.
The loader must take a spec as its only __init__() arg.
Nz <unknown> get_filenameoriginT
is_packager )r r r r r rl rO rg r_ r
ModuleSpec
_set_fileattr_get_supported_file_loadersrE r r _POPULATEr r rY rH ) r locationr r spec loader_classsuffixesr dirnames r spec_from_file_locationr"
s 6> * *
!..t44
:h''8$$
%cjllH==
vh ? ?D D ~&A&C&C "L( x 11
% dH55 $
4 "Y.. 6< ( ( 9
9 # . .t 4 4
968D3
9 +E' &",, <!(++A.G + 2 27 ; ; ; Ks0 ,
99!!B
BB D? ?
E E c e Zd ZdZdZdZeodev Ze d Z
e d Z e d
d Z
e d d ZdS ) WindowsRegistryFinderz>Meta path finder for modules declared in the Windows registry.z;Software\Python\PythonCore\{sys_version}\Modules\{fullname}zASoftware\Python\PythonCore\{sys_version}\Modules\{fullname}\Debugz_d.pydc t j t j | S # t $ r" t j t j | cY S w xY wrU )winregOpenKeyHKEY_CURRENT_USERr_ HKEY_LOCAL_MACHINEr s r _open_registryz$WindowsRegistryFinder._open_registry_ sW B>&":C@@ @ B B B>&";SAA A A A Bs ! )A
A
c 4 | j r| j }n| j }| |dt j d d z } | | 5 }t j |d }d d d n # 1 swxY w Y n# t $ r Y d S w xY w|S )Nz%d.%dr8 )r sys_versionr )
DEBUG_BUILDREGISTRY_KEY_DEBUG REGISTRY_KEYrr r version_infor* r&
QueryValuer_ )clsr registry_keyr hkeyfilepaths r _search_registryz&WindowsRegistryFinder._search_registryf s ? , 1LL +L!!8.58H!8L.L " N N ##C((
7D!,T266
7
7
7
7
7
7
7
7
7
7
7
7
7
7
7 44 s6 B A;/ B ;A??B A?B
BBNc > | | }|d S t | n# t $ r Y d S w xY wt D ]R\ }}| t | r+t | ||| | }|c S Sd S )Nr )r6 r] r_ r rE r r spec_from_loader)r2 r rL targetr5 r r r s r find_specz WindowsRegistryFinder.find_specu s ''11 4 x 44 ; = = FH x 11
!228396(H3M3M:B 3 D D
s +
99c x t j dt | || }||j S dS )zjFind module named in the registry.
This method is deprecated. Use find_spec() instead.
zpWindowsRegistryFinder.find_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadNr r r r: r r2 r rL r s r find_modulez!WindowsRegistryFinder.find_module sI T) + + + }}Xt,, ; 4r
NNrU )r r r r r/ r. _MS_WINDOWSEXTENSION_SUFFIXESr- staticmethodr* classmethodr6 r: r> r r
r r$ r$ S s HH ' A8/A#AKB B \B [
[
[
r
r$ c * e Zd ZdZd Zd Zd Zd ZdS )
_LoaderBasicszSBase class of common code needed by both SourceLoader and
SourcelessFileLoader.c t | | d }| dd d }| d d }|dk o|dk S )zConcrete implementation of InspectLoader.is_package by checking if
the path returned by get_filename has a filename of '__init__.py'.r r r r8 __init__)rY r r r )r r r
filename_base tail_names r r z_LoaderBasics.is_package si t 0 0 : :;;A> Q//2
'',,Q/
*FyJ/FFr
c dS z*Use default semantics for module creation.Nr r r s r
create_modulez_LoaderBasics.create_module r
c | |j }|'t d |j t t ||j dS )zExecute the module.Nz4cannot load module {!r} when get_code() returns None)get_coder r rr r _call_with_frames_removedexecr )r moduler s r exec_modulez_LoaderBasics.exec_module sc }}V_-- < --3VFO-D-DF F
F,,T4 IIIIIr
c 8 t | | S )zThis method is deprecated.)r _load_module_shimr r s r load_modulez_LoaderBasics.load_module s ++D(;;;r
N)r r r r r rM rT rX r r
r rE rE s` G G G9 9 9J J J< < < < <r
rE c > e Zd Zd Zd Zd Zd Zd ZdddZd Z d
S ) SourceLoaderc t )zOptional method that returns the modification time (an int) for the
specified path (a str).
Raises OSError when the path cannot be handled.
)r_ r rL s r
path_mtimezSourceLoader.path_mtime s
r
c 0 d| | iS )a Optional method returning a metadata dict for the specified
path (a str).
Possible keys:
- 'mtime' (mandatory) is the numeric timestamp of last source
code modification;
- 'size' (optional) is the size in bytes of the source code.
Implementing this method allows the loader to read bytecode files.
Raises OSError when the path cannot be handled.
r )r] r\ s r
path_statszSourceLoader.path_stats s ..//r
c . | || S )zOptional method which writes data (bytes) to a file path (a str).
Implementing this method allows for the writing of bytecode files.
The source path is needed in order to correctly transfer permissions
)set_data)r r
cache_pathr4 s r _cache_bytecodez SourceLoader._cache_bytecode s }}Z...r
c dS )zOptional method which writes data (bytes) to a file path (a str).
Implementing this method allows for the writing of bytecode files.
Nr )r rL r4 s r ra zSourceLoader.set_data rN r
c | | } | | }n$# t $ r}t d| |d}~ww xY wt | S )z4Concrete implementation of InspectLoader.get_source.z'source not available through get_data()r N)r get_datar_ r r )r r rL r
excs r
get_sourcezSourceLoader.get_source s| ** 6 ==..LL 6 6 6 G#+- - -25
6 6 \***s -
AA Ar ) _optimizec L t t ||dd| S )zReturn the code object compiled from source.
The 'data' argument can be any object type that compile() supports.
rR T) dont_inheritr )r rQ compile)r r4 rL ri s r source_to_codezSourceLoader.source_to_code s1
33GT459I 4 O O Or
c | | }d}d}d}d}d} t | } | | } t | d } | | }
||d} t |
|| } t
|
dd }
| dz dk }|rm| d z dk }t j d
k rS|st j d k rA| | }t j t | }t |
||| nt |
|| d || t d
|| t |
||| S # t t" f$ r Y n6w xY w# t$ $ r Y n&w xY w# t$ $ r Y nw xY w# t& $ r d}Y nw xY w|| | }| || }t d| t* j su|s|q|r(|t j | }t/ ||| }
n t1 ||t3 | }
| |||
n# t& $ r Y nw xY w|S )zConcrete implementation of InspectLoader.get_code.
Reading of bytecode requires path_stats to be implemented. To write
bytecode, set_data must also be implemented.
NFTr r r r r r8 neveralwayssizez
{} matches {})r r r zcode object from {})r r r_ r, rf r
memoryviewr check_hash_based_pycsr _RAW_MAGIC_NUMBERr r r r r r r r_ r rm r dont_write_bytecoder r r rc )r r r r r
r
hash_based check_sourcer str4 r r
bytes_data code_objects r rP zSourceLoader.get_code sM ''11
3 J -k : :M.
J__[11 #2g; / / (J == 77D
!) -# #K J -dHk J J%/%5%5bcc%:
%*S[A%5
% +04<1+<L $ :g E E!- !F!%!;x!G!G/3}}[/I/I .2.>$5$0/" /" !34h3>!@ !@ !@ 4 $ , "6
( + #33O]4?A A A 0(?L=H J J J J (2 ? D
# ! ! ! MMM !d ==55L)), DD ##$9;GGG' M,E (
A &"&"2<"@"@K(k<PP-k<.1,.?.?A A
$$[-FFFF&
sY F F E6 7B9E E32E36
FF
FF F%$F% I! !
I.-I.N)
r r r r] r_ rc ra rh rm rP r r
r rZ rZ s 0 0 0 / / / + + + 79 O O O O OR R R R Rr
rZ c v e Zd ZdZd Zd Zd Ze fd Zed Z d Z
ed Z xZ S )
FileLoaderzgBase file loader class which implements the loader protocol methods that
require file system usage.c " || _ || _ dS )zKCache the module name and the path to the file found by the
finder.Nr )r r rL s r rG zFileLoader.__init__I s r
c B | j |j k o| j |j k S rU __class__r r others r __eq__zFileLoader.__eq__O $ %/1 0
/ 1r
c T t | j t | j z S rU hashr rL r s r __hash__zFileLoader.__hash__S DIdi 00r
c T t t | | S )zdLoad a module from a file.
This method is deprecated. Use exec_module() instead.
)superr| rX )r r r s r rX zFileLoader.load_moduleV s# Z&&228<<<r
c | j S z:Return the path to the source file as found by the finder.r\ rW s r r zFileLoader.get_filenameb yr
c ^ t | t t f rOt j t | 5 }| cddd S # 1 swxY w Y dS t j |d 5 }| cddd S # 1 swxY w Y dS )z'Return the data from path as raw bytes.Nr)r rZ ExtensionFileLoaderrx open_coder readry )r rL r~ s r rf zFileLoader.get_datag s d\+> ? @ @ # s4yy))
#Tyy{{
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
# D#&&
#$yy{{
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#
#s# A A#&A#B""B&)B&c $ ddl m} || S )Nr )
FileReader)importlib.readersr )r rS r s r get_resource_readerz FileLoader.get_resource_readerp s$ 000000z$ r
)
r r r r rG r r r rX r rf r
__classcell__)r s @r r| r| D s " " 1 1 11 1 1 = = = = [ = [# # # [ r
r| c * e Zd ZdZd Zd ZdddZdS )SourceFileLoaderz>Concrete implementation of SourceLoader using the file system.c > t | }|j |j dS )z!Return the metadata for the path.)r rq )r] st_mtimest_size)r rL rx s r r_ zSourceFileLoader.path_statsz s!
bj999r
c P t | }| ||| S )N_mode)r ra )r r r r4 ra s r rc z SourceFileLoader._cache_bytecode s' +&&}}]D}===r
rn r c p t | \ }}g }|rGt | s8t | \ }}| | |rt | 8t | D ]g}t || } t j | (# t $ r Y 4t $ r(}t
d|| Y d}~ dS d}~ww xY w t ||| t
d| dS # t $ r'}t
d|| Y d}~dS d}~ww xY w)zWrite bytes data to a file.zcould not create {!r}: {!r}Nz created {!r}) rY rh rH reversedrO r mkdirFileExistsErrorr_ r r r ) r rL r4 r parentr rJ rR rg s r ra zSourceFileLoader.set_data s &t,,
$[ 0 0 $&v..LFD d # # # $[ 0 0 $ Z(( D --F
&!!!!"
++,I,2C9 9 9
- $e , , , ' ' = = = = = - - - ' '(Et(+
-
-
-
-
-
-
-
-
- -s6 B
C! C* C
C,D
D5 D00D5N)r r r r r_ rc ra r r
r r r v sV HH: : :
> > >
-2 - - - - - - -r
r c e Zd ZdZd Zd ZdS )SourcelessFileLoaderz-Loader which handles sourceless file imports.c | | }| | }||d}t ||| t t | dd || S )Nr r )r r )r rf r r rr )r r rL r4 r s r rP z SourcelessFileLoader.get_code s **}}T""
dHk222 t RSS !
r
c dS )z'Return None as there is no source code.Nr rW s r rh z SourcelessFileLoader.get_source tr
N)r r r r rP rh r r
r r r s8 77
r
r c X e Zd ZdZd Zd Zd Zd Zd Zd Z d Z
d Z e d
Z
d S ) r z]Loader for extension modules.
The constructor is designed to work with FileFinder.
c " || _ || _ d S rU r )r r rL s r rG z ExtensionFileLoader.__init__ s r
c B | j |j k o| j |j k S rU r r s r r zExtensionFileLoader.__eq__ r r
c T t | j t | j z S rU r r s r r z ExtensionFileLoader.__hash__ r r
c t t j | }t d|j | j |S )z(Create an uninitialized extension modulez&extension module {!r} loaded from {!r})r rQ r create_dynamicr r rL )r r rS s r rM z!ExtensionFileLoader.create_module sH 55 ' '##$L DI / / /
r
c t t j | t d| j | j dS )z Initialize an extension modulez(extension module {!r} executed from {!r}N)r rQ r exec_dynamicr r rL r rS s r rT z ExtensionFileLoader.exec_module sI ,,T->GGG##$N DI / / / / /r
c x t | j d t fdt D S )z1Return True if the extension module is a package.r c 3 * K | ]
}d |z k V dS )rG Nr )r suffix file_names r r z1ExtensionFileLoader.is_package.<locals>.<genexpr> sA 5 5
V 33 5 5 5 5 5 5r
)rY rL anyrA )r r r s @r r z ExtensionFileLoader.is_package sO **1- 5 5 5 5!35 5 5 5 5 5r
c dS )z?Return None as an extension module cannot create a code object.Nr rW s r rP z ExtensionFileLoader.get_code r r
c dS )z5Return None as extension modules have no source code.Nr rW s r rh z ExtensionFileLoader.get_source r r
c | j S r r\ rW s r r z ExtensionFileLoader.get_filename r r
N)r r r r rG r r rM rT r rP rh r r r r
r r r s 1 1 11 1 1 / / / 5 5 5 [ r
r c X e Zd ZdZdZd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
d Zd
ZdS )_NamespacePatha& Represents a namespace package's path. It uses the module name
to find its parent module, and from there it looks up the parent's
__path__. When this changes, the module's own path is recomputed,
using path_finder. For top-level modules, the parent module's path
is sys.path.r c || _ || _ t | | _ | j | _ || _ d S rU )_name_pathr _get_parent_path_last_parent_path_epoch _last_epoch _path_finderr r rL path_finders r rG z_NamespacePath.__init__ sD
!&t'<'<'>'>!?!? ; 'r
c V | j d \ }}}|dk rdS |dfS )z>Returns a tuple of (parent-module-name, parent-path-attr-name)r r )r rL __path__)r r )r r dotmes r _find_parent_path_namesz&_NamespacePath._find_parent_path_names s8 *//44R "99 = z!!r
c p | \ }}t t j | | S rU )r r r modules)r parent_module_namepath_attr_names r r z _NamespacePath._get_parent_path
s1 -1-I-I-K-K*Ns{#56GGGr
c t | }|| j k s| j | j k rJ| | j | }||j |j r |j | _ || _ | j | _ | j S rU )
r r r r r r r r r r )r parent_pathr s r _recalculatez_NamespacePath._recalculate s D 1 1 3 344 $0 0 0DK4CS4S4S$$TZ==D DK$72 A!%!@DJ%0D " #{D zr
c D t | S rU )iterr r s r __iter__z_NamespacePath.__iter__ s D%%''(((r
c 6 | | S rU r )r indexs r __getitem__z_NamespacePath.__getitem__" s ""5))r
c || j |< d S rU )r )r r rL s r __setitem__z_NamespacePath.__setitem__% s
5r
c D t | S rU )r r r s r __len__z_NamespacePath.__len__( s 4$$&&'''r
c 6 d | j S )Nz_NamespacePath({!r}))rr r r s r __repr__z_NamespacePath.__repr__+ s %,,TZ888r
c . || v S rU r r items r __contains__z_NamespacePath.__contains__. s t((****r
c : | j | d S rU )r rH r s r rH z_NamespacePath.append1 s
$ r
N)r r r r r rG r r r r r r r r r rH r r
r r r s F( ( (" " "H H H ) ) )* * *! ! !( ( (9 9 9+ + + r
r c T e Zd Zd Zed Zd Zd Zd Zd Z d Z
d Z d Z d
S ) NamespaceLoaderc 2 t ||| | _ d S rU )r r r s r rG zNamespaceLoader.__init__9 s #D$ <<
r
c j t j dt d | j S )zsReturn repr for the module.
The method is deprecated. The import machinery does the job itself.
zQNamespaceLoader.module_repr() is deprecated and slated for removal in Python 3.12z<module {!r} (namespace)>)r r r rr r )rS s r module_reprzNamespaceLoader.module_repr< s9 ;<N P P P*11&/BBBr
c dS )NTr rW s r r zNamespaceLoader.is_packageG s tr
c dS )Nr r rW s r rh zNamespaceLoader.get_sourceJ s rr
c ( t dddd S )Nr z<string>rR T)rk )rl rW s r rP zNamespaceLoader.get_codeM s r:vDAAAAr
c dS rK r rL s r rM z NamespaceLoader.create_moduleP rN r
c d S rU r r s r rT zNamespaceLoader.exec_moduleS s r
c x t d| j t | | S )zbLoad a namespace module.
This method is deprecated. Use exec_module() instead.
z&namespace module loaded with path {!r})r r r rV rW s r rX zNamespaceLoader.load_moduleV s< ##$L$(J 0 0 0 ++D(;;;r
c . ddl m} || j S )Nr )NamespaceReader)r r r )r rS r s r r z#NamespaceLoader.get_resource_readerb s& 555555 tz***r
N)
r r r rG rB r r rh rP rM rT rX r r r
r r r 8 s = = = C C \C B B B9 9 9
<
<
<+ + + + +r
r c e Zd ZdZed Zed Zed Zed Z ed d Z
ed d Z ed d Z ed
Z
dS )
PathFinderz>Meta path finder for sys.path and package __path__ attributes.c L t t j D ]H\ } }|t | st j | = $t |d r| It xj dz
c_ ddl m
} | dS )z}Call the invalidate_caches() method on all path entry finders
stored in sys.path_importer_caches (where implemented).Ninvalidate_cachesr r MetadataPathFinder) listr path_importer_cacheitemsrl r r r r importlib.metadatar )r finderr s r r z PathFinder.invalidate_cachesq s !!8!>!>!@!@ A A + +LD& ~[%6%6~+D11!455
+((*** " 999999,,.....r
c t j &t j st j dt t j D ] } || c S # t
$ r Y w xY wdS )z.Search sys.path_hooks for a finder for 'path'.Nzsys.path_hooks is empty)r
path_hooksr r r r )rL hooks r _path_hookszPathFinder._path_hooks sw > %cn % N4m D D DN D
tDzz!!!
4s
A
A A c |dk r& t j }n# t $ r Y dS w xY w t j | }n4# t
$ r' | | }|t j |< Y nw xY w|S )zGet the finder for the path entry from sys.path_importer_cache.
If the path entry is not in the cache, find the appropriate finder
and cache it. If no finder is available, store None.
r N)r rg FileNotFoundErrorr r KeyErrorr )r2 rL r s r _path_importer_cachez PathFinder._path_importer_cache s 2::
z||$
tt
3,T2FF 3 3 3__T**F,2C #D ) ) ) 3
s
**A .A21A2c t |d rPt | d}t j |t
| | \ }}nNt | d}t j |t
| | }g }|t || S t |d }||_
|S )Nr z5.find_spec() not found; falling back to find_loader()z5.find_spec() not found; falling back to find_module()) r r _object_namer r r r r> r8 r r )r2 r r r r r r s r _legacy_get_speczPathFinder._legacy_get_spec s 6= ) )
--f55 4 4 4C N3
. . . % 1 1( ; ; FHH --f55 4 4 4C N3
. . .''11FH ..x@@ @$$Xt44*2' r
Nc g }|D ]}t |t s| | }|xt |d r| || }n| || }|o|j |c S |j }|t d | | t |d }||_ |S )z?Find the loader or namespace_path for this module/package name.Nr: zspec missing loader) r r r r r: r r r r r r r ) r2 r rL r9 namespace_pathentryr r r s r _get_speczPathFinder._get_spec s
E eS))
--e44F!6;// B!++Hf==DD //&AAD< ;* KKK :#%&;<<<
%%h/// ((488D.<D +Kr
c | t j }| ||| }|dS |j /|j }|r$d|_ t
||| j |_ |S dS |S )zTry to find a spec for 'fullname' on sys.path or 'path'.
The search is based on sys.path_hooks and sys.path_importer_cache.
N)r rL r
r r r r )r2 r rL r9 r r s r r: zPathFinder.find_spec sw <8D}}XtV44 <4
[
! <N
# 2@>[^[h2i2i/ tKr
c x t j dt | || }|dS |j S )zfind the module on sys.path or 'path' based on sys.path_hooks and
sys.path_importer_cache.
This method is deprecated. Use find_spec() instead.
zePathFinder.find_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadNr< r= s r r> zPathFinder.find_module sH T) + + + }}Xt,, <4{r
c ( ddl m} |j | i |S )a
Find distributions.
Return an iterable of all Distribution instances capable of
loading the metadata for packages matching ``context.name``
(or all names if ``None`` indicated) along the paths in the list
of directories ``context.path``.
r r )r r find_distributions)r r r s r r z PathFinder.find_distributions s/ :999994!4dEfEEEr
rU r? )r r r r rB r r rC r r r
r: r> r r r
r r r m s HH/ / \/"
\
[* [( [ > [.
[
F
F \
F
F
Fr
r c X e Zd ZdZd Zd ZeZd Zd Z d dZ
d Z e d Z
d
ZdS )
FileFinderzFile-based finder.
Interactions with the file system are cached for performance, being
refreshed when the directory the finder is handling has been modified.
c g }|D ]&\ }| fd|D '|| _ |r|dk rt j | _ n=t | s't
t j | | _ n|| _ d| _ t | _ t | _
dS )zInitialize with the path to search on and a variable number of
2-tuples containing the loader and the file suffixes the loader
recognizes.c 3 K | ]}|fV d S rU r )r r r s r r z&FileFinder.__init__.<locals>.<genexpr> s( CCFF+CCCCCCr
r r N) r _loadersr rg rL rl rO _path_mtimeset _path_cache_relaxed_path_cache)r rL loader_detailsloadersr r s @r rG zFileFinder.__init__ s . D D FH NNCCCC(CCC C C C C
ts{{
DII T"" "3:<<66DII DI 55#&55 r
c d| _ dS )z Invalidate the directory mtime.r N)r r s r r z FileFinder.invalidate_caches- s r
c t j dt | | }|dg fS |j |j pg fS )zTry to find a loader for the specified module, or the namespace
package portions. Returns (loader, list-of-portions).
This method is deprecated. Use find_spec() instead.
zeFileFinder.find_loader() is deprecated and slated for removal in Python 3.12; use find_spec() insteadN)r r r r: r r )r r r s r r zFileFinder.find_loader3 sW T) + + + ~~h'' <8O{D ; ArAAr
c @ ||| }t |||| S )Nr )r" )r r r rL smslr9 r s r r
zFileFinder._get_specB s7 h--&xfBFH H H Hr
Nc d}| d d } t | j pt j j }n# t $ r d}Y nw xY w|| j k r| || _ t r | j
}| }n | j }|}||v rqt | j | }| j D ]E\ } }
d| z } t || } t | r | |
|| |g| c S Ft# | }| j D ]\ } }
t | j || z } n# t$ $ r Y dS w xY wt& d| d || z |v r*t | r| |
|| d| c S |r@t& d | t& |d }
|g|
_ |
S dS )
zoTry to find a spec for the specified module.
Returns the matching spec, or None if not found.
Fr r8 r rG Nz trying {}) verbosityzpossible namespace for {})r r] rL r rg r r_ r _fill_cacher! r r r rO r re r
rh r r r r r )r r r9 is_namespace tail_moduler cache cache_module base_pathr r
init_filename full_pathr s r r: zFileFinder.find_specG s_
))#..q1 ty 8CJLL99BEE EEE D$ $ $ $D == ',E&,,..LL$E&L 5 "49k::I(,
6
6$ *V 3
&y- @ @ ** b >>,)i[Z`aaaaab
+9 5 5 $(M 8 8 FL
&ty+2F G G
ttt
' ' Y! ' L L Lf$-- ** 8 >>,)*. 8 8 8 8 8 ' '(CY O O O ((488D/8kD +Kts# ,A AA9E
E! E!c d | j } t j |pt j }n # t t
t f$ r g }Y nw xY wt j d st | | _ nut }|D ]]}| d \ }}}|r)d
|| }n|}| | ^|| _ t j t rd |D | _ dS dS )zDFill the cache of potential modules and packages for this directory.r r rp c 6 h | ]}| S r )r )r fns r r z)FileFinder._fill_cache.<locals>.<setcomp> s 'F'F'Fr
'F'F'Fr
N)rL r listdirrg r PermissionErrorNotADirectoryErrorr r# r$ r r r rr r addr% r ) r rL contentslower_suffix_contentsr r r r new_names r r# zFileFinder._fill_cachez sA y {4#73:<<88HH!?4FG HHH |&&u-- 5 "8}}D %(EE !
4
4$(NN3$7$7!c6 $ &~~dFLLNN C CHH #H%))(3333 4D < " "#> ? ? G'F'FX'F'F'FD $ $ $ G Gs '1 A
A
c fd}|S )a A class method which returns a closure to use on sys.path_hook
which will return an instance using the specified loaders and the path
called on the closure.
If the path called on the closure is not a directory, ImportError is
raised.
c V t | st d| | gR S )z-Path hook for importlib.machinery.FileFinder.z only directories are supportedr\ )rh r )rL r2 r s r path_hook_for_FileFinderz6FileFinder.path_hook.<locals>.path_hook_for_FileFinder s@ t$$
O!"BNNNN3t-n--- -r
r )r2 r r7 s `` r path_hookzFileFinder.path_hook s* . . . . . . ('r
c 6 d | j S )NzFileFinder({!r}))rr rL r s r r zFileFinder.__repr__ s !((333r
rU )r r r r rG r r r> r r
r: r# rC r8 r r r
r r r s ) ) )& $K
B
B
B H H H
1 1 1 1f G G G> ( ( [("4 4 4 4 4r
r c 4 | d }| d }|s1|r|j }n'||k rt || }nt || }|st ||| } || d< || d< || d< || d< d S # t
$ r Y d S w xY w)N
__loader____spec__)r __file__
__cached__)getr r r r" Exception)nsr pathname cpathnamer r s r _fix_up_modulerD s
VVL
!
!F
66* D 6 6[FF
"
")$99FF%dH55F F&tXfEEE
:!<!:$<
s 3B
BBc x t t j f} t t f}t
t f}| ||gS )z_Returns a list of file-based module loaders.
Each item is a tuple (loader, suffixes).
)r r extension_suffixesr r r r )
extensionssourcebytecodes r r r s9
%d&=&?&??J
.F#%66H ))r
c
| a d S rU )r )_bootstrap_modules r _set_bootstrap_modulerL s "JJJr
c t | t }t j t j | g t j t dS )z)Install the path-based import components.N)
rL r r r r r r8 meta_pathrH r )rK supported_loaderss r _installrP s[ +,,,355N:/1BCDEEEM$$$$$r
)rn rU )NNN)r r )T)Vr r r rx r r r r# r@ ntr r& posixr? allrF r rD rI _pathseps_with_colonr& %_CASE_INSENSITIVE_PLATFORMS_BYTES_KEYr% r' r! r/ r5 r9 rO rY r] rc re rh rl r type__code__r r- r r, r2 rt r r r rH rF rA r DEBUG_BYTECODE_SUFFIXESOPTIMIZED_BYTECODE_SUFFIXESr r r r r r r r r r r r r r objectr r" r$ rE rZ r| r r r r r _NamespaceLoaderr r rD r rL rP r r
r <module>r\ sK ,
|w& MMMM SkOOeO
s
4
4O
4
4
444 4 44 1 ''''/**99 999 '- #(: % E"E!F 7 7 7
* * *
* * * "?* * * *<? ? ? " " " 2 2 2. . .
. . . 0R R R R0 0 0
, T-(
)
)
j q(++g5 NN<::
' #6""",T,.. H 8I I 5D0 D0 D0 D0 D0 D0N%@ %@ %@PG G G& > ( BL L L8
0
9
9
9
9 D D D
FHH D47@D D D D DR@ @ @ @ @ @ @ @F< < < < < < < <<M M M M M= M M M`/ / / / / / / / d*- *- *- *- *-z< *- *- *-Z :} 22 2 2 2 2*m 2 2 2jA A A A A A A A N,+ ,+ ,+ ,+ ,+ ,+ ,+ ,+` #
aF aF aF aF aF aF aF aFH[4 [4 [4 [4 [4 [4 [4 [4@
.* * *# # #
% % % % %r