o
0i @ s d Z dd ZdZdZdZdadd Zdd Zi Zi Z G dd d e
Z G d
d d Z G d d
d
Z
G dd dZdd Zdd Zdd ZddddZdd Zd d Zd d Zd d! ZG d"d# d#Zddd$d%d&Zd`d'd(Zd)d*d+d,Zd-d. Zd/d0 Z d1d2 Z d3d4 Z d5d6 Z d7d8 Z G d9d: d:Z!G d;d< d<Z"G d=d> d>Z#d?d@ Z$dAdB Z%dadCdDZ&dEdF Z'dGZ(e(dH Z)dIdJ Z*e+ Z,dKdL Z-dbdNdOZ.d)dPdQdRZ/dSdT Z0dcdVdWZ1dXdY Z2dZd[ Z3d\d] Z4d^d_ Z5dS )daS 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.
c C s& z| j W S ty t| j Y S w N) __qualname__AttributeErrortype)obj r ;/opt/alt/python310/lib64/python3.10/importlib/_bootstrap.py _object_name s
r Nc C s8 dD ]}t ||rt| |t|| q| j|j dS )z/Simple substitute for functools.update_wrapper.)
__module____name__r __doc__N)hasattrsetattrgetattr__dict__update)newoldreplacer r r _wrap( s
r c C s t t| S r )r sysnamer r r _new_module0 s r c @ s e Zd ZdS )_DeadlockErrorN)r
r r r r r r r = 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__G s
z_ModuleLock.__init__c C sV t }| j}t } t|}|d u rdS |j}||kr dS ||v r%dS || q )NTF)r get_identr! set _blocking_ongetadd)r% metidseenr r r r has_deadlockO s
z_ModuleLock.has_deadlockc C s t }| t|< zW | j@ | jdks| j|kr/|| _| jd7 _ W d W t|= dS | r9td| | j drF| j
d7 _
W d n1 sPw Y | j | j q
t|= w )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.
Tr Nzdeadlock detected by %rF) r r' r) r r" r! r/ r r acquirer# releaser% r- r r r r1 d s*
z_ModuleLock.acquirec C s t }| j@ | j|krtd| jd8 _| jdkr7d | _| jr?| jd8 _| j W d d S W d d S W d d S 1 sJw Y d S )N cannot release un-acquired lockr0 r ) r r' r r! RuntimeErrorr" r# r r2 r3 r r r r2 } s
"z_ModuleLock.releasec C d | jt| S )Nz_ModuleLock({!r}) at {}formatr idr% r r r __repr__ z_ModuleLock.__repr__N) r
r r r r& r/ r1 r2 r; r r r r r A 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&
z_DummyModuleLock.__init__c C s | j d7 _ dS )Nr0 T)r" r: r r r r1 s z_DummyModuleLock.acquirec C s$ | j dkr td| j d8 _ d S )Nr r4 r0 )r" r5 r: r r r r2 s
z_DummyModuleLock.releasec C r6 )Nz _DummyModuleLock({!r}) at {}r7 r: r r r r; r< z_DummyModuleLock.__repr__N)r
r r r r& r1 r2 r; r r r r r= s r= c @ s$ e Zd Zdd Zdd Zdd ZdS )_ModuleLockManagerc C s || _ d | _d S r )_name_lockr$ r r r r& r> z_ModuleLockManager.__init__c C s t | j| _| j d S r )_get_module_lockr@ rA r1 r: r r r __enter__ s z _ModuleLockManager.__enter__c O s | j d S r )rA r2 )r% argskwargsr r r __exit__ s z_ModuleLockManager.__exit__N)r
r r r& rC rF r r r r r? s r? c C s t z@zt| }W n ty d}Y nw |du r>tdu r%t| }nt| }| fdd}t||t| < W t |S W t |S t w )zGet or create the module lock for a given module name.
Acquire/release internally the global import lock to protect
_module_locks.Nc S sD t zt|| u rt|= W t d S W t d S t w r )_imp acquire_lock
_module_locksr* release_lock)refr r r r cb s z _get_module_lock..cb)
rG rH rI KeyErrorr r= r _weakrefrK rJ )r r rL r r r rB s&
rB c C s6 t | }z| W n
ty Y dS w | 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)rB r1 r r2 )r r r r r _lock_unlock_module s rO c O s | |i |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 )frD kwdsr r r _call_with_frames_removed s rR r0 ) verbosityc G s: t jj|kr| dsd| } t| j| t jd dS dS )z=Print the message to stderr if -v/PYTHONVERBOSE is turned on.)#zimport z# )fileN)r flagsverbose
startswithprintr8 stderr)messagerS rD r r r _verbose_message s
r\ c fdd}t | |S )z1Decorator to verify the named module is built-in.c s& |t jvrtd||d | |S )N {!r} is not a built-in moduler )r builtin_module_names ImportErrorr8 r% fullnamefxnr r _requires_builtin_wrapper
z4_requires_builtin.._requires_builtin_wrapperr )rd re r rc r _requires_builtin
rh c r] )z/Decorator to verify the named module is frozen.c s& t |std||d | |S Nz{!r} is not a frozen moduler )rG is_frozenr` r8 ra rc r r _requires_frozen_wrapper rf z2_requires_frozen.._requires_frozen_wrapperrg )rd rl r rc r _requires_frozen ri rm c C sJ d}t |t t|| }|tjv r!tj| }t|| tj| S t|S )zLoad the specified module into sys.modules and return it.
This method is deprecated. Use loader.exec_module() instead.
zgthe load_module() method is deprecated and slated for removal in Python 3.12; use exec_module() instead) _warningswarnDeprecationWarningspec_from_loaderr modules_exec_load)r% rb msgspecmoduler r r _load_module_shim s
rx c C s t | dd}t | dd }rt|S t|dr'z|| W S ty& Y nw z| j}W n ty7 d}Y nw z| j}W n tyW |du rOd| Y S d|| Y S w d||S ) z,The implementation of ModuleType.__repr__().
__loader__N__spec__ module_repr?
) r _module_repr_from_specr r{ Exceptionr
r __file__r8 )rw loaderrv r filenamer r r _module_repr& s,
r 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 || _ || _|| _|| _|rg nd | _d| _d | _d S )NF)r r r r submodule_search_locations
_set_fileattr_cached)r% r r r r r r r r r& e s
zModuleSpec.__init__c C sf d | jd | jg}| jd ur|d | j | jd ur(|d | j d | jjd|S )Nz name={!r}z loader={!r}z origin={!r}z submodule_search_locations={}z{}({})z, ) r8 r r r appendr __class__r
join)r% rD r r r r; q s
zModuleSpec.__repr__c C sf | j }z$| j|jko&| j|jko&| j|jko&||j ko&| j|jko&| j|jkW S ty2 t Y S w r )r r r r cached has_locationr NotImplemented)r% othersmslr r r __eq__{ s
zModuleSpec.__eq__c C s: | j d u r| jd ur| jrtd u rtt| j| _ | j S r )r r r _bootstrap_externalNotImplementedError _get_cachedr: r r r r s
zModuleSpec.cachedc C s
|| _ d S r )r )r% r r r r r s
c C s | j du r
| jdd S | jS )z The name of the module's parent.N.r )r r
rpartitionr: r r r parent s
zModuleSpec.parentc C s | j S r )r r: 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& r; r propertyr setterr r r r r r r @ s" $
r r r c C s t |dr%tdu r ttj}|du r|| |dS |r g nd}|| ||dS |du rCt |drAz|| }W n
ty@ d}Y nw d}t| |||dS )z5Return a module spec based on various loader methods. get_filenameN)r )r r r Fr )r r r spec_from_file_locationr r` r )r r r r r searchr r r rq s&
rq c C s& z| j }W n ty Y nw |d ur|S | j}|d u r+z| j}W n ty* Y nw z| j}W n ty; d }Y nw |d u rW|d u rUz|j}W n
tyT d }Y nw |}z| j}W n tyg d }Y nw zt| j}W n tyz d }Y nw t |||d}|d u rdnd|_
||_ ||_ |S )Nr FT)
rz r r
ry r _ORIGIN
__cached__list__path__r r r r )rw r r rv r locationr r r r r _spec_from_module sT
r Foverridec C s |s
t |dd d u rz| j|_W n ty Y nw |s$t |dd d u rW| j}|d u rH| jd urHtd u r6ttj}| |}| j|_
|| _d |_ z||_ W n tyV Y nw |sat |dd d u rqz| j
|_W n typ Y nw z| |_W n ty Y nw |st |dd d u r| jd urz| j|_W n ty Y nw | jr|st |dd d u rz| j|_ W n ty Y nw |st |dd d u r| jd urz| j|_W |S ty Y |S w |S )Nr
ry __package__r r r )r r r
r r r r r _NamespaceLoader__new___pathr ry r r rz r r r r r )rv rw r r r r r r _init_module_attrs sr
r c C sR d}t | jdr| j| }n
t | jdrtd|du r"t| 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 r r r` r r r rv rw r r r module_from_spec4 s
r c C sd | j du rdn| j }| jdu r | jdu rd|S d|| jS | jr*d|| jS d| j | jS )z&Return the repr to use for the module.Nr| r} r~ r )r r r r8 r )rv r r r r r E s
r c
C s | j }t|{ tj||urd|}t||dzP| jdu r5| jdu r-td| j dt | |dd n(t | |dd t
| jdsWt | j d}t
|t | j| n| j| W tj| j }|tj| j < ntj| j }|tj| j < w W d |S 1 sw Y |S ) zFExecute the spec's specified module in an existing module's namespace.z module {!r} not in sys.modulesr Nmissing loaderTr r 7.exec_module() not found; falling back to load_module())r r? r rr r* r8 r` r r r r r rn ro
ImportWarning load_moduler pop)rv rw r ru r r r rs V s2
rs c C s z | j | j W n | jtjv r tj| j}|tj| j< tj| j}|tj| j< t|dd d u rFz| j |_W n tyE Y nw t|dd d u rlz|j |_
t |dsa| j dd |_
W n tyk Y nw t|dd d u rz| |_
W |S ty Y |S w |S )Nry r r r r rz )r r r r rr r r ry r r
r r r rz r r r r _load_backward_compatiblet sB
r c C s | j d ur t| j ds t| j d}t|t t| S t| }d| _zP|t j
| j < z| j d u r>| j d u r=t
d| j dn| j | W n zt j
| j = W tyY Y w t j
| j }|t j
| j < td| j | j W d| _|S d| _w )Nr r Tr r zimport {!r} # {!r}F)r r r rn ro r r r
_initializingr rr r r r` r rM r r\ )rv ru rw r r r _load_unlocked s<
r c C s6 t | j t| W d S 1 sw Y 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)r? r r rv r r r rt s $rt c @ s e Zd ZdZdZedd ZedddZeddd Z ed
d Z
ed d
Z ee dd Z
ee dd Zee 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.
zbuilt-inc C s" t dt d| jdtj dS )sReturn repr for the module.
The method is deprecated. The import machinery does the job itself.
zQBuiltinImporter.module_repr() is deprecated and slated for removal in Python 3.12z)rn ro rp r
r r rw r r r r{ s zBuiltinImporter.module_reprNc C s* |d urd S t |rt|| | jdS d S Nr )rG
is_builtinrq r clsrb pathtargetr r r find_spec s
zBuiltinImporter.find_specc C s* t dt | ||}|dur|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.
zjBuiltinImporter.find_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadN)rn ro rp r r )r rb r rv r r r find_module s
zBuiltinImporter.find_modulec C s. | j tjvrtd| j | j dttj| S )zCreate a built-in moduler^ r )r r r_ r` r8 rR rG create_builtinr r r r r s
z BuiltinImporter.create_modulec C s t tj| dS )zExec a built-in moduleN)rR rG exec_builtinr r r r r
s zBuiltinImporter.exec_modulec C dS )z9Return None as built-in modules do not have code objects.Nr r rb r r r get_code zBuiltinImporter.get_codec C r )z8Return None as built-in modules do not have source code.Nr r r r r
get_source r zBuiltinImporter.get_sourcec C r )z4Return False as built-in modules are never packages.Fr r r r r r r zBuiltinImporter.is_packageNNr )r
r r r r staticmethodr{ classmethodr r r r rh r r r rx 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 t dt d| jtjS )r zPFrozenImporter.module_repr() is deprecated and slated for removal in Python 3.12r )rn ro rp r8 r
r r )mr r r r{ / s zFrozenImporter.module_reprNc C s t |r
t|| | jdS d S r )rG rk rq r r r r r r : s
zFrozenImporter.find_specc C s t dt t|r
| S dS )z]Find a frozen module.
This method is deprecated. Use find_spec() instead.
ziFrozenImporter.find_module() is deprecated and slated for removal in Python 3.12; use find_spec() insteadN)rn ro rp rG rk )r rb r r r r r A s zFrozenImporter.find_modulec C r )z*Use default semantics for module creation.Nr r r r r r M s z FrozenImporter.create_modulec C s@ | j j}t|std||dttj|}t|| j d S rj )
rz r rG rk r` r8 rR get_frozen_objectexecr )rw r coder r r r Q s
zFrozenImporter.exec_modulec C s
t | |S )z_Load a frozen module.
This method is deprecated. Use exec_module() instead.
)rx r r r r r Z s
zFrozenImporter.load_modulec C
t |S )z-Return the code object for the frozen module.)rG r r r r r r d
zFrozenImporter.get_codec C r )z6Return None as frozen modules do not have source code.Nr r r r r r j r zFrozenImporter.get_sourcec C r )z.Return True if the frozen module is a package.)rG is_frozen_packager r r r r p r zFrozenImporter.is_packager r )r
r r r r r r{ r r r r r r rm r r r r r r r r $ s0
r c @ s e Zd ZdZdd Zdd ZdS )_ImportLockContextz$Context manager for the import lock.c C t dS )zAcquire the import lock.N)rG rH r: r r r rC } z _ImportLockContext.__enter__c C r )zY W d qY nw || ||}W d n1 sQw Y |dur|s| t jv rt j| }z|j } W n
t yx | Y S w | du r| S | S | S qdS )zFind a module's spec.Nz5sys.meta_path is None, Python is likely shutting downzsys.meta_path is empty) r meta_pathr` rn ro r rr r r r r rz )
r r r r is_reloadr r rv rw rz r r r
_find_spec sD
r c C sn t | tstdt| |dk rtd|dkr)t |ts#td|s)td| s3|dkr5tddS dS )z Verify arguments are "sane".z module name must be str, not {}r zlevel must be >= 0z __package__ not set to a stringz6attempted relative import with no known parent packagezEmpty module nameN)
isinstancestr TypeErrorr8 r
ValueErrorr` r r r r r r
_sanity_check s
r zNo module named z{!r}c C s d }| dd }|r@|tjvrt|| | tjv r tj| S tj| }z|j}W n ty? td | |}t|| dd w t | |}|d u rRtt| | dt
|}|rtj| }| dd }z t ||| W |S ty d|d|}t
|t Y |S w |S )Nr r z; {!r} is not a packager zCannot set an attribute on z for child module )r r rr rR r r _ERR_MSGr8 ModuleNotFoundErrorr r r
rn ro r ) r import_r r
parent_moduleru rv rw childr r r _find_and_load_unlocked s<
r c C s t | tj| t}|tu r t| |W d S W d n1 s&w Y |du r:d| }t|| dt| |S )zFind and load the module.Nz(import of {} halted; None in sys.modulesr ) r? r rr r* _NEEDS_LOADINGr r8 r rO )r r rw r[ r r r _find_and_load s
r r c C s* t | || |dkrt| ||} 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 ]h}t |ts |r| jd }nd}td| dt|j |dkr5|s4t| dr4t| | j|dd qt| |sjd | j|}zt || W q t
yi } z|j |krdt j
|td
urdW Y d
}~q d
}~ww 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 r8 rR r r r rr r* r )rw fromlistr r xwhere from_nameexcr r r r s6
r c C s | d}| d}|dur)|dur'||jkr'tjd|d|jdtdd |S |dur0|jS tjd tdd | d
}d | vrG|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 rz 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 rn ro r r )globalsr rv r r r _calc___package__B s*
r r c C s |dkr t | }n|dur|ni }t|}t | ||}|sJ|dkr*t | dd S | s.|S t| t| dd }tj|jdt|j| S t|drUt||t S |S )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 rr r
r r ) r r localsr r rw globals_r cut_offr r r
__import__] s
r c C s& t | }|d u rtd| t|S )Nzno built-in module named )r r r` r )r rv r r r _builtin_from_name s
r c
C s |a | att}tj D ]$\}}t||r1|tjv r t}n t |r&t }nq
t
||}t || q
tjt }dD ]}|tjvrEt
|} ntj| } t||| q9dS )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 rn rN N)rG r r rr itemsr r_ r rk r r r r
r r
)
sys_module _imp_module module_typer rw r rv self_module builtin_namebuiltin_moduler r r _setup 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 rr r
)r r r r _install_external_importers s r r r r )NNr r )6r r r rn rN r r r rI r) r5 r r r= r? rB rO rR r\ rh rm rx r r rq r r r r rs r r rt 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 sh M% e
-H $-PU
/
%
%#