o
0i, @ s* d Z ddlmZ ddlmZ ddlmZ ddlmZ ddlmZ ddlm Z ddlm
Z
dd lm Z dd
lm Z dd lm
Z
dd lmZ d
dlmZ d
dlZd
dlZd
dlZd
dlZd
dlZdd Zdd Zd$ddZd$ddZedd Zdd Zd d Z d d Z G d d! d!ej Z G d"d# d#eZ dS )%z-Utility code for constructing importers, etc. )Loader)module_from_spec)
_resolve_name)spec_from_loader)
_find_spec) MAGIC_NUMBER)_RAW_MAGIC_NUMBER)cache_from_source)
decode_source)source_from_cache)spec_from_file_location )contextmanagerNc C s t t| S )zBReturn the hash of *source_bytes* as used in hash-based pyc files.)_imp source_hashr ) source_bytes r 5/opt/alt/python310/lib64/python3.10/importlib/util.pyr s r c C s\ | ds| S |stdt| dd}| D ] }|dkr n|d7 }qt| |d ||S )z2Resolve a relative module name to an absolute one..zno package specified for z% (required for relative module names)r
r N)
startswith ImportErrorreprr )namepackagelevel characterr r r resolve_name s
r c C sn | t jvr
t| |S t j| }|du rdS z|j}W n ty) td| dw |du r5td| |S )a Return the spec for the specified module.
First, sys.modules is checked to see if the module was already imported. If
so, then sys.modules[name].__spec__ is returned. If that happens to be
set to None, then ValueError is raised. If the module is not in
sys.modules, then sys.meta_path is searched for a suitable spec with the
value of 'path' given to the finders. None is returned if no spec could
be found.
Dotted names do not have their parent packages implicitly imported. You will
most likely need to explicitly import all parent packages in the proper
order for a submodule to get the correct spec.
N{}.__spec__ is not set{}.__spec__ is None)sysmodulesr __spec__AttributeError
ValueErrorformat)r pathmodulespecr r r _find_spec_from_path* s
r( c
C s | dr
t| |n| }|tjvrG|dd }|r@t|dgd}z|j}W n ty? } z
td|d||d|d}~ww d}t ||S tj| }|du rRdS z|j
}W n tyf t d | dw |du rrt d
| |S ) a Return the spec for the specified module.
First, sys.modules is checked to see if the module was already imported. If
so, then sys.modules[name].__spec__ is returned. If that happens to be
set to None, then ValueError is raised. If the module is not in
sys.modules, then sys.meta_path is searched for a suitable spec with the
value of 'path' given to the finders. None is returned if no spec could
be found.
If the name is for submodule (contains a dot), the parent module is
automatically imported.
The name and package arguments work the same as importlib.import_module().
In other words, relative module names (with leading dots) work.
r r
__path__)fromlistz __path__ attribute not found on z while trying to find )r Nr r )
r r r r
rpartition
__import__r) r" ModuleNotFoundErrorr r! r# r$ ) r r fullname parent_nameparent parent_pather& r' r r r find_specI s>
r3 c c s | t jv }t j| }|s tt | }d|_|t j| < z-z|V W n ty= |s;zt j| = W n ty: Y nw Y nw W d|_d S W d|_d S d|_w )NTF)r r gettype__initializing__ ExceptionKeyError)r is_reloadr& r r r _module_to_loadv s,
r: c t fdd}|S )zOSet __package__ on the returned module.
This function is deprecated.
c sV t jdtdd | i |}t|dd d u r)|j|_t|ds)|jdd |_|S )NkThe import system now takes care of this automatically; this decorator is slated for removal in Python 3.12
stacklevel __package__r) r r
)warningswarnDeprecationWarninggetattr__name__r@ hasattrr+ )argskwargsr& fxnr r set_package_wrapper s
z(set_package..set_package_wrapper functoolswraps)rJ rK r rI r set_package s
rO c r; )zNSet __loader__ on the returned module.
This function is deprecated.
c s@ t jdtdd | g|R i |}t|dd d u r | |_|S )Nr< r= r>
__loader__)rA rB rC rD rP )selfrG rH r& rI r r set_loader_wrapper s z&set_loader..set_loader_wrapperrL )rJ rR r rI r
set_loader s rS c s* t jdtdd t fdd}|S )a* Decorator to handle selecting the proper module for loaders.
The decorated function is passed the module to use instead of the module
name. The module passed in to the function is either from sys.modules if
it already exists or is a new module. If the module is new, then __name__
is set the first argument to the method, __loader__ is set to self, and
__package__ is set accordingly (if self.is_package() is defined) will be set
before it is passed to the decorated function (if self.is_package() does
not work for the module it will be set post-load).
If an exception is raised and the decorator created the module it is
subsequently removed from sys.modules.
The decorator assumes that the decorated function takes the module name as
the second argument.
r< r= r> c
s t |8}| |_z| |}W n ttfy Y nw |r!||_n|dd |_ | |g|R i |W d S 1 s?w Y d S )Nr r
)r: rP
is_packager r" r@ r+ )rQ r. rG rH r& rT rI r r module_for_loader_wrapper s
$z4module_for_loader..module_for_loader_wrapper)rA rB rC rM rN )rJ rU r rI r module_for_loader s rV c @ s e Zd ZdZdd Zdd ZdS ) _LazyModulezKA subclass of the module type which triggers loading upon attribute access.c C s t j| _| jj}| jjd }| j}i }| D ] \}}||vr$|||< qt|| t|| kr4|||< q| jj
| |t j v rTt| tt j | krTt
d|d| j| t| |S )z8Trigger the load of the module and return the attribute.__dict__zmodule object for z. substituted in sys.modules during a lazy load)types
ModuleType __class__r! r loader_staterX itemsidloader exec_moduler r r# updaterD )rQ attr
original_name
attrs_then attrs_now
attrs_updatedkeyvaluer r r __getattribute__ s"
z _LazyModule.__getattribute__c C s | | t| | dS )z/Trigger the load and then perform the deletion.N)ri delattr)rQ rb r r r __delattr__ s
z_LazyModule.__delattr__N)rE
__module__ __qualname____doc__ri rk r r r r rW s "rW c @ s@ e Zd ZdZedd Zedd Zdd Zdd Z d
d Z
d S )
LazyLoaderzKA loader that creates a module which defers loading until attribute access.c C s t | ds tdd S )Nr` z loader must define exec_module())rF TypeError)r_ r r r __check_eager_loader s
z LazyLoader.__check_eager_loaderc s fddS )z>Construct a callable which returns the eager loader made lazy.c s | i |S Nr )rG rH clsr_ r r s z$LazyLoader.factory..) _LazyLoader__check_eager_loaderrs r rs r factory s
zLazyLoader.factoryc C s | | || _d S rr )rv r_ )rQ r_ r r r __init__ s
zLazyLoader.__init__c C s | j |S rr )r_
create_module)rQ r' r r r ry s zLazyLoader.create_modulec C s@ | j |j_ | j |_i }|j |d< |j|d< ||j_t|_dS )z Make the module load lazily.rX r[ N)r_ r! rP rX copyr[ r\ rW )rQ r& r\ r r r r` " s
zLazyLoader.exec_moduleN) rE rl rm rn staticmethodrv classmethodrw rx ry r` r r r r ro s
ro rr )!rn _abcr
_bootstrapr r r r _bootstrap_externalr r r r
r r
contextlibr r rM r rY rA r r r( r3 r: rO rS rV rZ rW ro r r r r s:
-
(.