o
0iR @ s d Z daddlZddlZddlZddlZddlZejdkZer(ddl Z
ddl Z nddl Z
er3ddgZ
ndgZ
e
d Zee
Zde
Z
dd e
D Zd Zd
Zee Zd d Ze Zd
d Zdd Zdd Zerldd Zndd Zdd Z dd Z dd Z d d Z d d Z erd d! Z!nd"d! Z!dnd$d%Z"e#e"j$Z%d&&d'd(d) Z'e()e'd(Z*d*Z+d+Z,d,gZ-ere-.d- e/ Z0d.gZ1e1 Z2Z3dodd/d0d1Z4d2d3 Z5d4d5 Z6d6d7 Z7d8d9 Z8d:d; Z9dd? Z;d@dA ZdqdFdGZ?drdIdJZ@dKdL ZAeB ZCdodeCdMdNdOZDG dPdQ dQZEG dRdS dSZFG dTdU dUeFZGG dVdW dWZHG dXdY dYeHeGZIG dZd[ d[eHeFZJG d\d] d]eHeFZKG d^d_ d_ZLG d`da daZMG dbdc dcZNG ddde deZOdodfdgZPdhdi ZQdjdk ZRdldm ZSdS )sa^ 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 Zwin32\/ c C s h | ]}d | qS ): ).0sr r D/opt/alt/python310/lib64/python3.10/importlib/_bootstrap_external.py 2 s r
)win)cygwindarwinc s> t jtrt jtrd nd fdd} | S dd } | S )N PYTHONCASEOKs PYTHONCASEOKc s t jj o tjv S )z^True if filenames must be checked case-insensitively and ignore environment flags are not set.)sysflagsignore_environment_osenvironr keyr r _relax_caseC z%_make_relax_case.._relax_casec S dS )z5True if filenames must be checked case-insensitively.Fr r r r r r G )r platform
startswith_CASE_INSENSITIVE_PLATFORMS#_CASE_INSENSITIVE_PLATFORMS_STR_KEY)r r r r _make_relax_case< s r c C s t | d@ ddS )z*Convert a 32-bit integer to little-endian. little)intto_bytes)xr r r _pack_uint32O r r% c C t | dS )z/Convert 4 bytes in little-endian to an integer.r! r"
from_bytesdatar r r _unpack_uint32T r+ c C r& )z/Convert 2 bytes in little-endian to an integer.r! r' r) r r r _unpack_uint16Y r, r- c G s | sdS t | dkr| d S d}g }ttj| D ]=\}}|ts&|tr3|tp,|}t | g}q|drL|
|
krF|}|g}q| | q|pO|}| | qdd |D }t |dkrk|d sk|t S |t | S ) Replacement for os.path.join().r r r c S g | ] }|r| tqS r rstrippath_separatorsr pr r r
w s _path_join..)
lenmapr _path_splitrootr path_sep_tupleendswithr2 r3 path_sepcasefoldappendjoin)
path_partsrootpathZnew_roottailr r r
_path_join` s*
rE c G s t dd | D S )r. c S r0 r r1 )r partr r r r6 s r7 )r= r@ )rA r r r rE ~ s
c sB t fddtD }|dk rd fS d| |d d fS )z Replacement for os.path.split().c 3 s | ]} |V qd S N)rfindr4 rC r r s z _path_split..r r Nr/ )maxr3 )rC ir rI r _path_split s rM c C s
t | S )z~Stat the path.
Made a separate function to make it easier to override in experiments
(e.g. cache stat results).
)r statrI r r r
_path_stat s
rO c C s0 zt | }W n
ty Y dS w |jd@ |kS )z1Test whether the path is the specified mode type.Fi )rO OSErrorst_mode)rC mode stat_infor r r _path_is_mode_type s rT c C s
t | dS )z Replacement for os.path.isfile.i )rT rI r r r _path_isfile
rU c C s | st } t| dS )z Replacement for os.path.isdir.i @ )r getcwdrT rI r r r _path_isdir s
rX c C s> | sdS t | d dd}t|dko |dp |dS ) Replacement for os.path.isabs.Fr r r r/ z\\)r r: replacer8 r r< )rC rB r r r _path_isabs s r[ c C s
| tS )rY )r r3 rI r r r r[ rV c C s d | t| }t|tjtjB tjB |d@ }z$t|d
}| | W d n1 s/w Y t
|| W dS t yT zt | W t yS Y w 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.{}.{}r\ wbN)
formatidr openO_EXCLO_CREATO_WRONLY_ioFileIOwriterZ rP unlink)rC r* rR path_tmpfdfiler r r
_write_atomic s$ rl io
r! s
__pycache__zopt-z.pyz.pywz.pyc) optimizationc C sP |durt dt |durd}t||rdnd}t| } t| \}}|d\}}}tj j
} | du r9t dd |r?|n||| g}
|du rVtj
jdkrRd}ntj
j}t|}|dkrp| sitd |d
|
t|}
|
td } tjdurt|stt |}|d d kr|d tvr|d d }ttj|t| S t|t| 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 rm ) _warningswarnDeprecationWarning TypeErrorr fspathrM
rpartitionr implementation cache_tagNotImplementedErrorr@ r optimizestrisalnum
ValueErrorr_ _OPTBYTECODE_SUFFIXESpycache_prefixr[ rE rW r3 lstrip_PYCACHE) rC debug_overridero messageheadrD basesepresttagalmost_filenamefilenamer r r cache_from_source| sH
r c
C s( t jjdu r
tdt| } t| \}}d}t jdur3t jt }|
|t r3|t |d }d}|sHt|\}}|t
krHtt
d| |d}|dvrXtd||d kr|dd
d }|
tsptd t|t td }| std
|d|dd } t|| td 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.
Nrq FTz not bottom-level directory in rp > rm z expected only 2 or 3 dots in r rm z5optimization portion of filename does not start with zoptimization level z is not an alphanumeric valuer )r rx ry rz r rv rM r r2 r3 r r= r8 r r~ countrsplitr r} partitionrE SOURCE_SUFFIXES)
rC r pycache_filenamefound_in_pycache_prefix
stripped_pathpycache dot_countro opt_level
base_filenamer r r source_from_cache s<
r c C s| t | dkrdS | d\}}}|r | dd dkr | S zt| }W n ttfy5 | dd }Y nw t|r<|S | 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 Nrp py)r8 rw lowerr rz r~ rU )
bytecode_pathr _ extension source_pathr r r _get_sourcefile s r c C sD | ttrzt| W S ty Y d S w | ttr | S d S rG )r< tupler r rz r )r r r r _get_cached s
r c C s2 zt | j}W n ty d}Y nw |dO }|S )z3Calculate the mode permissions for a bytecode file.r\ )rO rQ rP )rC rR r r r
_calc_mode
s r c s4 d fdd }t durt j}ndd }|| |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 sH |d u r| j }n| j |krtd| j |f |d | |g|R i |S )Nz loader for %s cannot handle %sname)r ImportError)selfr argskwargsmethodr r _check_name_wrapper s
z(_check_name.._check_name_wrapperc S s8 dD ]}t ||rt| |t|| q| j|j d S )N)
__module____name__ __qualname____doc__)hasattrsetattrgetattr__dict__update)newoldrZ r r r _wrap+ s
z_check_name.._wraprG )
_bootstrapr )r r r r r r _check_name s
r c C sH t dt | |\}}|du r"t|r"d}t ||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 )rr rs rt find_loaderr8 r_
ImportWarning)r fullnameloaderportionsmsgr r r _find_module_shim5 s r c C s | dd }|t kr d|d|}td| t|fi |t| dk r5d|}td| t|t| dd }|d @ rQd
|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 r8 EOFErrorr+ )r* r exc_detailsmagicr r r r r
_classify_pycI s
r c C s| t | dd |d@ kr d|}td| t|fi ||dur:t | dd |d@ kr B }|t| || |t| |S )z&Produce the data for a hash-based pyc.r/ r )r r checkedr* r r r r _code_to_hash_pyc s
r c C s> ddl }t| j}||}tdd}|| |d S )zyDecode bytes representing source code and return the string.
Universal newline support is used in the decoding.
r NT)tokenizere BytesIOreadlinedetect_encodingIncrementalNewlineDecoderdecode) source_bytesr source_bytes_readlineencodingnewline_decoderr r r
decode_source s
r r submodule_search_locationsc C s6 |du r d}t |dr z|| }W n& ty Y n w n t|}t|s9z tt |}W n ty8 Y nw t j
| ||d}d|_ |du rct D ]\}}|
t|r`|| |}||_ nqKdS |tu rt |drz|| }W n ty| Y n
w |rg |_n||_|jg kr|rt|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 get_filenameoriginT
is_packager )r r r r rv r[ rE rW rP r
ModuleSpec
_set_fileattr_get_supported_file_loadersr< r r _POPULATEr r rM r? ) r locationr r spec loader_classsuffixesr dirnamer r r spec_from_file_location sT
r c @ sX e Zd ZdZdZdZeodev Ze dd Z
e dd Z e dd
d Z
e dd d
Zd S )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 C s2 zt t j| W S ty t t j| Y S w rG )winregOpenKeyHKEY_CURRENT_USERrP HKEY_LOCAL_MACHINEr r r r _open_registry& s
z$WindowsRegistryFinder._open_registryc C s | j r| j}n| j}|j|dtjd d d}z | |}t|d}W d W |S 1 s1w Y W |S t yB Y d S w )Nz%d.%drm )r sys_versionr )
DEBUG_BUILDREGISTRY_KEY_DEBUG REGISTRY_KEYr_ r version_infor r
QueryValuerP )clsr registry_keyr hkeyfilepathr r r _search_registry- s z&WindowsRegistryFinder._search_registryNc C sx | |}|d u r d S zt| W n
ty Y d S w t D ]\}}|t|r9tj|||||d}| S q d S )Nr )r rO rP r r< r r spec_from_loader)r r rC targetr r r r r r r find_spec< s"
z WindowsRegistryFinder.find_specc C s* t dt | ||}|dur|jS 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() insteadNrr rs rt r r r r rC r r r r find_moduleL s z!WindowsRegistryFinder.find_moduleNNrG )r r r r r r _MS_WINDOWSEXTENSION_SUFFIXESr
staticmethodr classmethodr r r r r r r r s
r c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
S )
_LoaderBasicszSBase class of common code needed by both SourceLoader and
SourcelessFileLoader.c C s@ t | |d }|ddd }|dd }|dko |dkS )zConcrete implementation of InspectLoader.is_package by checking if
the path returned by get_filename has a filename of '__init__.py'.r/ rp r rm __init__)rM r r rw )r r r
filename_base tail_namer r r r b s z_LoaderBasics.is_packagec C r z*Use default semantics for module creation.Nr r r r r r
create_modulej z_LoaderBasics.create_modulec C s8 | |j}|du rtd|jtt||j dS )zExecute the module.Nz4cannot load module {!r} when get_code() returns None)get_coder r r_ r _call_with_frames_removedexecr )r moduler r r r exec_modulem s z_LoaderBasics.exec_modulec C s t | |S )zThis method is deprecated.)r _load_module_shimr r r r r load_moduleu r, z_LoaderBasics.load_moduleN)r r r r r r% r+ r. r r r r r ] s r c @ sJ e Zd Zdd Zdd Zdd Zdd Zd d
Zd d d
dZdd Z dS ) SourceLoaderc C s t )zOptional method that returns the modification time (an int) for the
specified path (a str).
Raises OSError when the path cannot be handled.
)rP r rC r r r
path_mtime} s zSourceLoader.path_mtimec C s 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 )r1 r0 r r r
path_stats s zSourceLoader.path_statsc C s | ||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_pathr* r r r _cache_bytecode s z SourceLoader._cache_bytecodec C r )zOptional method which writes data (bytes) to a file path (a str).
Implementing this method allows for the writing of bytecode files.
Nr )r rC r* r r r r3 r& zSourceLoader.set_datac
C sF | |}z
| |}W t|S ty" } ztd|d|d}~ww )z4Concrete implementation of InspectLoader.get_source.z'source not available through get_data()r N)r get_datarP r r )r r rC r excr r r
get_source s
zSourceLoader.get_sourcer ) _optimizec C s t jt||dd|dS )zReturn the code object compiled from source.
The 'data' argument can be any object type that compile() supports.
r) T) dont_inheritr{ )r r( compile)r r* rC r9 r r r source_to_code s zSourceLoader.source_to_codec C s | |}d}d}d}d}d}zt|}W n ty d}Y nw z| |} W n ty1 Y nw t| d }z| |}
W n tyH Y nhw ||d} zGt|
|| } t|
dd }
| d@ dk}|r| d @ dk}t j
d
kr|swt j
d kr| |}t t |}t
|
||| n
t|
|| d || W n ttfy Y nw td
|| t|
|||dS |du r| |}| ||}td| tjs|dur|dur|r|du rt |}t|||}
nt||t|}
z
| |||
W |S ty Y |S 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 rm neveralwayssizez
{} matches {})r r r zcode object from {})r r rz r2 rP r" r6 r
memoryviewr check_hash_based_pycsr _RAW_MAGIC_NUMBERr r r r r r r r< r dont_write_bytecoder r r8 r5 )r r r r r r
hash_based check_sourcer str* r r
bytes_data code_objectr r r r' s
zSourceLoader.get_codeN)
r r r r1 r2 r5 r3 r8 r< r' r r r r r/ { s
r/ c s\ e Zd ZdZdd Zdd Zdd Ze fdd Zed
d Z d d
Z
edd Z Z S )
FileLoaderzgBase file loader class which implements the loader protocol methods that
require file system usage.c C s || _ || _dS )zKCache the module name and the path to the file found by the
finder.Nr )r r rC r r r r s
zFileLoader.__init__c C | j |j ko | j|jkS rG __class__r r otherr r r __eq__
zFileLoader.__eq__c C t | jt | jA S rG hashr rC r r r r __hash__ zFileLoader.__hash__c s t t| |S )zdLoad a module from a file.
This method is deprecated. Use exec_module() instead.
)superrI r. r- rL r r r. s
zFileLoader.load_modulec C | j S z:Return the path to the source file as found by the finder.rI r- r r r r ) zFileLoader.get_filenamec C s t | ttfr$tt| }| W d S 1 s w Y dS t|d }| W d S 1 s9w Y dS )z'Return the data from path as raw bytes.Nr)r r/ ExtensionFileLoaderre open_coder| readrf )r rC rk r r r r6 . s $$zFileLoader.get_datac C s ddl m} || S )Nr )
FileReader)importlib.readersr` )r r* r` r r r get_resource_reader7 s z FileLoader.get_resource_reader)
r r r r r rO rU r r. r r6 rb
__classcell__r r rX r rI s
rI c @ s. e Zd ZdZdd Zdd Zdddd Zd
S ) SourceFileLoaderz>Concrete implementation of SourceLoader using the file system.c C s t |}|j|jdS )z!Return the metadata for the path.)r r? )rO st_mtimest_size)r rC rF r r r r2 A s zSourceFileLoader.path_statsc C s t |}| j|||dS )N_mode)r r3 )r r r r* rR r r r r5 F s z SourceFileLoader._cache_bytecoder\ rg c C s t |\}}g }|r t|s t |\}}|| |r t|rt|D ]1}t||}zt| W q# ty: Y q# tyT } zt
d|| W Y d}~ dS d}~ww zt ||| t
d| W dS ty~ } zt
d|| W Y d}~dS d}~ww )zWrite bytes data to a file.zcould not create {!r}: {!r}Nz created {!r}) rM rX r? reversedrE r mkdirFileExistsErrorrP r r rl ) r rC r* rh parentr rA rF r7 r r r r3 K s8
zSourceFileLoader.set_dataN)r r r r r2 r5 r3 r r r r rd = s
rd c @ s e Zd ZdZdd Zdd ZdS )SourcelessFileLoaderz-Loader which handles sourceless file imports.c C sD | |}| |}||d}t||| tt|dd ||dS )Nr r )r r )r r6 r r r@ )r r rC r* r r r r r' n s
z SourcelessFileLoader.get_codec C r )z'Return None as there is no source code.Nr r- r r r r8 ~ r z SourcelessFileLoader.get_sourceN)r r r r r' r8 r r r r rm j s rm c @ s\ e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dd Z
dd Z e dd Z
dS )r] z]Loader for extension modules.
The constructor is designed to work with FileFinder.
c C s || _ || _d S rG r )r r rC r r r r s
z ExtensionFileLoader.__init__c C rJ rG rK rM r r r rO rP zExtensionFileLoader.__eq__c C rQ rG rR rT r r r rU rV z ExtensionFileLoader.__hash__c C s$ t tj|}t d|j| j |S )z&Create an unitialized extension modulez&extension module {!r} loaded from {!r})r r( r create_dynamicr r rC )r r r* r r r r% s z!ExtensionFileLoader.create_modulec C s$ t tj| t d| j| j dS )z Initialize an extension modulez(extension module {!r} executed from {!r}N)r r( r exec_dynamicr r rC r r* r r r r+ s z ExtensionFileLoader.exec_modulec s$ t | jd t fddtD S )z1Return True if the extension module is a package.r/ c 3 s | ] } d | kV qdS )r Nr r suffix file_namer r rJ s z1ExtensionFileLoader.is_package..)rM rC anyr r- r rs r r s z ExtensionFileLoader.is_packagec C r )z?Return None as an extension module cannot create a code object.Nr r- r r r r' r z ExtensionFileLoader.get_codec C r )z5Return None as extension modules have no source code.Nr r- r r r r8 r z ExtensionFileLoader.get_sourcec C rY rZ rI r- r r r r r[ z ExtensionFileLoader.get_filenameN)r r r r r rO rU r% r+ r r' r8 r r r r r r r] s r] c @ sl e Zd ZdZdZdd Zdd Zdd Zd d
Zd d Z d
d Z
dd Z dd Z dd Z
dd Zdd 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 C s, || _ || _t| | _| j| _|| _d S rG )_name_pathr _get_parent_path_last_parent_path_epoch _last_epoch _path_finderr r rC path_finderr r r r s
z_NamespacePath.__init__c C s& | j d\}}}|dkrdS |dfS )z>Returns a tuple of (parent-module-name, parent-path-attr-name)rp r )r rC __path__)rw rw )r rl dotmer r r _find_parent_path_names s z&_NamespacePath._find_parent_path_namesc C s | \}}ttj| |S rG )r r r modules)r parent_module_namepath_attr_namer r r ry s z _NamespacePath._get_parent_pathc C sd t | }|| jks| j| jkr/| | j|}|d ur(|jd u r(|jr(|j| _ || _| j| _| j S rG )
r ry rz r{ r| r} rw r r rx )r parent_pathr r r r _recalculate s z_NamespacePath._recalculatec C t | S rG )iterr rT r r r __iter__ z_NamespacePath.__iter__c C s | | S rG r )r indexr r r __getitem__ r z_NamespacePath.__getitem__c C s || j |< d S rG )rx )r r rC r r r __setitem__ s z_NamespacePath.__setitem__c C r rG )r8 r rT r r r __len__ r z_NamespacePath.__len__c C d | jS )Nz_NamespacePath({!r}))r_ rx rT r r r __repr__ r z_NamespacePath.__repr__c C s || v S rG r r itemr r r __contains__ r z_NamespacePath.__contains__c C s | j | d S rG )rx r? r r r r r? z_NamespacePath.appendN)r r r r r{ r r ry r r r r r r r r? r r r r rv s
rv c @ sX e Zd Zdd Zedd Zdd Zdd Zd d
Zd d Z d
d Z
dd Z dd Z dS )_NamespaceLoaderc C s t |||| _d S rG )rv rx r~ r r r r s z_NamespaceLoader.__init__c C s t dt d| jS )zsReturn repr for the module.
The method is deprecated. The import machinery does the job itself.
zR_NamespaceLoader.module_repr() is deprecated and slated for removal in Python 3.12z)rr rs rt r_ r )r* r r r module_repr s z _NamespaceLoader.module_reprc C r )NTr r- r r r r z_NamespaceLoader.is_packagec C r )Nr r r- r r r r8 r z_NamespaceLoader.get_sourcec C s t dddddS )Nr zr) T)r: )r; r- r r r r' r z_NamespaceLoader.get_codec C r r# r r$ r r r r% r& z _NamespaceLoader.create_modulec C s d S rG r rp r r r r+ r z _NamespaceLoader.exec_modulec C s 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 rx r, r- r r r r. s z _NamespaceLoader.load_modulec C s ddl m} || jS )Nr )NamespaceReader)ra r rx )r r* r r r r rb ' s
z$_NamespaceLoader.get_resource_readerN)
r r r r r r r r8 r' r% r+ r. rb r r r r r s
r c @ sv e Zd ZdZedd Zedd Zedd Zedd Z edd d Z
edd
dZ edddZ edd Z
d
S )
PathFinderz>Meta path finder for sys.path and package __path__ attributes.c C sN t tj D ]\} }|du rtj| = qt|dr | qt jd7 _dS )z}Call the invalidate_caches() method on all path entry finders
stored in sys.path_importer_caches (where implemented).Ninvalidate_cachesr/ )listr path_importer_cacheitemsr r rv r{ )r finderr r r r 2 s
z PathFinder.invalidate_cachesc C sL t jdurt jstdt t jD ]}z|| W S ty# Y qw dS )z.Search sys.path_hooks for a finder for 'path'.Nzsys.path_hooks is empty)r
path_hooksrr rs r r )rC hookr r r _path_hooks? s
zPathFinder._path_hooksc C sd |dkrzt }W n
ty Y dS w ztj| }W |S ty1 | |}|tj|< Y |S w )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 rW FileNotFoundErrorr r KeyErrorr )r rC r r r r _path_importer_cacheL s
z PathFinder._path_importer_cachec C s t |drt| d}t|t ||\}}nt| d}t|t ||}g }|d ur: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_namerr rs r r r r r r )r r r r r r r r r r _legacy_get_specb s
zPathFinder._legacy_get_specNc C s g }|D ]C}t |ttfsq| |}|durGt|dr#|||}n| ||}|du r.q|jdur7| S |j}|du rBt d|
| qt |d}||_|S )z?Find the loader or namespace_path for this module/package name.Nr zspec missing loader)
r r| bytesr r r r r r r r r r ) r r rC r namespace_pathentryr r r r r r _get_specw s*
zPathFinder._get_specc C s^ |du rt j}| |||}|du rdS |jdu r-|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 rC r r r r rv )r r rC r r r r r r r s
zPathFinder.find_specc C s* t dt | ||}|du rdS |jS )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 r r r r s zPathFinder.find_modulec O s 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 )MetadataPathFinder)importlib.metadatar find_distributions)r r r r r r r s
z PathFinder.find_distributionsrG r )r r r r r r r r r r r r r r r r r r r . s$
r c @ sZ e Zd ZdZdd Zdd ZeZdd Zdd Z dd d Z
d
d Z e dd Z
dd Zd
S )
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 sp g }|D ]\ }| fdd|D q|| _|pd| _t| js+tt | j| _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 s | ]}| fV qd S rG r rq r r r rJ s z&FileFinder.__init__..rp r N) r _loadersrC r[ rE r rW _path_mtimeset _path_cache_relaxed_path_cache)r rC loader_detailsloadersr r r r r s
zFileFinder.__init__c C s
d| _ dS )z Invalidate the directory mtime.r N)r rT r r r r rV z FileFinder.invalidate_cachesc C s6 t dt | |}|du rdg fS |j|jpg 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)rr rs rt r r r )r r r r r r r s
zFileFinder.find_loaderc C s |||}t ||||dS )Nr )r )r r r rC smslr r r r r r s
zFileFinder._get_specNc C sz d}| dd }z t| jpt j}W n ty d}Y nw || jkr-| || _t r8| j
}| }n| j }|}||v rlt
| j|}| jD ] \} }
d| } t
|| } t| rg| |
|| |g| S qJt|}| jD ]7\} }
z
t
| j|| } W n ty Y dS w tjd| dd || |v rt| r| |
|| d| S qo|rtd | t|d}
|g|
_|
S dS )
zoTry to find a spec for the specified module.
Returns the matching spec, or None if not found.
Frp rm r r Nz trying {}) verbosityzpossible namespace for {})rw rO rC r rW re rP r _fill_cacher r r r rE r rU r rX r~ r r r r )r r r is_namespace tail_moduler cache cache_module base_pathrr r
init_filename full_pathr r r r r sV
zFileFinder.find_specc
C s | j }z t|p t }W n tttfy g }Y nw tj ds)t
|| _ n%t
}|D ] }| d\}}}|rCd
|| }n|}|| q.|| _ tj tr^dd |D | _dS dS )zDFill the cache of potential modules and packages for this directory.r rp r] c S s h | ]}| qS r )r )r fnr r r r
P s z)FileFinder._fill_cache..N)rC r listdirrW r PermissionErrorNotADirectoryErrorr r r r r r r_ r addr r ) r rC contentslower_suffix_contentsr r r rr new_namer r r r 3 s& zFileFinder._fill_cachec s fdd}|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 s$ t | s
td| d | gR S )z-Path hook for importlib.machinery.FileFinder.z only directories are supportedrI )rX r rI r r r r path_hook_for_FileFinder\ s z6FileFinder.path_hook..path_hook_for_FileFinderr )r r r r r r path_hookR s
zFileFinder.path_hookc C r )NzFileFinder({!r}))r_ rC rT r r r r d r zFileFinder.__repr__rG )r r r r r r r r r r r r r r r r r r r r s
3
r c C s | d}| d}|s!|r|j}n||kr t||}nt||}|s*t|||d}z|| d< || d< || d< || d< W d S tyG Y d S w )N
__loader____spec__r __file__
__cached__)getr rm rd r Exception)nsr pathname cpathnamer r r r r _fix_up_modulej s$
r c C s& t t f} ttf}ttf}| ||gS )z_Returns a list of file-based module loaders.
Each item is a tuple (loader, suffixes).
)r] r extension_suffixesrd r rm r )
extensionssourcebytecoder r r r s
r c C s | a d S rG )r )_bootstrap_moduler r r _set_bootstrap_module s r c C s2 t | t }tjtj| g tjt dS )z)Install the path-based import components.N)
r r r r r r r meta_pathr? r )r supported_loadersr r r _install s r )r\ rG )NNN)r r )T)Tr r r re r rr r r r ntr r posixr3 r= r r; r@ _pathseps_with_colonr %_CASE_INSENSITIVE_PLATFORMS_BYTES_KEYr r r r% r+ r- rE rM rO rT rU rX r[ rl type__code__r r# r r" r( rB r r r r? r r r DEBUG_BYTECODE_SUFFIXESOPTIMIZED_BYTECODE_SUFFIXESr r r r r r r r r r r r r r objectr r r r r/ rI rd rm r] rv r r r r r r r r r r r s
G( !
IC 2-5E1