e f!S @ s d Z d Z d d Z d d Z d d Z d
d Z d d
Z d d Z d d Z d d Z d d Z
d d d Z d d Z d d Z
e e j Z Gd d d Z i Z i Z Gd d d e Z Gd! d" d" Z Gd# d$ d$ Z Gd% d& d& Z d' d( Z d) d* Z d+ d, Z d- j d. d/ d0 Z e j e d/ Z d1 Z! d2 g Z" d3 g Z# d4 g Z$ d5 d6 d7 Z% d8 d9 Z& d: d; Z' d< d= Z( d> d? d@ dA Z) dB dC Z* dD dE Z+ dF dG Z, dH dI Z- dJ dK Z. d5 d5 d5 dL dM Z/ d5 d5 d5 dN dO Z0 dP dP dQ dR Z1 dS dT Z2 dU dV Z3 GdW dX dX Z4 GdY dZ dZ Z5 d[ d5 d\ d5 d] d^ Z6 e7 Z8 d5 d_ d5 d` e8 da db Z9 d5 d5 dc dd Z: Gde df df Z; d5 dg dh Z< Gdi dj dj Z= Gdk dl dl Z> Gdm dn dn Z? Gdo dp dp Z@ Gdq dr dr e@ ZA Gds dt dt ZB Gdu dv dv eB eA ZC Gdw dx dx eB e@ ZD g ZE Gdy dz dz ZF Gd{ d| d| ZG Gd} d~ d~ ZH Gd d d ZI Gd d d ZJ Gd d d ZK d d ZL d d ZM d5 d d ZN d d ZO d ZP eP d ZQ d d ZR d d ZS d5 dP d d ZT d d ZU d d ZV d d ZW d5 d5 f dP d d ZX d d ZY d d ZZ d d Z[ d5 S)aS Core implementation of 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.
wincygwindarwinc C s1 t j j t r! d d } n d d } | S)Nc S s
d t j k S)z5True if filenames must be checked case-insensitively.s PYTHONCASEOK)_osenviron r r 9/opt/alt/python34/lib64/python3.4/importlib/_bootstrap.py _relax_case s z%_make_relax_case.._relax_casec S s d S)z5True if filenames must be checked case-insensitively.Fr r r r r r " s )sysplatform
startswith_CASE_INSENSITIVE_PLATFORMS)r r r r _make_relax_case s r
c C s t | d @j d d S)z*Convert a 32-bit integer to little-endian.l little)intto_bytes)xr r r _w_long( s r c C s t j | d S)z/Convert 4 bytes in little-endian to an integer.r )r
from_bytes) int_bytesr r r _r_long- s r c G s t j d d | D S)z Replacement for os.path.join().c S s% g | ] } | r | j t q Sr )rstrippath_separators).0partr r r
4 s z _path_join..)path_sepjoin)
path_partsr r r
_path_join2 s r c C s t t d k r4 | j t \ } } } | | f SxE t | D]7 } | t k rA | j | d d \ } } | | f SqA Wd | f S)z Replacement for os.path.split(). maxsplit )lenr
rpartitionr reversedrsplit)pathfront_tailr r r r _path_split8 s
r+ c C s
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 stat)r' r r r
_path_statD s r- c C s: y t | } Wn t k
r( d SYn X| j d @| k S)z1Test whether the path is the specified mode type.Fi )r- OSErrorst_mode)r' mode stat_infor r r _path_is_mode_typeN s
r2 c C s
t | d S)z Replacement for os.path.isfile.i )r2 )r' r r r _path_isfileW s r3 c C s" | s t j } n t | d S)z Replacement for os.path.isdir.i @ )r getcwdr2 )r' r r r _path_isdir\ s r5 i c C s d j | t | } t j | t j t j Bt j B| d @ } y< t j | d } | j | Wd QXt j
| | Wn; t k
r y t j | Wn t k
r Yn X Yn Xd S)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.z{}.{}i wbN)
formatidr openO_EXCLO_CREATO_WRONLY_ioFileIOwritereplacer. unlink)r' datar0 path_tmpfdfiler r r
_write_atomicc s !
rF c C s_ xE d d d d g D]1 } t | | r t | | t | | q q W| j j | j d S)z/Simple substitute for functools.update_wrapper.
__module____name__ __qualname____doc__N)hasattrsetattrgetattr__dict__update)newoldr@ r r r _wrapy s rR c C s t t | S)N)typer )namer r r _new_module s rU c @ s: e Z d Z d Z d d Z d d Z d d Z d S)
_ManageReloadz?Manages the possible clean-up of sys.modules for load_module().c C s
| | _ d S)N)_name)selfrT r r r __init__ s z_ManageReload.__init__c C s | j t j k | _ d S)N)rW r modules
_is_reload)rX r r r __enter__ s z_ManageReload.__enter__c G sP t d d | D rL | j rL y t j | j =WqL t k
rH YqL Xn d S)Nc s s | ] } | d k Vq d S)Nr )r argr r r s z)_ManageReload.__exit__..)anyr[ r rZ rW KeyError)rX argsr r r __exit__ s
#
z_ManageReload.__exit__N)rH rG rI rJ rY r\ rb r r r r rV s rV c @ s e Z d Z d S)_DeadlockErrorN)rH rG rI r r r r rc s rc c @ sR e Z d Z d Z d d Z d d Z d d Z d d Z d
d Z d S)
_ModuleLockzA recursive lock implementation which is able to detect deadlocks
(e.g. thread 1 trying to take locks A then B, and thread 2 trying to
take locks B then A).
c C sF t j | _ t j | _ | | _ d | _ d | _ d | _ d S)N )_thread
allocate_locklockwakeuprT ownercountwaiters)rX rT r r r rY s z_ModuleLock.__init__c C sX t j } | j } x< t j | } | d k r7 d S| j } | | k r d Sq Wd S)NFT)rf get_identrj _blocking_onget)rX metidrh r r r has_deadlock s z_ModuleLock.has_deadlockc C s t j } | t | .cb)r r` rf rx rd _weakrefref)rT rh r r )rT r r{ s
r{ c C sG t | } t j y | j Wn t k
r8 Yn X| j d S)a Release the global import lock, and acquires then release the
module lock for a given module name.
This is used to ensure a module is completely initialized, in the
event it is being imported by another thread.
Should only be called with the import lock taken.N)r{ r| r} rs rc rt )rT rh r r r _lock_unlock_module% s
r c O s
| | | S)a. remove_importlib_frames in import.c will always remove sequences
of importlib frames that end with a call to this function
Use it instead of a normal call in places where including the importlib
frames introduces unwanted noise into the traceback (e.g. when executing
module code)
r )fra kwdsr r r _call_with_frames_removed9 s r i r s
__pycache__z.pyz.pycz.pyoNc C s | d k r t j j n | } | r. t } n t } t | \ } } | j d \ } } } t j j } | d k r t d n d j
| r | n | | | | d g }
t | t |
S)a Given the path to a .py file, return the path to its .pyc/.pyo file.
The .py file does not need to exist; this simply returns the path to the
.pyc/.pyo file calculated as if the .py file were imported. The extension
will be .pyc unless sys.flags.optimize is non-zero, then it will be .pyo.
If debug_override is not None, then it must be a boolean and is used in
place of sys.flags.optimize.
If sys.implementation.cache_tag is None then NotImplementedError is raised.
N.z$sys.implementation.cache_tag is Noner" re )
r flagsoptimizeDEBUG_BYTECODE_SUFFIXESOPTIMIZED_BYTECODE_SUFFIXESr+ r$ implementation cache_tagNotImplementedErrorr r _PYCACHE) r' debug_overridedebugsuffixesheadr* basesepresttagfilenamer r r cache_from_source s
+r c C s t j j d k r! t d n t | \ } } t | \ } } | t k rl t d j t | n | j d d k r t d j | n | j d d } t
| | t d S)ay Given the path to a .pyc./.pyo file, return the path to its .py file.
The .pyc/.pyo file does not need to exist; this simply returns the path to
the .py file calculated to correspond to the .pyc/.pyo file. If path does
not conform to PEP 3147 format, ValueError will be raised. If
sys.implementation.cache_tag is None then NotImplementedError is raised.
Nz$sys.implementation.cache_tag is Nonez%{} not bottom-level directory in {!r}r r z expected only 2 dots in {!r}re ) r r r r r+ r
ValueErrorr7 rk partitionr SOURCE_SUFFIXES)r' r pycache_filenamepycache
base_filenamer r r source_from_cache s r c C s t | d k r d S| j d \ } } } | sQ | j d d d k rU | Sy t | } Wn( t t f k
r | d d } Yn Xt | 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.
re Nr r pyr )r# r$ lowerr r r r3 )
bytecode_pathr r) extension source_pathr r r _get_sourcefile s #r c C s< y t | j } Wn t k
r- d } Yn X| d O} | S)z3Calculate the mode permissions for a bytecode file.i )r- r/ r. )r' r0 r r r
_calc_mode s
r verbosityr c G sQ t j j | k rM | j d s. d | } n t | j | d t j n d S)z=Print the message to stderr if -v/PYTHONVERBOSE is turned on.#import z# rE N)r r )r r verboser printr7 stderr)messager ra r r r _verbose_message s
r c s& d f d d } t | | 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 sS | d k r | j } n( | j | k r@ t d | d | n | | | | S)Nzloader cannot handle %srT )rT ImportError)rX rT ra r~ )methodr r _check_name_wrapper s
z(_check_name.._check_name_wrapper)rR )r r r )r r _check_name s
r c s# f d d } t | | S)z1Decorator to verify the named module is built-in.c s: | t j k r- t d j | d | n | | S)Nz {!r} is not a built-in modulerT )r builtin_module_namesr r7 )rX fullname)fxnr r _requires_builtin_wrapper" s z4_requires_builtin.._requires_builtin_wrapper)rR )r r r )r r _requires_builtin s
r c s# f d d } t | | S)z/Decorator to verify the named module is frozen.c s: t j | s- t d j | d | n | | S)Nz{!r} is not a frozen modulerT )r| is_frozenr r7 )rX r )r r r _requires_frozen_wrapper- s z2_requires_frozen.._requires_frozen_wrapper)rR )r r r )r r _requires_frozen+ s
r c C sW | j | \ } } | d k rS t | rS d } t j | j | d t n | 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__re ) find_loaderr# _warningswarnr7
ImportWarning)rX r loaderportionsmsgr r r _find_module_shim6 s
r c C s] t | | } t | } | t j k rO t j | } | j | t j | S| j Sd S)zLoad the specified module into sys.modules and return it.
This method is deprecated. Use loader.exec_module instead.
N)spec_from_loader _SpecMethodsr rZ execload)rX r specmethodsmoduler r r _load_module_shimG s
r c C s i } | d k r | | d | | d r' r z bad magic number in {!r}: {!r}z{}z+reached EOF while reading timestamp in {!r}z0reached EOF while reading size of source in {!r}mtimezbytecode is stale for {!r}sizel ) MAGIC_NUMBERr7 r r r# EOFErrorr r` r ) rB source_statsrT r' exc_detailsmagic
raw_timestampraw_sizer source_mtime source_sizer r r _validate_bytecode_headerW sL
r c C ss t j | } t | t rN t d | | d k rJ t j | | n | St d j | d | d | d S)zzz)
rM rK r Exception__spec__AttributeErrorr rH __file__r7 )r r r rT r r r r _module_repr s.
r c @ s4 e Z d Z d d Z d d Z d d Z d S)_installed_safelyc C s | | _ | j | _ d S)N)_moduler _spec)rX r r r r rY s z_installed_safely.__init__c C s& d | j _ | j t j | j j .zimport {!r} # {!r}F) r r_ r rZ rT r` r r r )rX ra r r r r rb s
z_installed_safely.__exit__N)rH rG rI rY r\ rb r r r r r s r c @ s e Z d Z d Z d d d d d d d d Z d d Z d
d Z e d d
Z e j d d
Z e d d Z
e d d Z e j d d Z d S)
ModuleSpeca The specification for a module, used for loading.
A module's spec is the source for information about the module. For
data associated with the module, including source, use the spec's
loader.
`name` is the absolute name of the module. `loader` is the loader
to use when loading the module. `parent` is the name of the
package the module is in. The parent is derived from the name.
`is_package` determines if the module is considered a package or
not. On modules this is reflected by the `__path__` attribute.
`origin` is the specific location used by the loader from which to
load the module, if that information is available. When filename is
set, origin will match.
`has_location` indicates that a spec's "origin" reflects a location.
When this is True, `__file__` attribute of the module is set.
`cached` is the location of the cached bytecode file, if any. It
corresponds to the `__cached__` attribute.
`submodule_search_locations` is the sequence of path entries to
search when importing submodules. If set, is_package should be
True--and False otherwise.
Packages are simply modules that (may) have submodules. If a spec
has a non-None value in `submodule_search_locations`, the import
system will consider modules loaded from the spec as packages.
Only finders (see importlib.abc.MetaPathFinder and
importlib.abc.PathEntryFinder) should modify ModuleSpec instances.
originN loader_state
is_packagec C sO | | _ | | _ | | _ | | _ | r0 g n d | _ d | _ d | _ d S)NF)rT r r r submodule_search_locations
_set_fileattr_cached)rX rT r r r r r r r rY s zModuleSpec.__init__c C s d j | j d j | j g } | j d k rO | j d j | j n | j d k rz | j d j | j n d j | j j d j | S)Nz name={!r}z loader={!r}z origin={!r}z submodule_search_locations={}z{}({})z, ) r7 rT r r appendr __class__rH r )rX ra r r r rw " s zModuleSpec.__repr__c C s | j } yk | j | j k or | j | j k or | j | j k or | | j k or | j | j k or | j | j k SWn t k
r d SYn Xd S)NF)r rT r r cached has_locationr )rX othersmslr r r __eq__, s
zModuleSpec.__eq__c C s | j d k r | j d k r | j r | j } | j t t rp y t | | _ Wq t k
rl Yq Xq | j t t r | | _ q q n | j S)N) r r r endswithtupler r r BYTECODE_SUFFIXES)rX r r r r r 8 s
zModuleSpec.cachedc C s
| | _ d S)N)r )rX r r r r r F s c C s. | j d k r# | j j d d S| j Sd S)z The name of the module's parent.Nr re )r rT r$ )rX r r r parentJ s zModuleSpec.parentc C s | j S)N)r )rX r r r r R s zModuleSpec.has_locationc C s t | | _ d S)N)boolr )rX valuer r r r V s ) rH rG rI rJ rY rw r propertyr setterr r r r r r r s #
r r r c C s t | d rS | d k r+ t | d | S| r7 g n d } t | d | d | S| d k r t | d r y | j | } Wq t k
r d } Yq Xq d } n t | | d | d | S)z5Return a module spec based on various loader methods. get_filenameNr r r Fr )rK spec_from_file_locationr r r )rT r r r searchr r r r [ s
r r r c C sn | d k rO d } t | d rO y | j | } WqL t k
rH YqL XqO n t | | d | } d | _ | d k r xO t D]= \ } } | j t | r | | | } | | _ Pq q Wd Sn | t k r&t | d r/y | j
| } Wn t k
r
Yq#X| r#g | _ q#q/n | | _ | j g k rj| rjt | d } | j j
| qjn | 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 r r Tr re )rK r r r r _get_supported_file_loadersr r r _POPULATEr r r+ r ) rT locationr r r loader_classr r dirnamer r r r t s<
r c 5 C s| y
| j } Wn t k
r! Yn X| d k r2 | S| j } | d k rl y
| j } Wql t k
rh Yql Xn y
| j } Wn t k
r d } Yn X| d k r | d k r y
| j } Wq t k
r d } Yq Xq | } n y
| j } Wn t k
rd } Yn Xy t | j } Wn t k
r5d } Yn Xt | | d | } | d k r]d n d | _
| | _ | | _ | S)Nr FT)
r r rH r r _ORIGIN
__cached__list__path__r r r r )r r r r rT r r r r r r _spec_from_module sH
r$ c @ s e Z d Z d Z d d Z d d Z d d d d d
d Z d d
Z d d Z d d Z d d Z
d d Z d d Z d S)r zMConvenience wrapper around spec objects to provide spec-specific
methods.c C s
| | _ d S)N)r )rX r r r r rY s z_SpecMethods.__init__c C s | j } | j d k r d n | j } | j d k rh | j d k rR d j | Sd j | | j Sn2 | j r d j | | j Sd j | j | j Sd S)z&Return the repr to use for the module.Nr z
zzz)r rT r r r7 r )rX r rT r r r r s
z_SpecMethods.module_repr _overrideF _force_nameTc ; C sK | j } | s- | s- t | d d d k rU y | j | _ WqU t k
rQ YqU Xn | ss t | d d d k r | j } | d k r | j d k r t j t } | j | _ q n y
| | _
Wq t k
r Yq Xn | s t | d d d k r#y | j | _ Wq#t k
r Yq#Xn y
| | _
Wn t k
rDYn X| sct | d d d k r| j d k ry | j | _ Wqt k
rYqXqn | j rG| st | d d d k ry | j | _ Wqt k
rYqXn | s
t | d d d k rG| j d k rDy | j | _ WqAt k
r=YqAXqDqGn d S)a Set the module's attributes.
All missing import-related module attributes will be set. Here
is how the spec attributes map onto the module:
spec.name -> module.__name__
spec.loader -> module.__loader__
spec.parent -> module.__package__
spec -> module.__spec__
Optional:
spec.origin -> module.__file__ (if spec.set_fileattr is true)
spec.cached -> module.__cached__ (if __file__ also set)
spec.submodule_search_locations -> module.__path__ (if set)
rH Nr __package__r# r r! )r rM rT rH r r r _NamespaceLoader__new___pathr r r' r r# r r r r r! )rX r r% r& r r r r r init_module_attrs sX
z _SpecMethods.init_module_attrsc C se | j } t | j d r0 | j j | } n d } | d k rT t | j } n | j | | S)zReturn a new module to be loaded.
The import-related module attributes are also set with the
appropriate values from the spec.
create_moduleN)r rK r r, rU rT r+ )rX r r r r r createK s
z_SpecMethods.createc C s | j j j | d S)zDo everything necessary to execute the module.
The namespace of `module` is used as the target of execution.
This method uses the loader's `exec_module()` method.
N)r r exec_module)rX r r r r _execb s z_SpecMethods._execc C s | j j } t j t | t j j | | k r_ d j | } t | d | n | j j
d k r | j j d k r t d d | j j n | j | d d | S| j | d d t
| j j
d s | j j
j | n
| j | Wd QXt j | S)z3Execute the spec in an existing module's namespace.z module {!r} not in sys.modulesrT Nzmissing loaderr% Tr. )r rT r| acquire_lockry r rZ ro r7 r r r r+ rK load_moduler/ )rX r rT r r r r r l s
z_SpecMethods.execc C s | j } | j j | j t j | j } t | d d d k rl y | j | _ Wql t k
rh Yql Xn t | d d d k r y; | j | _
t | d s | j j d d | _
n Wq t k
r Yq Xn t | d d d k ry
| | _
Wqt k
rYqXn | S)Nr r' r# r re r )r r r1 rT r rZ rM r r rH r' rK r$ r )rX r r r r r _load_backward_compatible s*
z&_SpecMethods._load_backward_compatiblec C s | j j d k r4 t | j j d s4 | j Sn | j } t | T | j j d k r | j j d k r t d d | j j q n
| j | Wd QXt
j | j j S)Nr. zmissing loaderrT ) r r rK r2 r- r r r rT r/ r rZ )rX r r r r _load_unlocked s
z_SpecMethods._load_unlockedc C s1 t j t | j j | j SWd QXd S)zReturn a new module object, loaded by the spec's loader.
The module is not added to its parent.
If a module is already in sys.modules, that existing module gets
clobbered.
N)r| r0 ry r rT r3 )rX r r r r s
z_SpecMethods.loadN)
rH rG rI rJ rY r r+ r- r/ r r2 r3 r r r r r r s P
r c C s | j d } | j d } | sf | r6 | j } qf | | k rT t | | } qf t | | } n | s t | | d | } n y, | | d <| | d <| | d <| | d )r7 rH )r r r r r s zBuiltinImporter.module_reprNc C s: | d k r d St j | r2 t | | d d Sd Sd S)Nr zbuilt-in)r|
is_builtinr )clsr r' targetr r r find_spec s
zBuiltinImporter.find_specc C s) | j | | } | d k r% | j Sd S)zFind the built-in module.
If 'path' is ever specified then the search is considered a failure.
This method is deprecated. Use find_spec() instead.
N)r> r )r< r r' r r r r find_module s zBuiltinImporter.find_modulec
C s; t | t t j | } Wd QX| | _ d | _ | S)zLoad a built-in module.Nr" )rV r r| init_builtinr r' )r< r r r r r r1 s
zBuiltinImporter.load_modulec C s d S)z9Return None as built-in modules do not have code objects.Nr )r< r r r r get_code s zBuiltinImporter.get_codec C s d S)z8Return None as built-in modules do not have source code.Nr )r< r r r r
get_source s zBuiltinImporter.get_sourcec C s d S)z4Return False as built-in modules are never packages.Fr )r< r r r r r s zBuiltinImporter.is_package)rH rG rI rJ staticmethodr classmethodr> r? r r1 rA rB r r r r r r: s r: c @ s e Z d Z d Z e d d Z e d d d d Z e d d d Z e d d
Z e d d Z
e e d
d Z e e d d Z
e e d d Z d S)FrozenImporterzMeta path import for frozen modules.
All methods are either class or static methods to avoid the need to
instantiate the class.
c C s d j | j S)zsReturn repr for the module.
The method is deprecated. The import machinery does the job itself.
z)r7 rH )mr r r r / s zFrozenImporter.module_reprNc C s* t j | r" t | | d d Sd Sd S)Nr frozen)r| r r )r< r r' r= r r r r> 8 s zFrozenImporter.find_specc C s t j | r | Sd S)z]Find a frozen module.
This method is deprecated. Use find_spec() instead.
N)r| r )r< r r' r r r r? ? s zFrozenImporter.find_modulec C s_ | j j } t j | s9 t d j | d | n t t j | } t | | j d S)Nz{!r} is not a frozen modulerT )
r rT r| r r r7 r get_frozen_objectr rN )r rT r r r r r. H s zFrozenImporter.exec_modulec C s
t | | S)z_Load a frozen module.
This method is deprecated. Use exec_module() instead.
)r )r< r r r r r1 Q s zFrozenImporter.load_modulec C s
t j | S)z-Return the code object for the frozen module.)r| rH )r< r r r r rA Z s zFrozenImporter.get_codec C s d S)z6Return None as frozen modules do not have source code.Nr )r< r r r r rB ` s zFrozenImporter.get_sourcec C s
t j | S)z.Return True if the frozen module is a package.)r| is_frozen_package)r< r r r r r f s zFrozenImporter.is_package)rH rG rI rJ rC r rD r> r? r. r1 r rA rB r r r r r rE & s rE c @ sy e Z d Z d Z d Z d Z d Z e d d Z e d d Z e d d d
d Z
e d d 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 sC y t j t j | SWn% t k
r> t j t j | SYn Xd S)N)_winregOpenKeyHKEY_CURRENT_USERr. HKEY_LOCAL_MACHINE)r< keyr r r _open_registryy s
z$WindowsRegistryFinder._open_registryc C s | j r | j } n | j } | j d | d t j d d } y. | j | } t j | d } Wd QXWn t k
r d SYn X| S)Nr sys_versionr r" )
DEBUG_BUILDREGISTRY_KEY_DEBUG REGISTRY_KEYr7 r versionrP rK
QueryValuer. )r< r registry_keyrO hkeyfilepathr r r _search_registry s
z&WindowsRegistryFinder._search_registryNc C s | j | } | d k r d Sy t | Wn t k
rE d SYn XxN t D]C \ } } | j t | rP t | | | | d | } | SqP Wd S)Nr )rZ r- r. r r r r )r< r r' r= rY r r r r r r r> s
z WindowsRegistryFinder.find_specc C s- | j | | } | d k r% | j Sd Sd S)zlFind module named in the registry.
This method is deprecated. Use exec_module() instead.
N)r> r )r< r r' r r r r r? s z!WindowsRegistryFinder.find_module) rH rG rI rJ rT rS rR rD rP rZ r> r? r r r r rJ m s rJ c @ s4 e Z d Z d Z d d Z d d Z e Z d S)
_LoaderBasicszSBase class of common code needed by both SourceLoader and
SourcelessFileLoader.c C sX t | j | d } | j d d d } | j d d } | d k oW | d k S)zConcrete implementation of InspectLoader.is_package by checking if
the path returned by get_filename has a filename of '__init__.py'.r r re r rY )r+ r r& r$ )rX r r
filename_base tail_namer r r r s z_LoaderBasics.is_packagec C sP | j | j } | d k r9 t d j | j n t t | | j d S)zExecute the module.Nz4cannot load module {!r} when get_code() returns None)rA rH r r7 r r rN )rX r r r r r r. s
z_LoaderBasics.exec_moduleN)rH rG rI rJ r r. r r1 r r r r r[ s r[ c @ sj e Z d Z d d Z d d Z d d Z d d Z d d
Z d d d
d Z d d Z d S) SourceLoaderc C s
t d S)zOptional method that returns the modification time (an int) for the
specified path, where path is a str.
Raises IOError when the path cannot be handled.
N)IOError)rX r' r r r
path_mtime s zSourceLoader.path_mtimec C s i | j | d 6S)a Optional method returning a metadata dict for the specified path
to by the path (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 IOError when the path cannot be handled.
r )r` )rX r' r r r
path_stats s zSourceLoader.path_statsc C s | j | | 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)rX r
cache_pathrB r r r _cache_bytecode s z SourceLoader._cache_bytecodec C s d S)zOptional method which writes data (bytes) to a file path (a str).
Implementing this method allows for the writing of bytecode files.
Nr )rX r' rB r r r rb s zSourceLoader.set_datac C si | j | } y | j | } Wn: t k
r^ } z t d d | | WYd d } ~ Xn Xt | S)z4Concrete implementation of InspectLoader.get_source.z'source not available through get_data()rT N)r get_datar. r r )rX r r' r excr r r rB s zSourceLoader.get_source _optimizer c C s t t | | d d d d | S)zReturn the code object compiled from source.
The 'data' argument can be any object type that compile() supports.
r dont_inheritTr )r compile)rX rB r' rg r r r source_to_code s zSourceLoader.source_to_codec
+ C s | j | } d } y t | } Wn t k
r? d } Yn Xy | j | } Wn t k
rg Yn Xt | d } y | j | } Wn t k
r Ynj Xy" t | d | d | d | } Wn t t
f k
r Yn- Xt d | | t | d | d | d | S| j | } | j
| | } t d | t j r| d k r| d k rt | | t | } y$ | j | | | t d
| Wqt k
rYqXn | 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.
Nr r rT r' z
{} matches {}r r zcode object from {}z
wrote {!r})r r r ra r_ r re r. r r r r r rj r dont_write_bytecoder r# rd )
rX r r r r strB
bytes_datar code_objectr r r rA sN
zSourceLoader.get_codeNr )
rH rG rI r` ra rd rb rB rj rA r r r r r^ s
r^ c sp e Z d Z d Z d d Z d d Z d d Z e f d d Z e d
d Z d d
Z
S)
FileLoaderzgBase file loader class which implements the loader protocol methods that
require file system usage.c C s | | _ | | _ d S)zKCache the module name and the path to the file found by the
finder.N)rT r' )rX r r' r r r rY 7 s zFileLoader.__init__c C s" | j | j k o! | j | j k S)N)r
rN )rX r
r r r r = s zFileLoader.__eq__c C s t | j t | j AS)N)hashrT r' )rX r r r __hash__A s zFileLoader.__hash__c s t t | j | S)zdLoad a module from a file.
This method is deprecated. Use exec_module() instead.
)superro r1 )rX r )r
r r r1 D s
zFileLoader.load_modulec C s | j S)z:Return the path to the source file as found by the finder.)r' )rX r r r r r P s zFileLoader.get_filenamec C s) t j | d } | j SWd QXd S)z'Return the data from path as raw bytes.rN)r= r> read)rX r' rE r r r re U s zFileLoader.get_data) rH rG rI rJ rY r rq r r1 r re r r )r
r ro 2 s ro c @ s@ e Z d Z d Z d d Z d d Z d d d d Z d
S) r5 z>Concrete implementation of SourceLoader using the file system.c C s$ t | } i | j d 6| j d 6S)z!Return the metadata for the path.r r )r- st_mtimest_size)rX r' rl r r r ra _ s zSourceFileLoader.path_statsc C s" t | } | j | | d | S)N_mode)r rb )rX r r rB r0 r r r rd d s z SourceFileLoader._cache_bytecoderw i c C s5 t | \ } } g } x6 | rP t | rP t | \ } } | j | q Wx t | D]v } t | | } y t j | Wq^ t k
r w^ Yq^ t k
r } z t d | | d SWYd d } ~ Xq^ Xq^ Wy! t
| | | t d | Wn5 t k
r0} z t d | | WYd d } ~ Xn Xd S)zWrite bytes data to a file.zcould not create {!r}: {!r}Nz created {!r}) r+ r5 r r% r r mkdirFileExistsErrorr. r rF ) rX r' rB rw r r r r rf r r r rb i s&
zSourceFileLoader.set_dataN)rH rG rI rJ ra rd rb r r r r r5 [ s r5 c @ s. e Z d Z d Z d d Z d d Z d S)r4 z-Loader which handles sourceless file imports.c C sL | j | } | j | } t | d | d | } t | d | d | S)NrT r' r )r re r r )rX r r' rB rm r r r rA s z SourcelessFileLoader.get_codec C s d S)z'Return None as there is no source code.Nr )rX r r r r rB s z SourcelessFileLoader.get_sourceN)rH rG rI rJ rA rB r r r r r4 s r4 c @ s e Z d Z d Z d d Z d d Z d d Z e d d Z d
d Z d d
Z
d d Z e d d Z d S)ExtensionFileLoaderz]Loader for extension modules.
The constructor is designed to work with FileFinder.
c C s | | _ | | _ d S)N)rT r' )rX rT r' r r r rY s z ExtensionFileLoader.__init__c C s" | j | j k o! | j | j k S)N)r
rN )rX r
r r r r s zExtensionFileLoader.__eq__c C s t | j t | j AS)N)rp rT r' )rX r r r rq s z ExtensionFileLoader.__hash__c C s t | t t j | | j } Wd QXt d | j | j | } | r| t | d r| t | j d g | _ n | | _
| j | _ | s | j j
d d | _ n | S)zLoad an extension module.Nz!extension module loaded from {!r}r# re r )rV r r| load_dynamicr' r r rK r+ r# r rH r' r$ )rX r r r r r r r1 s
z ExtensionFileLoader.load_modulec s0 t | j d t f d d t D S)z1Return True if the extension module is a package.r c 3 s | ] } d | k Vq d S)rY Nr )r suffix) file_namer r r^ s z1ExtensionFileLoader.is_package..)r+ r' r_ EXTENSION_SUFFIXES)rX r r )r} r r s z ExtensionFileLoader.is_packagec C s d S)z?Return None as an extension module cannot create a code object.Nr )rX r r r r rA s z ExtensionFileLoader.get_codec C s d S)z5Return None as extension modules have no source code.Nr )rX r r r r rB s z ExtensionFileLoader.get_sourcec C s | j S)z:Return the path to the source file as found by the finder.)r' )rX r r r r r s z ExtensionFileLoader.get_filenameN)
rH rG rI rJ rY r rq r r1 r rA rB r r r r r rz s rz c @ s e Z d Z d Z d d Z d d Z d d Z d d Z d
d Z d d
Z d d Z
d d Z d d Z d S)_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 s4 | | _ | | _ t | j | _ | | _ d S)N)rW r* r _get_parent_path_last_parent_path _path_finder)rX rT r' path_finderr r r rY s z_NamespacePath.__init__c C s5 | j j d \ } } } | d k r+ d S| d f S)z>Returns a tuple of (parent-module-name, parent-path-attr-name)r r" r r' r# )zsyszpath)rW r$ )rX r dotrp r r r _find_parent_path_names s z&_NamespacePath._find_parent_path_namesc C s& | j \ } } t t j | | S)N)r rM r rZ )rX parent_module_namepath_attr_namer r r r s z _NamespacePath._get_parent_pathc C s t | j } | | j k rx | j | j | } | d k rl | j d k rl | j rl | j | _ ql n | | _ n | j S)N)r r r r rW r r r* )rX parent_pathr r r r _recalculate s z_NamespacePath._recalculatec C s t | j S)N)iterr )rX r r r __iter__ s z_NamespacePath.__iter__c C s t | j S)N)r# r )rX r r r __len__ s z_NamespacePath.__len__c C s d j | j S)Nz_NamespacePath({!r}))r7 r* )rX r r r rw s z_NamespacePath.__repr__c C s | | j k S)N)r )rX itemr r r __contains__ s z_NamespacePath.__contains__c C s | j j | d S)N)r* r )rX r r r r r s z_NamespacePath.appendN)
rH rG rI rJ rY r r r r r rw r r r r r r r s
r c @ sj e Z d Z d d Z e d d Z d d Z d d Z d d
Z d d Z d
d Z
d S)r( c C s t | | | | _ d S)N)r r* )rX rT r' r r r r rY s z_NamespaceLoader.__init__c C s d j | j S)zsReturn repr for the module.
The method is deprecated. The import machinery does the job itself.
z)r7 rH )r< r r r r r s z _NamespaceLoader.module_reprc C s d S)NTr )rX r r r r r s z_NamespaceLoader.is_packagec C s d S)Nr" r )rX r r r r rB s z_NamespaceLoader.get_sourcec C s t d d d d d S)Nr" zr rh T)ri )rX r r r r rA s z_NamespaceLoader.get_codec C s d S)Nr )rX r 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* r )rX r r r r r1 $ s z _NamespaceLoader.load_moduleN) rH rG rI rY rD r r rB rA r. r1 r r r r r( s r( c @ s e Z d Z d Z e d d Z e d d Z e d d Z e d d Z e d
d d Z e d
d
d
d Z
e d
d d Z d
S)
PathFinderz>Meta path finder for sys.path and package __path__ attributes.c C s: x3 t j j D]" } t | d r | j q q Wd S)z}Call the invalidate_caches() method on all path entry finders
stored in sys.path_importer_caches (where implemented).invalidate_cachesN)r path_importer_cachevaluesrK r )r< finderr r r r 5 s z PathFinder.invalidate_cachesc C s^ t j s t j d t n x; t j D], } y | | SWq& t k
rQ w& Yq& Xq& Wd Sd S)zqSearch sequence of hooks for a finder for 'path'.
If 'hooks' is false then use sys.path_hooks.
zsys.path_hooks is emptyN)r
path_hooksr r r r )r< r' hookr r r _path_hooks= s
zPathFinder._path_hooksc C sa | d k r t j } n y t j | } Wn. t k
r\ | j | } | t j | zspec missing loader) r strbytesr rK r> r r r r r r ) r< r r' r= namespace_pathentryr r r r r r _get_specn s(
zPathFinder._get_specc C s | d k r t j } n | j | | | } | d k r= d S| j d k r | j } | r d | _ t | | | j | _ | Sd Sn | Sd S)zbfind the module on sys.path or 'path' based on sys.path_hooks and
sys.path_importer_cache.N namespace)r r' r r r r r )r< r r' r= r r r r r r> s zPathFinder.find_specc C s) | j | | } | d k r" d S| 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.
N)r> r )r< r r' r r r r r? s zPathFinder.find_module) rH rG rI rJ rD r r r r r r> r? r r r r r 1 s r c @ s e Z d Z d Z d d Z d d Z e Z d d Z d d Z d
d d Z
d
d Z e d d Z
d d Z d
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 sz g } x4 | D], \ } | j f d d | D q
W| | _ | pO d | _ d | _ t | _ t | _ d S)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 | ] } | f Vq d S)Nr )r r| )r r r r^ s z&FileFinder.__init__..r r Nr )r _loadersr' _path_mtimeset _path_cache_relaxed_path_cache)rX r' loader_detailsloadersr r )r r rY s $ zFileFinder.__init__c C s
d | _ d S)z Invalidate the directory mtime.r Nr )r )rX r r r r s z FileFinder.invalidate_cachesc C s; | j | } | d k r% d g f S| j | j p7 g f S)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 )rX r r r r r r s
zFileFinder.find_loaderc C s( | | | } t | | d | d | S)Nr r )r )rX r r r' r r= r r r r r s zFileFinder._get_specNc C s d } | j d d } y" t | j p1 t j j } Wn t k
rU d
} Yn X| | j k r{ | j | | _ n t r | j
} | j } n | j } | } | | k r3t
| j | } xg | j D]M \ } }
d | } t
| | } t | r | j |
| | | g | Sq Wt | } n x~ | j D]s \ } }
t
| j | | } t d j | d d | | | k r=t | r| j |
| | d | Sq=q=W| rt d j | t | d }
| g |
_ |
Sd S) z}Try to find a loader for the specified module, or the namespace
package portions. Returns (loader, list-of-portions).Fr r r rY z trying {}r Nzpossible namespace for {}r )r$ r- r' r r4 ru r. r _fill_cacher r r r r r r3 r r5 r r7 r r )rX r r= is_namespace tail_moduler cache cache_module base_pathr| r
init_filename full_pathr r r r r> sD "
zFileFinder.find_specc
C s | j } y t j | p! t j } Wn! t t t f k
rK g } Yn Xt j j d sp t
| | _ no t
} xZ | D]R } | j d \ } } } | r d j
| | j } n | } | j | q W| | _ t j j t r
d d | D | _ n d S)zDFill the cache of potential modules and packages for this directory.r r z{}.{}c S s h | ] } | j q Sr )r )r fnr r r * s z)FileFinder._fill_cache..N)r' r listdirr4 FileNotFoundErrorPermissionErrorNotADirectoryErrorr r
r r r r r7 r addr r ) rX r' contentslower_suffix_contentsr rT r r| new_namer r r r
s"
zFileFinder._fill_cachec s f d d } | 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! t d d | n | S)z-Path hook for importlib.machinery.FileFinder.z only directories are supportedr' )r5 r )r' )r< r r r path_hook_for_FileFinder6 s z6FileFinder.path_hook..path_hook_for_FileFinderr )r< r r r )r< r r path_hook, s
zFileFinder.path_hookc C s d j | j S)NzFileFinder({!r}))r7 r' )rX r r r rw > s zFileFinder.__repr__)rH rG rI rJ rY r r r? r r r> r rD r rw r r r r r s - r c @ s. e Z d Z d Z d d Z d d Z d S)_ImportLockContextz$Context manager for the import lock.c C s t j d S)zAcquire the import lock.N)r| r0 )rX r r r r\ H s z _ImportLockContext.__enter__c C s t j d S)z r r r ) rT r' r= is_reloadr r> r r r r r r
_find_specc s0
r c C s t | t s- t d j t | n | d k rH t d n | r t | t sl t d q | t j k r d } t | j | q n | r | d k r t d n d S)z Verify arguments are "sane".z module name must be str, not {}re zlevel must be >= 0z __package__ not set to a stringz=Parent module {!r} not loaded, cannot perform relative importzEmpty module nameN) r r TypeErrorr7 rS r r rZ SystemError)rT r r r r r r
_sanity_check s r zNo module named z{!r}c C s4 d } | j d d } | r | t j k r> t | | n | t j k rX t j | St j | } y
| j } Wq t k
r t d j | | } t | d | Yq Xn t | | } | d k r t t j | d | n t
| j } | r0t j | } t | | j d d | n | S)Nr re z; {!r} is not a packagerT r )
r$ r rZ r r# r _ERR_MSGr7 r r r r3 rL )rT import_r' r
parent_moduler r r r r r _find_and_load_unlocked s*
r c
C s$ t | t | | SWd QXd S)z6Find and load the module, and release the import lock.N)ry r )rT r r r r _find_and_load s
r c C s t | | | | d k r1 t | | | } n t j | t j k rW t | t St j | } | d k r t j d j | } t
| d | n t | | S)a2 Import and return the module based on its name, the package the call is
being made from, and the level adjustment.
This function represents the greatest common denominator of functionality
between import_module and __import__. This includes setting __package__ if
the loader did not.
re Nz(import of {} halted; None in sys.modulesrT ) r r r| r0 r rZ r _gcd_importr} r7 r r )rT r r r r r r r r s
r c C s t | d r d | k rY t | } | j d t | d rY | j | j qY n x | D] } t | | s` d j | j | } y t | | Wq t k
r } z5 t | j
t r | j | k r w` q n WYd d } ~ Xq Xq` q` Wn | S)zFigure out what __import__ should return.
The import_ parameter is a callable which takes the name of module to
import. It is required to decouple the function from assuming importlib's
import implementation is desired.
r# *__all__z{}.{}N)
rK r" remover r r7 rH r r r r _ERR_MSG_PREFIXrT )r fromlistr r from_namerf r r r _handle_fromlist s"
r c C sN | j d } | d k rJ | d } d | k rJ | j d d } qJ n | S)zCalculate what __package__ should be.
__package__ is not guaranteed to be defined or could be set to None
to represent that its proper value is unknown.
r' NrH r# r re )ro r$ )globalsr r r r _calc___package__ s
r c C s7 t t j f } t t f } t t f } | | | g S)z_Returns a list of file-based module loaders.
Each item is a tuple (loader, suffixes).
)rz r| extension_suffixesr5 r r4 r )
extensionssourcebytecoder r r r s r c C s | d k r t | } n6 | d k r- | n i } t | } t | | | } | s | d k rz t | j d d S| s | St | t | j d d } t j | j d t | j | Sn t | | t Sd S)a Import a module.
The 'globals' argument is used to infer where the import is occuring from
to handle relative imports. The 'locals' argument is ignored. The
'fromlist' argument specifies what should exist as attributes on the module
being imported (e.g. ``from module import ``). The 'level'
argument represents the package location to import from in a relative
import (e.g. ``from ..pkg import mod`` would have a 'level' of 2).
re Nr )r r r r# r rZ rH r ) rT r localsr r r globals_r cut_offr r r
__import__ s #(r c C sD t j | } | d k r. t d | n t | } | j S)Nzno built-in module named )r: r> r r r3 )rT r r r r r _builtin_from_name5 s
r c C s | a | a t j j r! t a n t a t t } x t j j D]y \ } } t
| | rC | t j k rv t } n t j
| rC t } n qC t | | } t | } | j | qC qC Wt j t } xI d D]A } | t j k r t | }
n
t j | }
t | | |
q Wd d g f d d d g f f } x | D]~ \ } }
t d d
|
D slt |
d } | t j k rt j | } PqAy t | } PWqAt k
rwAYqAXqAWt d t | d
| t | d | t | d d j |
y t d } Wn t k
r2d } Yn Xt | d | t d } t | d | | d k rt d } t | d | n t | d t t j t j | d k rt j d d t k rd t _ qn d S)zSetup importlib by importing needed built-in modules and injecting them
into the global namespace.
As sys is needed for sys.modules access and _imp is needed to load built-in
modules, those two modules must be explicitly passed in.
r= r builtinsr posix/nt\c s s! | ] } t | d k Vq d S)r N)r# )r r r r r r^ i s z_setup..re z importlib requires posix or ntr r r r" rf Nr winregrK r z.pywz_d.pydT)z_ioz _warningszbuiltinszmarshal)!r| r r r r r r rS rZ itemsr r r: r rE r$ r r+ rH r rL allrv r r r
r~ r r r r rJ rR )
sys_module _imp_module module_typerT r r r r self_module builtin_namebuiltin_module
os_details
builtin_osr r os_module
thread_moduleweakref_module
winreg_moduler r r _setup= sl
!
r c C s t | | t } t j j t j | g t j j t t j j t
t j d k rt t j j t
n t j j t d S)z2Install importlib as the implementation of import.r N)r r r r r r r r r r: rE r rH rJ r )r r supported_loadersr r r _install s
r )zwinzcygwinzdarwin)\rJ r r
r r r r+ r- r2 r3 r5 rF rR rU rS __code__r rV r rn ru rc rd rx ry r{ r r r r r r _RAW_MAGIC_NUMBERr r r r r r r r r r r r r r r r r r r r r r objectr r r$ r r9 r: rE rJ r[ r^ ro r5 r4 r~ rz 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 s
D r 7
$j ?-FG?n)+99&
(
# W