211 lines
20 KiB
Plaintext
211 lines
20 KiB
Plaintext
|
Ë
|
|||
|
|
*åfzI ã ó� — d Z ddlmZ ddlmZ ddlZddlZddlZddl Z ddl
|
|||
|
|
Z ddl Z ddl m
|
|||
|
|
Z
|
|||
|
|
ddlZg d¢Z edd« Zd e_ d
|
|||
|
|
„ Zdd „Zdd „Zedd
|
|||
|
|
„« Zdd„Zej- ej. j0 e« ddlZddlmZ dd„Zej- ee« d„ Z dd„Z d„ Z d„ Z d„ Z!d„ Z"da#d„ Z$y# e $ r Y Œ w xY w)z Utilities to support packages.é )Ú
|
|||
|
|
namedtuple)ÚsingledispatchN)Ú
|
|||
|
|
ModuleType)
|
|||
|
|
Ú get_importerÚiter_importersÚ
|
|||
|
|
get_loaderÚ find_loaderÚ
|
|||
|
|
walk_packagesÚ iter_modulesÚget_dataÚ read_codeÚ extend_pathÚ
|
|||
|
|
ModuleInfor zmodule_finder name ispkgz.A namedtuple with minimal info about a module.c ó¬ — dd l }| j d« }|t j j k7 ry | j d« |j | « S )Nr é é )ÚmarshalÚreadÚ importlibÚutilÚ MAGIC_NUMBERÚload)Ústreamr Úmagics úCC:\Users\RCi\AppData\Local\Programs\Python\Python312\Lib\pkgutil.pyr
|
|||
|
|
r
|
|||
|
|
sC € ó à �K‰K˜‹N€EØ ” —‘×+Ñ+Ò+Øà
|
|||
|
|
‡K�K�„OØ �<‰<˜Ó Ð ó c # óæ K — i fd„}t | |« D ]� }|–— |j sŒ t |j « t t
|
|||
|
|
j |j dd« xs g } | D �cg c]
|
|||
|
|
} ||« rŒ |‘Œ } }t | |j dz |« E d{ –—† Œ‘ yc c}w 7 Œ # t $ r |� ||j « Y Œ¹t $ r |� ||j « n‚ Y ŒÙw xY ww)a« Yields ModuleInfo for all modules recursively
|
|||
|
|
on path, or, if path is None, all accessible modules.
|
|||
|
|
|
|||
|
|
'path' should be either None or a list of paths to look for
|
|||
|
|
modules in.
|
|||
|
|
|
|||
|
|
'prefix' is a string to output on the front of every module name
|
|||
|
|
on output.
|
|||
|
|
|
|||
|
|
Note that this function must import all *packages* (NOT all
|
|||
|
|
modules!) on the given path, in order to access the __path__
|
|||
|
|
attribute to find submodules.
|
|||
|
|
|
|||
|
|
'onerror' is a function which gets called with one argument (the
|
|||
|
|
name of the package which was being imported) if any exception
|
|||
|
|
occurs while trying to import a package. If no onerror function is
|
|||
|
|
supplied, ImportErrors are caught and ignored, while all other
|
|||
|
|
exceptions are propagated, terminating the search.
|
|||
|
|
|
|||
|
|
Examples:
|
|||
|
|
|
|||
|
|
# list all modules python can access
|
|||
|
|
walk_packages()
|
|||
|
|
|
|||
|
|
# list all submodules of ctypes
|
|||
|
|
walk_packages(ctypes.__path__, ctypes.__name__+'.')
|
|||
|
|
c ó — | |v ryd|| < y )NT© )ÚpÚms r Úseenzwalk_packages.<locals>.seenD s € Ø �‰6Ø؈ˆ!Šr Ú__path__Nú.)
|
|||
|
|
r ÚispkgÚ
|
|||
|
|
__import__ÚnameÚgetattrÚsysÚmodulesr
|
|||
|
|
Ú ImportErrorÚ Exception)ÚpathÚprefixÚonerrorr" Úinfor s r r
|
|||
|
|
r
|
|||
|
|
' sì è ø€ ð: ó ô
|
|||
|
|
˜T 6Ó*ò GˆØŠ
|
|||
|
|
à �:‹:ð
|
|||
|
|
Gܘ4Ÿ9™9Ô%ô œsŸ{™{¨4¯9©9Ñ 5°zÀ4ÓHÒNÈB�ð $(Ö7˜a©t°AwšÐ7�Ð7ä(¨¨t¯y©y¸©}¸gÓF×FÑFñ)Gùò$ 8àFùô ò
|
|||
|
|
'ØÐ&Ù˜DŸI™IÔ&ùÜ ò
|
|||
|
|
ØÐ&Ù˜DŸI™IÕ&àñ 'ð
|
|||
|
|
üsQ ‚%C1©B.¾0C1Á.
|
|||
|
|
B'Á<B'Â C1Â B,Â
|
|||
|
|
C1Â. C.Ã C1Ã
|
|||
|
|
C.Ã+C1Ã-C.Ã.C1c # óè K — | € t « }n+t | t « r t d« ‚t t
|
|||
|
|
| « }i }|D ]/ }t
|
|||
|
|
||« D ] \ }}||vsŒ d||< t |||« –— Œ Œ1 yw)a Yields ModuleInfo for all submodules on path,
|
|||
|
|
or, if path is None, all top-level modules on sys.path.
|
|||
|
|
|
|||
|
|
'path' should be either None or a list of paths to look for
|
|||
|
|
modules in.
|
|||
|
|
|
|||
|
|
'prefix' is a string to output on the front of every module name
|
|||
|
|
on output.
|
|||
|
|
Nz9path must be None or list of paths to look for modules iné )r Ú
|
|||
|
|
isinstanceÚstrÚ
|
|||
|
|
ValueErrorÚmapr Úiter_importer_modulesr )r- r. Ú importersÚyieldedÚir' r% s r r r ` s� è ø€ ð €|Ü"Ó$‰ Ü �Dœ#Ô Üð %ó &ð &ô œ dÓ+ˆ à€GØ
|
|||
|
|
ò 1ˆÜ0°°FÓ;ò 1‰KˆD�%ؘ7Ò"Ø !�˜‘
|
|||
|
|
Ü D¨%Ó0Ó0ñ 1ñ1ùs ‚AA2ÁA2c ó@ — t | d« sg S | j |« S )Nr )Úhasattrr )Úimporterr. s r r7 r7 z s" € ä �8˜^Ô ,؈ Ø × Ñ Ó (Ð(r c # ó® K — | j �)t j j | j « sy i }dd l} t j | j « }|j
|
|||
|
|
« |D ]¾ }|j |« }|dk( s||v rŒ t j j | j |« }d}|s]t j j |« r>d|vr:|} t j |« } | D ] }|j |« }
|
|||
|
|
|
|
|||
|
|
dk( sŒd} n Œ©|sŒ¬d|vsŒ±d||< ||z |f–— ŒÀ y # t
|
|||
|
|
$ r g }Y ·w xY w# t
|
|||
|
|
$ r g } Y ŒYw xY ww)Nr Ú__init__Fr$ Tr2 ) r- ÚosÚisdirÚinspectÚlistdirÚOSErrorÚsortÚ
|
|||
|
|
getmodulenameÚjoin) r= r. r9 rB Ú filenamesÚfnÚmodnamer- r% Ú dircontentsÚsubnames r Ú_iter_file_finder_modulesrM ‚ sS è ø€ ؇}�}Ð ¤B§G¡G§M¡M°(·-±-Ô$@Øà€GÛðÜ—J‘J˜xŸ}™}Ó-ˆ ð ‡N�NÔàò *ˆØ×'Ñ'¨Ó+ˆØ �JÒ '¨WÑ"4Ø ä�w‰w�|‰|˜HŸM™M¨2Ó.ˆØˆáœ2Ÿ7™7Ÿ=™=¨Ô.°3¸b±=؈Gð
|
|||
|
|
!Ü Ÿj™j¨Ó .� ð "ò
|
|||
|
|
�Ø!×/Ñ/°Ó3�ؘJÓ&Ø �EÙð
|
|||
|
|
ð â �s 'Ò)Ø ˆG�GÑ Ø˜7Ñ" EÐ)Ó )ñ3*øô ò àŠ ðûô" ò
|
|||
|
|
!à ’ ð
|
|||
|
|
!üs` ‚=EÁ D3 Á BEÃ#EÃ8EÄEÄ EÄ"EÄ3 EÄ>EÅ EÅEÅ EÅEÅEÅE)Ú zipimporterc # ó
|
|||
|
|
K — t t j | j « }| j }t |« }i }dd l}|D ]· }|j |« sŒ||d j t j « }t |« dk( r/|d j d« r|d |vrd||d < ||d z df–— t |« dk7 rŒƒ|j |d « }|dk( rŒ�|sŒ d|vsŒ¥||vsŒªd||< ||z df–— Œ¹ y w) Nr é r2 z __init__.pyTr? r$ F) ÚsortedÚ zipimportÚ_zip_directory_cacheÚarchiver. ÚlenrB Ú
|
|||
|
|
startswithÚsplitr@ ÚseprF ) r= r. ÚdirlistÚ_prefixÚplenr9 rB rI rJ s r Úiter_zipimport_modulesr\ ² s è ø€ Üœ×7Ñ7¸×8HÑ8HÑIÓJˆØ—/‘/ˆÜ�7‹|ˆØˆÛØò .ˆBØ—=‘= Ô)Øà�D�E�— ‘ ¤§¡Ó(ˆBä�2‹w˜Šz˜b ™e× .Ñ .¨}Ô =Ø�a‘5 Ñ'Ø%&�G˜B˜q™E‘NØ 2 a¡5™.¨$Ð.Ò.ä�2‹w˜ŠzØà ×+Ñ+¨B¨q©EÓ2ˆGؘ
|
|||
|
|
Ò"Øâ˜3 gÒ-°'ÀÒ2HØ#$�˜Ñ Ø ˜wÑ&¨Ð-Ó-ñ) .ùs ‚C%DÃ(DÃ-DÃ2Dc ó — t j | « } t j | }|S # t $ rV t j
|
|||
|
|
D ]= } || « }t j j
|
|||
|
|
| |« Y |S # t $ r Y Œ;w xY w d}Y |S w xY w)zÿRetrieve a finder for the given path item
|
|||
|
|
|
|||
|
|
The returned finder is cached in sys.path_importer_cache
|
|||
|
|
if it was newly created by a path hook.
|
|||
|
|
|
|||
|
|
The cache (or part of it) can be cleared manually if a
|
|||
|
|
rescan of sys.path_hooks is necessary.
|
|||
|
|
N)r@ Úfsdecoder) Úpath_importer_cacheÚKeyErrorÚ
|
|||
|
|
path_hooksÚ
|
|||
|
|
setdefaultr+ )Ú path_itemr= Ú path_hooks r r r Ô s¡ € ô — ‘ ˜IÓ&€Ið Ü×*Ñ*¨9Ñ5ˆð €Oøô ò Ü Ÿ ™ ò ˆIð
|
|||
|
|
Ù$ YÓ/�Ü×'Ñ'×2Ñ2°9¸hÔGÙð
|
|||
|
|
€Oøô ò
|
|||
|
|
Ùð
|
|||
|
|
úð ð ‰HØ €Oð ús3 —, ¬ B Á (A5Á1B Á5 BÁ>B Â BÂB Â
|
|||
|
|
B c # ó\ K — | j d« r dj | « }t |« ‚d| v r9| j d« d }t j
|
|||
|
|
|« }t
|
|||
|
|
|dd« }|€)yt j E d{ –—† t j }|D ] }t |« –— Œ y7 Œ)w)a¹ Yield finders for the given module name
|
|||
|
|
|
|||
|
|
If fullname contains a '.', the finders will be for the package
|
|||
|
|
containing fullname, otherwise they will be all registered top level
|
|||
|
|
finders (i.e. those on both sys.meta_path and sys.path_hooks).
|
|||
|
|
|
|||
|
|
If the named module is in a package, that package is imported as a side
|
|||
|
|
effect of invoking this function.
|
|||
|
|
|
|||
|
|
If no module name is specified, all top level finders are produced.
|
|||
|
|
r$ ú'Relative module name {!r} not supportedr r# N) rV Úformatr+ Ú
|
|||
|
|
rpartitionr Ú
|
|||
|
|
import_moduler( r) Ú meta_pathr- r )ÚfullnameÚmsgÚpkg_nameÚpkgr- Úitems r r r í s¨ è ø€ ð ×ј3Ô Ø7×>Ñ>¸xÓHˆÜ˜#Ó Ð Ø
|
|||
|
|
ˆh�à×&Ñ& sÓ+¨AÑ.ˆÜ×%Ñ% hÓ/ˆÜ�s˜J¨Ó-ˆØ ˆ<Ø ä—=‘=× Ð Ü�x‰xˆØò !ˆÜ˜4Ó Ó ñ!ð !ús ‚A>B, B*Â*B,c óN — t j dt j › d�d¬« | t j v rt j | } | €yt | t « r8| }t |dd« }|�|S t |dd« €y|j }t |« S | }t |« S )zøGet a "loader" object for module_or_name
|
|||
|
|
|
|||
|
|
Returns None if the module cannot be found or imported.
|
|||
|
|
If the named module is not already imported, its containing package
|
|||
|
|
(if any) is imported, in order to establish the package __path__.
|
|||
|
|
zpkgutil.get_loaderú(; use importlib.util.find_spec() instead©é é ©ÚremoveNÚ
|
|||
|
|
__loader__Ú__spec__)
|
|||
|
|
ÚwarningsÚ _deprecatedÚ_DEPRECATED_MSGr) r* r3 r r( Ú__name__r )Úmodule_or_nameÚmoduleÚloaderrk s r r r
|
|||
|
|
s· € ô
|
|||
|
|
×ÑÐ-Ü $× 4Ñ 4Ð5ð 6Bð Bà 'õ)𠜟™Ñ$Ü Ÿ™ ^Ñ4ˆØ Ð !ØÜ�.¤*Ô-Ø ˆÜ˜ ¨tÓ4ˆØ Р؈MÜ �6˜: tÓ ,Ð 4ØØ—?‘?ˆô �xÓ Ð ð "ˆÜ �xÓ Ð r c ó — t j dt j › d�d¬« | j d« r dj | « }t |« ‚ t j j | « }|� |j S dS # t
|
|||
|
|
t t t f$ r-}d}t |j | t |« |« « |‚d}~ww xY w) zàFind a "loader" object for fullname
|
|||
|
|
|
|||
|
|
This is a backwards compatibility wrapper around
|
|||
|
|
importlib.util.find_spec that converts most failures to ImportError
|
|||
|
|
and only returns the loader rather than the full spec
|
|||
|
|
zpkgutil.find_loaderrq rr ru r$ rf z,Error while finding loader for {!r} ({}: {})N)ry rz r{ rV rg r+ r r Ú find_specÚAttributeErrorÚ TypeErrorr5 Útyper )rk rl ÚspecÚexs r r r & sÍ € ô
|
|||
|
|
×ÑÐ.Ü $× 4Ñ 4Ð5ð 6Bð Bà 'õ)ð ×ј3Ô Ø7×>Ñ>¸xÓHˆÜ˜#Ó Ð ðFÜ�~‰~×'Ñ'¨Ó1ˆð Ð*ˆ4�;‰;Ð4°Ð4øô
|
|||
|
|
|
|||
|
|
œ ¬´JÐ ?ò Fð =ˆÜ˜#Ÿ*™* X¬t°B«x¸Ó<Ó=À2ÐEûð Fús Á B ÂC
|
|||
|
|
 (CÃC
|
|||
|
|
c óâ — t | t « s| S |dz }| dd } |j d« \ }}}|r t j | j
|
|||
|
|
}nt j }|D �]% }t |t « sŒt |« }|�og } t |d« r$|j |« }
|
|||
|
|
|
|
|||
|
|
�1|
|
|||
|
|
j xs g } n t |d« r|j |« \ }} | D ] } | | vsŒ| j | « Œ t j j# ||« } t j j% | « sŒÑ t' | « }
|
|||
|
|
|
|
|||
|
|
5 |
|
|||
|
|
D ]8 }|j) d« }|r|j+ d« rŒ(| j |« Œ: ddd« �Œ( | S # t t f$ r | cY S w xY w# 1 sw Y �ŒLxY w# t, $ r1}t j. j1 d| ›d |›d�« Y d}~�Œ„d}~ww xY w)
|
|||
|
|
a¢ Extend a package's path.
|
|||
|
|
|
|||
|
|
Intended use is to place the following code in a package's __init__.py:
|
|||
|
|
|
|||
|
|
from pkgutil import extend_path
|
|||
|
|
__path__ = extend_path(__path__, __name__)
|
|||
|
|
|
|||
|
|
For each directory on sys.path that has a subdirectory that
|
|||
|
|
matches the package name, add the subdirectory to the package's
|
|||
|
|
__path__. This is useful if one wants to distribute different
|
|||
|
|
parts of a single logical package as multiple directories.
|
|||
|
|
|
|||
|
|
It also looks for *.pkg files beginning where * matches the name
|
|||
|
|
argument. This feature is similar to *.pth files (see site.py),
|
|||
|
|
except that it doesn't special-case lines starting with 'import'.
|
|||
|
|
A *.pkg file is trusted at face value: apart from checking for
|
|||
|
|
duplicates, all entries found in a *.pkg file are added to the
|
|||
|
|
path, regardless of whether they are exist the filesystem. (This
|
|||
|
|
is a feature.)
|
|||
|
|
|
|||
|
|
If the input path is not a list (as is the case for frozen
|
|||
|
|
packages) it is returned unchanged. The input path is not
|
|||
|
|
modified; an extended copy is returned. Items are only appended
|
|||
|
|
to the copy at the end.
|
|||
|
|
|
|||
|
|
It is assumed that sys.path is a sequence. Items of sys.path that
|
|||
|
|
are not (unicode or 8-bit) strings referring to existing
|
|||
|
|
directories are ignored. Unicode items of sys.path that cause
|
|||
|
|
errors when used as filenames may cause this function to raise an
|
|||
|
|
exception (in line with os.path.isdir() behavior).
|
|||
|
|
z.pkgNr$ r� r ú
|
|||
|
|
ú#z Can't open z: )r3 Úlistrh r) r* r# r` r‚ r- r4 r r< r� Úsubmodule_search_locationsr Úappendr@ rG ÚisfileÚopenÚrstriprV rD ÚstderrÚwrite)r- r' Ú sname_pkgÚparent_packageÚ_Ú
|
|||
|
|
final_nameÚ search_pathÚdirÚfinderÚportionsr… ÚportionÚpkgfileÚfÚlinerl s r r r ? sî € ôB �dœDÔ !ð ˆ à�v‘
|
|||
|
|
€Ià ‘ˆ7€Dà$(§O¡O°CÓ$8Ñ!€N�A�zÙð Ü Ÿ+™+ nÑ5×>Ñ>‰Kô —h‘hˆ àó $*ˆÜ˜#œsÔ#Ø ä ˜cÓ"ˆØ Р؈HÜ�v˜{Ô+Ø ×'Ñ'¨
|
|||
|
|
Ó3�ØÐ#Ø #× >Ñ >Ò DÀ"‘Hä˜ Ô/Ø $× 0Ñ 0°Ó <‘ ��8à#ò
|
|||
|
|
)�ð $Ò&Ø—K‘K Õ(ð
|
|||
|
|
)ô —'‘'—,‘,˜s IÓ.ˆÜ
|
|||
|
|
�7‰7�>‰>˜'Õ "ð
|
|||
|
|
*ܘ“M�ð
|
|||
|
|
ñ *Ø !ò *˜Ø #Ÿ{™{¨4Ó 0˜Ù # t§¡°sÔ';Ø $Ø Ÿ ™ DÕ)ñ *÷*ñ *ð?$*ðL €Køô[ œ.Ð)ò ð ŠKð ú÷L*ñ *ûô ò
|
|||
|
|
1Ü—
|
|||
|
|
‘
|
|||
|
|
× Ò Ú")ª3ð"0÷ 1ò 1ûð
|
|||
|
|
1ús5 µ F Ä7 F4Å>F'ÆF$Æ#F$Æ'F1 Æ4 G.Æ=&G)Ç)G.c ó — t j j | « }|€y|j }|� t |d« syt
|
|||
|
|
j j | « xs t j j |« }|� t |d« sy|j d« }|j dt j j |j « « t j j |Ž }|j# |« S )af Get a resource from a package.
|
|||
|
|
|
|||
|
|
This is a wrapper round the PEP 302 loader get_data API. The package
|
|||
|
|
argument should be the name of a package, in standard module format
|
|||
|
|
(foo.bar). The resource argument should be in the form of a relative
|
|||
|
|
filename, using '/' as the path separator. The parent directory name '..'
|
|||
|
|
is not allowed, and nor is a rooted name (starting with a '/').
|
|||
|
|
|
|||
|
|
The function returns a binary string, which is the contents of the
|
|||
|
|
specified resource.
|
|||
|
|
|
|||
|
|
For packages located in the filesystem, which have already been imported,
|
|||
|
|
this is the rough equivalent of
|
|||
|
|
|
|||
|
|
d = os.path.dirname(sys.modules[package].__file__)
|
|||
|
|
data = open(os.path.join(d, resource), 'rb').read()
|
|||
|
|
|
|||
|
|
If the package cannot be located or loaded, or it uses a PEP 302 loader
|
|||
|
|
which does not support get_data(), then None is returned.
|
|||
|
|
Nr Ú__file__ú/r )r r r� r r< r) r* ÚgetÚ
|
|||
|
|
_bootstrapÚ_loadrW Úinsertr@ r- ÚdirnamerŸ rG r )ÚpackageÚresourcer… r ÚmodÚpartsÚ
|
|||
|
|
resource_names r r r � sÉ € ô, �>‰>× #Ñ # GÓ ,€DØ €|ØØ
|
|||
|
|
�[‰[€FØ
|