U
e5dܚ @ s d Z dadd Zdd Zi Zi ZG dd deZG dd d ZG d
d d Z G d d
d
Z
dd Z dd Z dd Z
ddddZdd Zdd Zd d Zd d ZG d d! d!Zddd"d#d$Zd^d%d&Zd'd(d)d*Zd+d, Zd-d. Zd/d0 Zd1d2 Zd3d4 Zd5d6 Z G d7d8 d8Z G d9d: d:Z G d;d< d<Z d=d> Z d?d@ Z!d_dAdBZ"dCdD Z#dEZ$e$dF Z%dGdH Z&e' Z(dIdJ Z)d`dLdMZ*d'dNdOdPZ+dQdR Z,dadTdUZ-dVdW Z.dXdY Z/dZd[ Z0d\d] Z1dS )baS 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.
Nc C s8 dD ] }t ||rt| |t|| q| j|j dS )z/Simple substitute for functools.update_wrapper.)
__module____name__ __qualname____doc__N)hasattrsetattrgetattr__dict__update)newoldreplace r
,/usr/lib64/python3.8/importlib/_bootstrap.py_wrap s
r c C s t t| S N)typesysnamer
r
r _new_module# s r c @ s e Zd ZdS )_DeadlockErrorN)r r r r
r
r
r r 0 s r c @ s8 e Zd ZdZdd Zdd Zdd Zdd Zd
d Zd 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 s0 t | _t | _|| _d | _d| _d| _d S N )_thread
allocate_locklockwakeupr ownercountwaitersselfr r
r
r __init__: s
z_ModuleLock.__init__c C s< t }| j}t|}|d kr$dS |j}||krdS qd S )NFT)r get_identr _blocking_onget)r" metidr r
r
r has_deadlockB s
z_ModuleLock.has_deadlockc C s t }| t|< z| jn | jdks.| j|krT|| _| jd7 _W 5 Q R W VdS | rhtd| | j dr| j
d7 _
W 5 Q R X | j | j qW 5 t|= X dS )z
Acquire the module lock. If a potential deadlock is detected,
a _DeadlockError is raised.
Otherwise, the lock is always acquired and True is returned.
r Tzdeadlock detected by %rFN) r r$ r% r r r r) r r acquirer releaser" r( r
r
r r+ N s
z_ModuleLock.acquirec C sl t }| jT | j|kr"td| jd8 _| jdkr^d | _| jr^| jd8 _| j W 5 Q R X d S )N cannot release un-acquired lockr* r ) r r$ r r RuntimeErrorr r r r, r- r
r
r r, g s
z_ModuleLock.releasec C s d | jt| S )Nz_ModuleLock({!r}) at {}formatr idr" r
r
r __repr__t s z_ModuleLock.__repr__N) r r r r r# r) r+ r, r4 r
r
r
r r 4 s
r c @ s0 e Zd ZdZdd Zdd Zdd Zdd Zd
S ) _DummyModuleLockzVA simple _ModuleLock equivalent for Python builds without
multi-threading support.c C s || _ d| _d S r )r r r! r
r
r r# | s z_DummyModuleLock.__init__c C s | j d7 _ dS )Nr* T)r r3 r
r
r r+ s z_DummyModuleLock.acquirec C s$ | j dkrtd| j d8 _ d S )Nr r. r* )r r/ r3 r
r
r r, s
z_DummyModuleLock.releasec C s d | jt| S )Nz _DummyModuleLock({!r}) at {}r0 r3 r
r
r r4 s z_DummyModuleLock.__repr__N)r r r r r# r+ r, r4 r
r
r
r r5 x s
r5 c @ s$ e Zd Zdd Zdd Zdd ZdS )_ModuleLockManagerc C s || _ d | _d S r )_name_lockr! r
r
r r# s z_ModuleLockManager.__init__c C s t | j| _| j d S r )_get_module_lockr7 r8 r+ r3 r
r
r __enter__ s z _ModuleLockManager.__enter__c O s | j d S r )r8 r, )r" argskwargsr
r
r __exit__ s z_ModuleLockManager.__exit__N)r r r r# r: r= r
r
r
r r6 s r6 c C s t zjzt| }W n tk
r0 d}Y nX |dkrptdkrLt| }nt| }| fdd}t ||t| < W 5 t X |S )zGet or create the module lock for a given module name.
Acquire/release internally the global import lock to protect
_module_locks.Nc S s0 t zt|| kr t|= W 5 t X d S r )_imp acquire_lock release_lock
_module_locksr& )refr r
r
r cb s
z _get_module_lock..cb)
r> r? r@ rA KeyErrorr r5 r _weakrefrB )r r rC r
r
r r9 s
r9 c C s6 t | }z | W n tk
r( Y n
X | dS )zAcquires then releases 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.
N)r9 r+ r r, )r r r
r
r _lock_unlock_module s rF 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
)fr; kwdsr
r
r _call_with_frames_removed s rI r* ) verbosityc G s6 t jj|kr2| ds d| } t| j| t jd dS )z=Print the message to stderr if -v/PYTHONVERBOSE is turned on.)#zimport z# )fileN)r flagsverbose
startswithprintr1 stderr)messagerJ r; r
r
r _verbose_message s
rS c s fdd}t | |S )z1Decorator to verify the named module is built-in.c s& |t jkr td||d | |S )N {!r} is not a built-in moduler )r builtin_module_names ImportErrorr1 r" fullnamefxnr
r _requires_builtin_wrapper s
z4_requires_builtin.._requires_builtin_wrapperr )rZ r[ r
rY r _requires_builtin s
r] c s fdd}t | |S )z/Decorator to verify the named module is frozen.c s& t |s td||d | |S Nz{!r} is not a frozen moduler )r> is_frozenrV r1 rW rY r
r _requires_frozen_wrapper s
z2_requires_frozen.._requires_frozen_wrapperr\ )rZ r` r
rY r _requires_frozen s
ra c C s> t || }|tjkr2tj| }t|| tj| S t|S dS )zLoad the specified module into sys.modules and return it.
This method is deprecated. Use loader.exec_module instead.
N)spec_from_loaderr modules_exec_load)r" rX specmoduler
r
r _load_module_shim s
rh c C s t | dd }t|dr8z || W S tk
r6 Y nX z
| j}W n tk
rV Y nX |d k rht|S z
| j}W n tk
r d}Y nX z
| j}W n: tk
r |d krd | Y S d || Y S Y nX d ||S d S )N
__loader__ module_repr?
)
r r rj Exception__spec__AttributeError_module_repr_from_specr __file__r1 )rg loaderrf r filenamer
r
r _module_repr
s.
rv c @ sr e Zd ZdZddddddZdd Zdd Zed
d Zej d d Zed
d Z
edd Z e j dd Z dS )
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.
N)origin loader_state
is_packagec C s6 || _ || _|| _|| _|r g nd | _d| _d | _d S NF)r rt rx ry submodule_search_locations
_set_fileattr_cached)r" r rt rx ry rz r
r
r r# V s zModuleSpec.__init__c C sf d | jd | jg}| jd k r4|d | j | jd k rP|d | j d | jjd|S )Nz name={!r}z loader={!r}z origin={!r}z submodule_search_locations={}z{}({})z, ) r1 r rt rx appendr| __class__r join)r" r; r
r
r r4 b s
zModuleSpec.__repr__c C sj | j }zH| j|jkoL| j|jkoL| j|jkoL||j koL| j|jkoL| j|jkW S tk
rd Y dS X d S r{ )r| r rt rx cached has_locationrq )r" othersmslr
r
r __eq__l s
zModuleSpec.__eq__c C s: | j d kr4| jd k r4| jr4td kr&tt| j| _ | j S r )r~ rx r} _bootstrap_externalNotImplementedError _get_cachedr3 r
r
r r x s
zModuleSpec.cachedc C s
|| _ d S r )r~ )r" r r
r
r r s c C s$ | j dkr| jdd S | jS dS )z The name of the module's parent.N.r )r| r
rpartitionr3 r
r
r parent s
zModuleSpec.parentc C s | j S r )r} r3 r
r
r r s zModuleSpec.has_locationc C s t || _d S r )boolr} )r" valuer
r
r r s ) r r r r r# r4 r propertyr setterr r r
r
r
r rw 1 s $
rw rx rz c C s t |drJtdkrttj}|dkr0|| |dS |r8g nd}|| ||dS |dkrt |drz|| }W q tk
r d}Y qX nd}t| |||dS )z5Return a module spec based on various loader methods. get_filenameN)rt )rt r| rz Fr )r r r spec_from_file_locationrz rV rw )r rt rx rz r searchr
r
r rb s$
rb c C s8 z
| j }W n tk
r Y nX |d k r,|S | j}|d krZz
| j}W n tk
rX Y nX z
| j}W n tk
r| d }Y nX |d kr|d krz
|j}W q tk
r d }Y qX n|}z
| j}W n tk
r d }Y nX zt| j}W n tk
r d }Y nX t |||d}|d kr"dnd|_
||_ ||_ |S )Nrx FT)
rp rq r ri rs _ORIGIN
__cached__list__path__rw r} r r| )rg rt rx rf r locationr r| r
r
r _spec_from_module sH
r Foverridec C s |st |dd d kr6z | j|_W n tk
r4 Y nX |sJt |dd d kr| j}|d kr| jd k rtd krnttj}| |}| j|_
|| _d |_ z
||_ W n tk
r Y nX |st |dd d krz | j
|_W n tk
r Y nX z
| |_W n tk
r Y nX |s"t |dd d krR| jd k rRz | j|_W n tk
rP Y nX | jr|srt |dd d krz | j|_ W n tk
r Y nX |st |dd d kr| jd k rz | j|_W n tk
r Y nX |S )Nr ri __package__r rs r )r r r rq rt r| r r _NamespaceLoader__new___pathrs ri r r rp r r rx r r )rf rg r rt r r
r
r _init_module_attrs s`
r c C sR d}t | jdr | j| }nt | jdr2td|dkrDt| j}t| | |S )z+Create a module based on the provided spec.N
create_module exec_modulezBloaders that define exec_module() must also define create_module())r rt r rV r r r rf rg r
r
r module_from_spec% s
r c C sj | j dkrdn| j }| jdkrB| jdkr2d|S d|| jS n$| jrVd|| jS d| j | jS dS )z&Return the repr to use for the module.Nrk rl rm rn )r rx rt r1 r )rf r r
r
r rr 6 s
rr c
C s | j }t| tj||k r6d|}t||dzj| jdkrj| j dkrZtd| j dt
| |dd n4t
| |dd t | jds| j | n | j
| W 5 tj| j }|tj| j < X W 5 Q R X |S )zFExecute the spec's specified module in an existing module's namespace.z module {!r} not in sys.modulesr Nmissing loaderTr r )r r6 r rc r& r1 rV poprt r| r r load_moduler )rf rg r msgr
r
r rd G s"
rd c C s z| j | j W n4 | jtjkr@tj| j}|tj| j< Y nX tj| j}|tj| j< t|dd d krz | j |_W n tk
r Y nX t|dd d krz(|j |_
t |ds| j dd |_
W n tk
r Y nX t|dd d krz
| |_
W n tk
r Y nX |S )Nri r r r r rp )rt r r r rc r r ri rq r r r r rp r r
r
r _load_backward_compatiblee s6
r c C s | j d k r t| j ds t| S t| }d| _z|tj| j< z4| j d kr`| jd krlt d| jdn | j
| W n2 ztj| j= W n t k
r Y nX Y nX tj | j}|tj| j< t
d| j| j W 5 d| _X |S )Nr TFr r zimport {!r} # {!r})rt r r r
_initializingr rc r r| rV r rD r rS r r
r
r _load_unlocked s.
r c
C s* t | j t| W 5 Q R S Q R X dS )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)r6 r r )rf r
r
r re s re c @ s e Zd ZdZedd ZedddZedddZed d
Z ed d Z
ee d
d Z ee dd Z
ee dd ZeeZdS )BuiltinImporterzMeta path import for built-in modules.
All methods are either class or static methods to avoid the need to
instantiate the class.
c C s d | jS )sReturn repr for the module.
The method is deprecated. The import machinery does the job itself.
z)r1 r )rg r
r
r rj s zBuiltinImporter.module_reprNc C s, |d k r d S t |r$t|| ddS d S d S )Nzbuilt-inr )r>
is_builtinrb clsrX pathtargetr
r
r find_spec s
zBuiltinImporter.find_specc C s | ||}|dk r|jS dS )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 rt )r rX r rf r
r
r find_module s zBuiltinImporter.find_modulec C s. |j tjkr"td|j |j dttj|S )zCreate a built-in modulerT r )r r rU rV r1 rI r> create_builtin)r" rf r
r
r r s
z BuiltinImporter.create_modulec C s t tj| dS )zExec a built-in moduleN)rI r> exec_builtin)r" rg r
r
r r s zBuiltinImporter.exec_modulec C s dS )z9Return None as built-in modules do not have code objects.Nr
r rX r
r
r get_code s zBuiltinImporter.get_codec C s dS )z8Return None as built-in modules do not have source code.Nr
r r
r
r
get_source s zBuiltinImporter.get_sourcec C s dS )z4Return False as built-in modules are never packages.Fr
r r
r
r rz s zBuiltinImporter.is_package)NN)N)r r r r staticmethodrj classmethodr r r r r] r r rz rh r r
r
r
r r s*
r c @ s e Zd ZdZdZedd ZedddZeddd Z ed
d Z
ed d
Z edd Z ee
dd Zee
dd Zee
dd ZdS )FrozenImporterzMeta path import for frozen modules.
All methods are either class or static methods to avoid the need to
instantiate the class.
frozenc C s d | jtjS )r r )r1 r r r )mr
r
r rj s zFrozenImporter.module_reprNc C s" t |rt|| | jdS d S d S )Nr )r> r_ rb r r r
r
r r s
zFrozenImporter.find_specc C s t |r| S dS )z]Find a frozen module.
This method is deprecated. Use find_spec() instead.
N)r> r_ )r rX r r
r
r r ' s zFrozenImporter.find_modulec C s dS )z*Use default semantics for module creation.Nr
)r rf r
r
r r 0 s z FrozenImporter.create_modulec C s@ | j j}t|s$td||dttj|}t|| j d S r^ )
rp r r> r_ rV r1 rI get_frozen_objectexecr )rg r coder
r
r r 4 s
zFrozenImporter.exec_modulec C s
t | |S )z_Load a frozen module.
This method is deprecated. Use exec_module() instead.
)rh r r
r
r r = s zFrozenImporter.load_modulec C s
t |S )z-Return the code object for the frozen module.)r> r r r
r
r r F s zFrozenImporter.get_codec C s dS )z6Return None as frozen modules do not have source code.Nr
r r
r
r r L s zFrozenImporter.get_sourcec C s
t |S )z.Return True if the frozen module is a package.)r> is_frozen_packager r
r
r rz R s zFrozenImporter.is_package)NN)N)r r r r r r rj r r r r r r ra r r rz r
r
r
r r s.
r c @ s e Zd ZdZdd Zdd ZdS )_ImportLockContextz$Context manager for the import lock.c C s t dS )zAcquire the import lock.N)r> r? r3 r
r
r r: _ s z _ImportLockContext.__enter__c C s t dS )z r@ )r" exc_type exc_value
exc_tracebackr
r
r r= c s z_ImportLockContext.__exit__N)r r r r r: r= r
r
r
r r [ s r c C s@ | d|d }t||k r$td|d }| r= 0z __package__ not set to a stringz6attempted relative import with no known parent packagezEmpty module nameN)
isinstancestr TypeErrorr1 r r rV r r r r
r
r
_sanity_check s
r zNo module named z{!r}c C s d }| dd }|r|tjkr*t|| | tjkr>tj| S tj| }z
|j}W n2 tk
r td | |}t|| dd Y nX t | |}|d krtt| | dnt
|}|rtj| }t || dd | |S )Nr r z; {!r} is not a packager ) r r rc rI r rq _ERR_MSGr1 ModuleNotFoundErrorr r r )r import_r r
parent_moduler rf rg r
r
r _find_and_load_unlocked s*
r c
C sj t | 2 tj| t}|tkr6t| |W 5 Q R S W 5 Q R X |dkr^d| }t|| dt| |S )zFind and load the module.Nz(import of {} halted; None in sys.modulesr ) r6 r rc r& _NEEDS_LOADINGr r1 r rF )r r rg rR r
r
r _find_and_load s
r r c C s* t | || |dkr t| ||} t| tS )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.
r )r r r _gcd_importr r
r
r r s r recursivec C s |D ]}t |tsB|r"| jd }nd}td| dt|j q|dkrl|st| drt| | j|dd qt| |sd | j|}zt || W q t
k
r } z*|j |krt j
|td
k rW Y q W 5 d
}~X Y qX q| 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.
z.__all__z
``from list''zItem in z must be str, not *__all__Tr r N)r r r r r r _handle_fromlistr r1 rI r r r rc r& r )rg fromlistr r xwhere from_nameexcr
r
r r s,
r c C s | d}| d}|dk rR|dk rN||jkrNtjd|d|jdtdd |S |dk r`|jS tjd tdd | d
}d | kr|d d
}|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 rp Nz __package__ != __spec__.parent (z != ) )
stacklevelzYcan't resolve package from __spec__ or __package__, falling back on __name__ and __path__r r r r )r& r r r r r )globalsr rf r
r
r _calc___package__ s&
r r
c C s |dkrt | }n$|dk r |ni }t|}t | ||}|s|dkrTt | dd S | s\|S t| t| dd }tj|jdt|j| S nt|drt||t S |S dS )a Import a module.
The 'globals' argument is used to infer where the import is occurring 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).
r Nr r ) r r partitionr r rc r r r ) r r localsr r rg globals_r cut_offr
r
r
__import__9 s
r c C s& t | }|d kr td| t|S )Nzno built-in module named )r r rV r )r rf r
r
r _builtin_from_name^ s
r c
C s |a | att}tj D ]H\}}t||r|tjkr r r rc itemsr rU r r_ r r r r r r )
sys_module _imp_module module_typer rg rt rf self_module builtin_namebuiltin_moduler
r
r _setupe s$
r c C s& t | | tjt tjt dS )z0Install importers for builtin and frozen modulesN)r r r r r r )r r r
r
r _install s
r c C s ddl } | a| tjt dS )z9Install importers that require external filesystem accessr N)_frozen_importlib_externalr r r rc r )r r
r
r _install_external_importers s r )NN)N)Nr )NNr
r )2r r r r rA r% r/ r r r5 r6 r9 rF rI rS r] ra rh rv rw rb r r r rr rd r r re r r r r r r r _ERR_MSG_PREFIXr r objectr r r r r r r r r r r
r
r
r s^ D% $e
-H %*IO
/
%
%#