U
&.e @ s d Z ddladdlZddladdlZddlZtjdkZerLddlZ ddl
Z
nddl Z erbddgZ ndgZ e d Z
ee Zde Z dd e D Zd Zd
Zee Zd d Zd
d Zdd Zdd Zerdd Zndd Zdd Zdd Zdd Z d d Z d d Z erd d! Z nd"d! Z dd$d%Z e!e j"Z#d&$d'd(d) Z%e&'e%d(Z(d*Z)d+Z*d,gZ+d-gZ,e, Z-Z.ddd.d/d0Z/d1d2 Z0d3d4 Z1d5d6 Z2d7d8 Z3d9d: Z4d;d< Z5d=d> Z6d?d@ Z7dAdB Z8ddCdDZ9ddEdFZ:ddHdIZ;dJdK Zdde>dLdMdNZ?G dOdP dPZ@G dQdR dRZAG dSdT dTeAZBG dUdV dVZCG dWdX dXeCeBZDG dYdZ dZeCeAZEg ZFG d[d\ d\eCeAZGG d]d^ d^ZHG d_d` d`ZIG dadb dbZJG dcdd ddZKddedfZLdgdh ZMdidj ZNdkdl ZOdmdndodpdqdrdsdtdudvdwdxdydzd{d|d}ZPd~d ZQdS )a^ 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.
NZwin32\/ c C s h | ]}d | qS : .0sr r 5/usr/lib64/python3.8/importlib/_bootstrap_external.py / s r )win)cygwindarwinc s< t jtr0t jtr d nd fdd} ndd } | S )N PYTHONCASEOKs PYTHONCASEOKc s
t jkS )5True if filenames must be checked case-insensitively.)_osenvironr keyr r _relax_case@ s z%_make_relax_case.._relax_casec S s dS )r Fr r r r r r D s )sysplatform
startswith_CASE_INSENSITIVE_PLATFORMS#_CASE_INSENSITIVE_PLATFORMS_STR_KEY)r r r r _make_relax_case9 s r c C s t | d@ ddS )z*Convert a 32-bit integer to little-endian. little)intto_bytes)xr r r _pack_uint32J s r# c C s t | dS )z/Convert 4 bytes in little-endian to an integer.r r
from_bytesdatar r r _unpack_uint32O s r( c C s t | dS )z/Convert 2 bytes in little-endian to an integer.r r$ r& r r r _unpack_uint16T s r) c G s | sdS t | dkr | d S d}g }ttj| D ]z\}}|tsL|trf|tpX|}t | g}q0|dr|
|
kr|}|g}q| | q0|p|}| | q0dd |D }t |dkr|d s|t S |t | S ) Replacement for os.path.join().r r r c S s g | ]}|r| tqS r rstrippath_separatorsr pr r r
r s _path_join..)
lenmapr _path_splitrootr path_sep_tupleendswithr- r. path_sepcasefoldappendjoin)
path_partsrootpathZnew_roottailr r r
_path_join[ s*
r@ c G s t dd | D S )r* c S s g | ]}|r| tqS r r, )r partr r r r1 { s r2 )r8 r; )r< r r r r@ y s
c sB t fddtD }|dk r&d fS d| |d d fS )z Replacement for os.path.split().c 3 s | ]} |V qd S N)rfindr/ r> r r s z _path_split..r r Nr+ )maxr. )r> ir rD r _path_split s rH 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 statrD r r r
_path_stat s rJ c C s2 z t | }W n tk
r" Y dS X |jd@ |kS )z1Test whether the path is the specified mode type.Fi )rJ OSErrorst_mode)r> mode stat_infor r r _path_is_mode_type s
rO c C s
t | dS )z Replacement for os.path.isfile.i )rO rD r r r _path_isfile s rP c C s | s t } t| dS )z Replacement for os.path.isdir.i @ )r getcwdrO rD r r r _path_isdir s rR c C s> | sdS t | d dd}t|dko<|dp<|dS ) Replacement for os.path.isabs.Fr r r r+ z\\)r r5 replacer3 r r7 )r> r= r r r _path_isabs s rU c C s
| tS )rS )r r. rD r r r rU s c C s d | t| }t|tjtjB tjB |d@ }z2t|d}| | W 5 Q R X t
|| W n: t k
r zt | W n t k
r Y nX Y nX dS )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.{}.{}rV wbN)
formatidr openO_EXCLO_CREATO_WRONLY_ioFileIOwriterT rK unlink)r> r' rM path_tmpfdfiler r r
_write_atomic s rf iU
r s
__pycache__zopt-z.pyz.pyc) optimizationc C sX |dk r4t dt |dk r(d}t||r0dnd}t| } t| \}}|d\}}}tj j
} | dkrrt dd |r~|n||| g}
|dkrtj
jdkrd}ntj
j}t|}|dkr| std |d
|
t|}
|
td } tjdk rLt|stt |}|d d kr8|d tkr8|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 rg ) _warningswarnDeprecationWarning TypeErrorr fspathrH
rpartitionr implementation cache_tagNotImplementedErrorr; flagsoptimizestrisalnum
ValueErrorrY _OPTBYTECODE_SUFFIXESpycache_prefixrU r@ rQ r. lstrip_PYCACHE) r> debug_overrideri messageheadr? basesepresttagalmost_filenamefilenamer r r cache_from_sourceb sH
r c
C s. t jjdkrtdt| } t| \}}d}t jdk rft jt }|
|t rf|t |d }d}|st|\}}|t
krtt
d| |d}|dkrtd|n\|d kr|dd
d }|
tstd 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.
Nrk FTz not bottom-level directory in rj > rg z expected only 2 or 3 dots in r rg z5optimization portion of filename does not start with zoptimization level z is not an alphanumeric valuer )r rr rs rt r rp rH r| r- r. r r8 r3 r~ ry countrsplitrz rx partitionr@ SOURCE_SUFFIXES)
r> r pycache_filenamefound_in_pycache_prefix
stripped_pathpycache dot_countri opt_level
base_filenamer r r source_from_cache s4
r c C s~ t | dkrdS | d\}}}|r8| dd dkr<| S z t| }W n$ ttfk
rl | dd }Y nX t|rz|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 Nrj py)r3 rq lowerr rt ry rP )
bytecode_pathr _ extension source_pathr r r _get_sourcefile s r c C sJ | ttr0z
t| W S tk
r, Y qFX n| ttrB| S d S d S rB )r7 tupler r rt r{ )r r r r _get_cached s
r c C s4 zt | j}W n tk
r& d}Y nX |dO }|S )z3Calculate the mode permissions for a bytecode file.rV )rJ rL rK )r> rM r r r
_calc_mode s
r c sD d fdd }z
t j}W n tk
r4 dd }Y nX || |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 sB |d kr| j }n | j |kr0td| j |f |d | |f||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)newoldrT r r r _wrap s
z_check_name.._wrap)N)
_bootstrapr NameError)r r r r r r _check_name s
r c C s< | |\}}|dkr8t|r8d}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().
Nz,Not importing directory {}: missing __init__r ) find_loaderr3 rl rm rY
ImportWarning)r fullnameloaderportionsmsgr r r _find_module_shim s
r c C s | dd }|t kr )
marshalloads
isinstance
_code_typer r _imp_fix_co_filenamer rY )r' r r r coder r r _compile_bytecode~ s
r c C sF t t}|td |t| |t| |t| |S )z+Produce the data for a timestamp-based pyc.r bytearrayr extendr# r dumps)r mtimer r' r r r _code_to_timestamp_pyc s r Tc C s@ t t}d|d> B }|t| || |t| |S )z&Produce the data for a hash-based pyc.r+ r )r r checkedr' ru 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)tokenizer_ BytesIOreadlinedetect_encodingIncrementalNewlineDecoderdecode) source_bytesr source_bytes_readlineencodingnewline_decoderr r r
decode_source s
r r submodule_search_locationsc C s |dkr get_filenameoriginT
is_packager )r r r r rp r
ModuleSpec
_set_fileattr_get_supported_file_loadersr7 r r _POPULATEr r rH r: ) r locationr r spec loader_classsuffixesr dirnamer r r spec_from_file_location s>
r c @ sP e Zd ZdZdZdZdZedd Zedd Z edd
d Z
edd d
Z d 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}\DebugFc C s8 zt t j|W S tk
r2 t t j| Y S X d S rB )_winregOpenKeyHKEY_CURRENT_USERrK HKEY_LOCAL_MACHINE)clsr r r r _open_registry s z$WindowsRegistryFinder._open_registryc C sr | j r| j}n| j}|j|dtjd d d}z&| |}t|d}W 5 Q R X W n t k
rl Y d S X |S )Nz%d.%drg )r sys_versionr )
DEBUG_BUILDREGISTRY_KEY_DEBUG REGISTRY_KEYrY r version_infor r
QueryValuerK )r r registry_keyr hkeyfilepathr r r _search_registry s z&WindowsRegistryFinder._search_registryNc C sz | |}|d krd S z t| W n tk
r8 Y d S X t D ]4\}}|t|r@tj|||||d}| S q@d S )Nr )r rJ rK r r7 r r spec_from_loader)r r r> targetr r r r r r r find_spec s
z WindowsRegistryFinder.find_specc C s" | ||}|dk r|jS dS dS )zlFind module named in the registry.
This method is deprecated. Use exec_module() instead.
Nr r r r r> r r r r find_module' s z!WindowsRegistryFinder.find_module)NN)N) r r r r r r r classmethodr r 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+ rj r rg __init__)rH r r rq )r r r
filename_base tail_namer r r r : s z_LoaderBasics.is_packagec C s dS z*Use default semantics for module creation.Nr r r r r r
create_moduleB s z_LoaderBasics.create_modulec C s8 | |j}|dkr$td|jtt||j dS )zExecute the module.Nz4cannot load module {!r} when get_code() returns None)get_coder r rY r _call_with_frames_removedexecr )r moduler r r r exec_moduleE s z_LoaderBasics.exec_modulec C s t | |S )zThis module is deprecated.)r _load_module_shimr r r r r load_moduleM s z_LoaderBasics.load_moduleN)r r r r r r r" r% r r r r r 5 s
r c @ sJ e Zd Zdd Zdd Zdd Zdd Zd d
Zd d d
dZdd Z dS ) SourceLoaderc C s t dS )zOptional method that returns the modification time (an int) for the
specified path (a str).
Raises OSError when the path cannot be handled.
N)rK r r> r r r
path_mtimeT 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 )r( r' 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_bytecodej s z SourceLoader._cache_bytecodec C s 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 r> r' r r r r* t s zSourceLoader.set_datac
C sR | |}z| |}W n0 tk
rH } ztd|d|W 5 d}~X Y nX t|S )z4Concrete implementation of InspectLoader.get_source.z'source not available through get_data()r N)r get_datarK r r )r r r> 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_inheritrv )r r compile)r r' r> r0 r r r source_to_code s zSourceLoader.source_to_codec C s" | |}d}d}d}d}d}z t|}W n tk
rD d}Y n0X z| |} W n tk
rj Y n
X t| d }z| |}
W n tk
r Y nX ||d} zt|
|| } t|
dd }
| d@ dk}|r$| d @ dk}t j
d
kr8|st j
d kr8| |}t t |}t
|
||| nt|
|| d || W n ttfk
rT Y n X td
|| t|
|||dS |dkr| |}| ||}td| tjs |dk r |dk r |r|dkrt |}t|||}
nt||t|}
z| |||
W n tk
r Y nX |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 rg neveralwayssizez
{} matches {})r r r zcode object from {})r r rt r) rK r r- r
memoryviewr check_hash_based_pycsr _RAW_MAGIC_NUMBERr r r r r r r r3 r dont_write_bytecoder r r3 r, )r r r r r r
hash_based check_sourcer str' r ru
bytes_data code_objectr r r r s
zSourceLoader.get_codeN)
r r r r( r) r, r* r/ r3 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 dd Z dd Z
dd Zdd Z ZS )
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 r> r r r r s zFileLoader.__init__c C s | j |j ko| j|jkS rB __class__r r otherr r r __eq__ s
zFileLoader.__eq__c C s t | jt | jA S rB hashr r> r r r r __hash__ s zFileLoader.__hash__c s t t| |S )zdLoad a module from a file.
This method is deprecated. Use exec_module() instead.
)superr@ r% r$ rB r r r% s
zFileLoader.load_modulec C s | j S z:Return the path to the source file as found by the finder.rD r$ r r r r s zFileLoader.get_filenamec
C sf t | ttfr:tt|}| W 5 Q R S Q R X n(t|d}| W 5 Q R S Q R X dS )z'Return the data from path as raw bytes.rN)r r& ExtensionFileLoaderr_ open_coderw readr` )r r> re r r r r- s
zFileLoader.get_datac C s | |r| S d S rB )r r r! r r r get_resource_reader s
z FileLoader.get_resource_readerc C s t t| jd |}t|dS )Nr rM )r@ rH r> r_ r` r resourcer> r r r
open_resource s zFileLoader.open_resourcec C s& | |sttt| jd |}|S Nr ) is_resourceFileNotFoundErrorr@ rH r> rS r r r
resource_path s
zFileLoader.resource_pathc C s( t |kr dS tt| jd |}t|S )NFr )r8 r@ rH r> rP r r r> r r r rW s zFileLoader.is_resourcec C s t tt| jd S rV )iterr listdirrH r> rH r r r contents& s zFileLoader.contents)r r r r r rE rI r r% r r- rR rU rY rW r]
__classcell__r r rK r r@ s
r@ 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 r6 )rJ st_mtimest_size)r r> r= r r r r) . s zSourceFileLoader.path_statsc C s t |}| j|||dS )N_mode)r r* )r r r r' rM r r r r, 3 s z SourceFileLoader._cache_bytecoderV rb c C s t |\}}g }|r4t|s4t |\}}|| qt|D ]l}t||}zt| W q< tk
rp Y q r' rc parentr r< rA r. r r r r* 8 s0
zSourceFileLoader.set_dataN)r r r r r) r, r* r r r r r_ * s r_ 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 r- r r r7 )r r r> r' r r r r r [ s
z SourcelessFileLoader.get_codec C s dS )z'Return None as there is no source code.Nr r$ r r r r/ k s z SourcelessFileLoader.get_sourceN)r r r r r r/ r r r r rh W s rh c @ s\ e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dd Z
dd Z e dd Z
dS )rN z]Loader for extension modules.
The constructor is designed to work with FileFinder.
c C s@ || _ t|s6ztt |}W n tk
r4 Y nX || _d S rB )r rU r@ r rQ rK r> rZ r r r r | s z ExtensionFileLoader.__init__c C s | j |j ko| j|jkS rB rA rC r r r rE s
zExtensionFileLoader.__eq__c C s t | jt | jA S rB rF rH r r r rI s 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 r> )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 r> rQ 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 rE s z1ExtensionFileLoader.is_package..)rH r> anyEXTENSION_SUFFIXESr$ r rm r r s z ExtensionFileLoader.is_packagec C s dS )z?Return None as an extension module cannot create a code object.Nr r$ r r r r s z ExtensionFileLoader.get_codec C s dS )z5Return None as extension modules have no source code.Nr r$ r r r r/ s z ExtensionFileLoader.get_sourcec C s | j S rL rD r$ r r r r s z ExtensionFileLoader.get_filenameN)r r r r r rE rI r r" r r r/ r r r r r r rN t s rN c @ sh e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd d
Z dd Z
dd Z dd Z dd Z
dd 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.c C s$ || _ || _t| | _|| _d S rB )_name_pathr _get_parent_path_last_parent_path _path_finderr r r> path_finderr r r r s z_NamespacePath.__init__c C s& | j d\}}}|dkr dS |dfS )z>Returns a tuple of (parent-module-name, parent-path-attr-name)rj r )r r> __path__)rr rq )r rg dotmer r r _find_parent_path_names s z&_NamespacePath._find_parent_path_namesc C s | \}}ttj| |S rB )r| r r modules)r parent_module_namepath_attr_namer r r rt s z _NamespacePath._get_parent_pathc C sP t | }|| jkrJ| | j|}|d k rD|jd krD|jrD|j| _|| _| jS rB )r rt ru rv rr r r rs )r parent_pathr r r r _recalculate s
z_NamespacePath._recalculatec C s t | S rB )r[ r rH r r r __iter__ s z_NamespacePath.__iter__c C s | | S rB r )r indexr r r __getitem__ s z_NamespacePath.__getitem__c C s || j |< d S rB )rs )r r r> r r r __setitem__ s z_NamespacePath.__setitem__c C s t | S rB )r3 r rH r r r __len__ s z_NamespacePath.__len__c C s d | jS )Nz_NamespacePath({!r}))rY rs rH r r r __repr__ s z_NamespacePath.__repr__c C s || kS rB r r itemr r r __contains__ s z_NamespacePath.__contains__c C s | j | d S rB )rs r: r r r r r: s z_NamespacePath.appendN)r r r r r r| rt r r r r r r r r: r r r r rq s
rq c @ sP e Zd Zdd Zedd Zdd Zdd Zd d
Zd d Z d
d Z
dd Z dS )_NamespaceLoaderc C s t |||| _d S rB )rq rs rw r r r r s z_NamespaceLoader.__init__c C s d |jS )zsReturn repr for the module.
The method is deprecated. The import machinery does the job itself.
z)rY r )r r! r r r module_repr s z _NamespaceLoader.module_reprc C s dS )NTr r$ r r r r s z_NamespaceLoader.is_packagec C s dS )Nr r r$ r r r r/ s z_NamespaceLoader.get_sourcec C s t dddddS )Nr zr T)r1 )r2 r$ r r r r s z_NamespaceLoader.get_codec C s dS r r r r r r r s z _NamespaceLoader.create_modulec C s d S rB r rQ r r r r" s 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 rs r# r$ r r r r% s z _NamespaceLoader.load_moduleN) r r r r r r r r/ r r r" r% r r r r r s
r c @ sv e Zd ZdZedd Zedd Zedd Zedd Zedd d Z edd
dZ
edddZ edd Z d
S )
PathFinderz>Meta path finder for sys.path and package __path__ attributes.c C s@ t tj D ],\}}|dkr(tj|= qt|dr| qdS )z}Call the invalidate_caches() method on all path entry finders
stored in sys.path_importer_caches (where implemented).Ninvalidate_caches)listr path_importer_cacheitemsr r )r r finderr r r r s
z PathFinder.invalidate_cachesc C sT t jdk r t js tdt t jD ],}z||W S tk
rL Y q"Y q"X q"dS )z.Search sys.path_hooks for a finder for 'path'.Nzsys.path_hooks is empty)r
path_hooksrl rm r r )r r> hookr r r _path_hooks% s
zPathFinder._path_hooksc C sh |dkr,z t }W n tk
r* Y dS X ztj| }W n( tk
rb | |}|tj|< Y nX |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 rQ rX r r KeyErrorr )r r> r r r r _path_importer_cache2 s
z PathFinder._path_importer_cachec C sR t |dr||\}}n||}g }|d k r r namespace_pathentryr r r r r r _get_specW s(
zPathFinder._get_specc C sd |dkrt j}| |||}|dkr(dS |jdkr\|j}|rVd|_t||| j|_|S dS n|S dS )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 r> r r r r rq )r r r> r r r r r r r w s
zPathFinder.find_specc C s | ||}|dkrdS |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.
Nr r r r r r s zPathFinder.find_modulec O s ddl m} |j||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 r s
z PathFinder.find_distributions)N)NN)N)
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|| _|p6d| _t| jsVtt | 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 rB r rk r r r rE s z&FileFinder.__init__..rj r N) r _loadersr> rU r@ r rQ _path_mtimeset _path_cache_relaxed_path_cache)r r> loader_detailsloadersr r r r r s
zFileFinder.__init__c C s
d| _ dS )z Invalidate the directory mtime.r N)r rH r r r r s z FileFinder.invalidate_cachesc C s* | |}|dkrdg fS |j|jp&g 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.
N)r r r )r r r r r r r s
zFileFinder.find_loaderc C s |||}t ||||dS )Nr )r )r r r r> smslr r r r r r s
zFileFinder._get_specNc C s d}| dd }zt| jp"t j}W n tk
rB d}Y nX || jkr\| || _t rr| j
}| }n
| j }|}||krt
| j|}| jD ]:\} }
d| } t
|| } t| r| |
|| |g| S qt|}| jD ]r\} }
zt
| j|| } W n tk
r Y dS X tjd| dd || |krt| r| |
|| d| S q|r~td | t|d}
|g|
_|
S dS )
zoTry to find a spec for the specified module.
Returns the matching spec, or None if not found.
Frj rg r r Nz trying {}) verbosityzpossible namespace for {})rq rJ r> r rQ r` rK r _fill_cacher r r r r@ r rP r rR ry r r r r )r r r is_namespace tail_moduler cache cache_module base_pathrl r
init_filename full_pathr r r r r sP
zFileFinder.find_specc
C s | j }zt|pt }W n tttfk
r: g }Y nX tj dsTt
|| _ nJt
}|D ]8}| d\}}}|rd
|| }n|}|| q^|| _ tj trdd |D | _dS )zDFill the cache of potential modules and packages for this directory.r
rj rW c S s h | ] }| qS r )r )r fnr r r r * s z)FileFinder._fill_cache..N)r> r r\ rQ rX PermissionErrorNotADirectoryErrorr r r r r r rY r addr r ) r r> r] lower_suffix_contentsr r rz rl new_namer r r r
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 | std| d | f S )z-Path hook for importlib.machinery.FileFinder.z only directories are supportedrD )rR r rD r r r r path_hook_for_FileFinder6 s z6FileFinder.path_hook..path_hook_for_FileFinderr )r r r r r r path_hook, s
zFileFinder.path_hookc C s d | jS )NzFileFinder({!r}))rY r> rH r r r r > s zFileFinder.__repr__)N)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}|sB|r$|j}n ||kr8t||}n
t||}|sTt|||d}z$|| d< || d< || d< || d< W n tk
r Y nX d S )N
__loader____spec__r __file__
__cached__)getr rh r_ r Exception)nsr pathname cpathnamer r r r r _fix_up_moduleD s"
r c C s* t tt f} ttf}ttf}| ||gS )z_Returns a list of file-based module loaders.
Each item is a tuple (loader, suffixes).
)rN _alternative_architecturesr extension_suffixesr_ r rh r{ )
extensionssourcebytecoder r r r [ s r c C s | a t jat jatjt }dD ]0}|tjkr8t |}n
tj| }t||| q ddgfdddgff}|D ]X\}}|d }|tjkrtj| } qqjzt |}W qW qj tk
r Y qjY qjX qjtdt|d| t|d | t|d
d | t|d d
d |D t d} t|d| t d}
t|d|
|dkrXt d} t|d| t|dt t
t t
|dkrtd dt
krdt_dS )zSetup the path-based importers for importlib by importing needed
built-in modules and injecting them into the global namespace.
Other components are extracted from the core bootstrap module.
)r_ rl builtinsr posixr ntr r z importlib requires posix or ntr r8 r. r _pathseps_with_colonc S s h | ]}d | qS r r r r r r r s z_setup.._thread_weakrefwinregr r z.pywz_d.pydTN)r r r r} r _builtin_from_namer r r; r rp r r r r r: r r ) _bootstrap_module self_module builtin_namebuiltin_module
os_details
builtin_osr. r8 os_module
thread_moduleweakref_module
winreg_moduler r r _setupf sL
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 -arm-linux-gnueabihf.-armeb-linux-gnueabihf.-mips64-linux-gnuabi64.-mips64el-linux-gnuabi64.-powerpc-linux-gnu.-powerpc-linux-gnuspe.-powerpc64-linux-gnu.-powerpc64le-linux-gnu.-arm-linux-gnueabi.-armeb-linux-gnueabi.-mips64-linux-gnu.-mips64el-linux-gnu.-ppc-linux-gnu.-ppc-linux-gnuspe.-ppc64-linux-gnu.-ppc64le-linux-gnu.)r r r r r r r r r r r r r r r r c C sF | D ]<}t D ].\}}||kr| ||| | S qq| S )zAdd a suffix with an alternative architecture name
to the list of suffixes so an extension built with
the default (upstream) setting is loadable with our Pythons
) _ARCH_MAPr r: rT )r rl original alternativer r r r s r )rV )N)NNN)r r )T)N)N)Rr r r_ r rl r r _MS_WINDOWSr r r r r. r8 r r6 r; r r %_CASE_INSENSITIVE_PLATFORMS_BYTES_KEYr r r# r( r) r@ rH rJ rO rP rR rU rf type__code__r r! r r r% r9 r~ rz 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& r@ r_ rh rp rN rq r r r r r r r r r r r r r s
G( !
D@ H-:?*
A