w e r ddl?m@Z@ d
d lAmBZB e d e( ZC ejD eE ZF G d d e ZGd!ZHd"ZI G d# d$e" ZJ G d% d&e ZK G d' d( ZL G d) d*eL ZM G d+ d, ZNd_d1ZOd`d5ZPdad<ZQd= ZRdbdAZSdbdBZTdcdEZUdddGZVdedIZWdfdLZXdgdMZYdhdRZZdidTZ[ G dU dVe'j\ Z]dWZ^djd\Z_ G d] d^e&j` ZadS )ka
Create a wheel that, when installed, will make the source package 'editable'
(add it to the interpreter's path, including metadata) per PEP 660. Replaces
'setup.py develop'.
.. note::
One of the mechanisms briefly mentioned in PEP 660 to implement editable installs is
to create a separated directory inside ``build`` and use a .pth file to point to that
directory. In the context of this file such directory is referred as
*auxiliary build directory* or ``auxiliary_dir``.
) annotationsN)IterableIteratorMapping)suppress)Enum)cleandoc)chainstarmap)Path)TemporaryDirectory)
TracebackType)
TYPE_CHECKINGProtocolTypeVarcast )Command_normalization_path_shutilerrors
namespaces)StrPath)py310py312find_package_path) Distribution)InformationOnly SetuptoolsDeprecationWarning )build)build_py) dist_info)egg_info)install)install_scripts)Self WheelFile_P)boundc 6 e Zd ZdZdZdZdZed
d Zd S )
_EditableModea
Possible editable installation modes:
`lenient` (new files automatically added to the package - DEFAULT);
`strict` (requires a new installation when files are added/removed); or
`compat` (attempts to emulate `python setup.py develop` - DEPRECATED).
strictlenientcompatmode
str | Nonereturnc |s t j S | }|t j vrt j d|d |dk rt
j ddd t | S )NzInvalid editable mode: z. Try: 'strict'.COMPATzCompat editable installsa
The 'compat' editable mode is transitional and will be removed
in future versions of `setuptools`.
Please adapt your code accordingly to use either the 'strict' or the
'lenient' modes.
z userguide/development_mode.html)see_docs)r/ LENIENTupper __members__r OptionErrorr! emit)clsr3 _modes s/builddir/build/BUILD/cloudlinux-venv-1.0.12/venv/lib/python3.11/site-packages/setuptools/command/editable_wheel.pyconvertz_EditableMode.convertA s ) ( (
1 1 1$%Wt%W%W%WXX X H ( -* ;
U## N)r3 r4 r5 r/ ) __name__
__module__ __qualname____doc__STRICTr9 r7 classmethodrA rB r@ r/ r/ 5 sM FG
F$ $ $ [$ $ $rB r/ zU
New or renamed files may not be automatically picked up without a new installation.
zt
Options like `package-data`, `include/exclude-package-data` or
`packages.find.exclude/include` may have no effect.
c e Zd ZdZdZdddd eej pd fgZd Zd&d Z d&d Z
d
Z d Z d'dZ
d(dZd Zd)dZd*d Zd&d Zd+d Zd Zd,d"Zd-d%ZdS ).editable_wheelzBuild 'editable' wheel for development.
This command is private and reserved for internal use of setuptools,
users should rely on ``setuptools.build_meta`` APIs.
zBDO NOT CALL DIRECTLY, INTERNAL ONLY: create PEP 660 editable wheel)z dist-dir=dz-directory to put final built distributions in)zdist-info-dir=Iz(path to a pre-build .dist-info directoryzmode=N c > d | _ d | _ d | _ d | _ d S N)dist_dir
dist_info_dir project_dirr3 selfs r@ initialize_optionsz!editable_wheel.initialize_optionsv s$
! rB r5 Nonec | j }|j p t j | _ |j pi | _ t
| j p$t j | j d | _ d S )Ndist)
distributionsrc_rootoscurdirrS package_dirr rQ pathjoin)rU rY s r@ finalize_optionsz editable_wheel.finalize_options| sX =5BI +1r T] Tbgll4;KV.T.TUU
rB c | j d | | d | d }| | j | | d S # t $ rD}| j j
p| j }t j
|d| d d }~ww xY w)NT)exist_ok bdist_wheelz3An error occurred when building editable wheel for zl.
See debugging tips in: https://setuptools.pypa.io/en/latest/userguide/development_mode.html#debugging-tips)rQ mkdir_ensure_dist_inforeinitialize_commandget_finalized_commandwrite_wheelfilerR _create_wheel_file ExceptionrZ nameget_namer add_note)rU rd exprojects r@ runzeditable_wheel.run s M . . . " " $ $ $
% %m 4 4 4 44]CCK ' '(: ; ; ; # #K 0 0 0 0 0 ',L0A0J0J0L0LG Nfg f f f
s BB
C?CCc | j jt t | d }| j |_ | | |j | _ d S t | j d sJ t | j d sJ d S )Nr% z
.dist-infoMETADATA) rR r
dist_info_clsrg rQ
output_dirensure_finalizedrq strendswithr exists)rU r% s r@ rf z editable_wheel._ensure_dist_info s % ]D,E,Ek,R,RSSI#'=I & & ( ( ( MMOOO!*!8D t)**33LAA A AA*J77>>@@ @ @@ @ @rB c | j }|j sd S t | j | j dd }t |||| }| d S )NrN .) rZ namespace_packagesr rS r^ getresolve_NamespaceInstallerinstall_namespaces)rU installation_dir
pth_prefixrY r[ installers r@ _install_namespacesz"editable_wheel._install_namespaces sw & F($*:*>*>r3*G*GHHPPRR'.>
HUU $$&&&&&rB r4 c | j rt | j j n
t }t t | d }t
|d S )Nz
*.egg-info)rR r parentmaprw globnext)rU
parent_dir
candidatess r@ _find_egg_info_dirz!editable_wheel._find_egg_info_dir sT 8<8JVT$,--44PTPVPV
jool ; ;<<
J%%%rB rl rw unpacked_wheelr build_libtmp_dirc | j }t | }t | }t t || dd }t t || dd }t t || dd } t t | dd }
t | |
_ d|
_ t t | dd } t t | d d } |x| _
x| _ | _ |x| _
x| _ | _ | x| _ | _ || _ || _ | d
}
d |
_ t t, | d }d|_ t | | _ t t2 | d
}d|_ | |_ | | | dS )a Configure commands to behave in the following ways:
- Build commands can write to ``build_lib`` if they really want to...
(but this folder is expected to be ignored and modules are expected to live
in the project directory...)
- Binary extensions should be built in-place (editable_mode = True)
- Data/header/script files are not part of the "editable" specification
so they are written directly to the unpacked_wheel directory.
z.datadataheadersscriptsr& T)reinit_subcommandsr# r'
build_scriptspythonr( r$ FN) rZ rw r r egg_info_clsrg egg_baseignore_egg_info_in_manifest build_cls install_cls
build_platlib
build_purelibr install_purelibinstall_platlib install_libr( r install_headers install_dataget_command_obj
executableinstall_scripts_clsno_ep
build_temp build_py_clscompiler existing_egg_info_dir_set_editable_moderv )rU rl r r r rY wheelr r r r& r# r' r r( r$ s r@ _configure_buildz editable_wheel._configure_build s4 N## NN 44??@@d>d>>>9EEFFd>d>>>9EEFF $33JSW3XX
LL/3, t00T0RR
229QU2VV
GPOOe 1EORWW W'"9G>>g~ rB dist_namec | |||| | | \ }}| d | d | d ||fS )Nr r r )r _run_build_subcommandsr _run_install)rU r r r r r r s r@ _run_build_commandsz"editable_wheel._run_build_commands s
i GLLL ##%%% 4466w )$$$ )$$$ &!!!g~ rB c | d }| D ]^}| | }|dk r,t | t ur| | I| | _dS )a}
Issue #3501 indicates that some plugins/customizations might rely on:
1. ``build_py`` not running
2. ``build_py`` always copying files to ``build_lib``
However both these assumptions may be false in editable_wheel.
This method implements a temporary workaround to support the ecosystem
while the implementations catch up.
r# r$ N)rh r typer _safely_run run_command)rU r# rl r s r@ r z%editable_wheel._run_build_subcommands s **733**,, ' 'D,,T22Cz!!d3ii|&C&C &&&& &&&& ' 'rB r c | | S # t $ r4 t j ddt j d| d| d Y d S w xY w)Nz0Customization incompatible with editable installz
z
If you are seeing this warning it is very likely that a setuptools
plugin or customization overrides the `a ` command, without
taking into consideration how editable installs run build steps
starting from setuptools v64.0.0.
Plugin authors and developers relying on custom build steps are
encouraged to update their `aa ` implementation considering the
information about editable installs in
https://setuptools.pypa.io/en/latest/userguide/extension.html.
For the time being `setuptools` will silence this error and ignore
the faulty command, but this behavior will change in future versions.
)r rk r! r= traceback
format_exc)rU r s r@ r zeditable_wheel._safely_run. s ##H-- - ( -B%'' 9A .6
s :AAc
ddl m} | d }|j }d | }d}| d| d| d}t
| j | }| r| t | } t d }
t d } | 5 } |
5 }
| 5 }t
| t
| j j }t j
| j | | | | | || |
| \ }}| |||
}|5 ||d
5 } |||| | | d d d n # 1 swxY w Y d d d n # 1 swxY w Y d d d n # 1 swxY w Y d d d n # 1 swxY w Y d d d n # 1 swxY w Y |S ) Nr r* r% -z
0.editablez.whl)suffixz
.build-libz .build-tempw)wheel.wheelfiler+ rh rl r` get_tagr rQ ry unlinkr
rR shutilcopytreer r _select_strategy write_files)rU rd r+ r% r tag build_tag archive_name
wheel_pathr r build_tmpunpackedlibtmpunpacked_dist_infor r strategy wheel_objs r@ rj z!editable_wheel._create_wheel_fileJ sH ------..{;; N hh{**,,-- #;;i;;#;;; $- 66
+<@@@&l;;; &m<<<
0x 0c9 0!%hT5G0H0H0M!N!N OD .0B C C C $ $Xy 9 9 9 ! 5 5i3PS T TNE7,,YSAAH
0
099Z55
0E7333%%h///
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 s G0 G B G
F+ %#F F+ FF+ F F+ G+F/
/G2F/
3G6 GG G G
G
G0G G0 G !G00G47G4categoryc t | j d| d }|rB | r:t d| d | d| d S d S d S )Nhas_z Installing z as non editableinstall_)getattrrZ _loggerinfor )rU r has_categorys r@ r zeditable_wheel._run_installf s t 02C2C2CTJJ 4LLNN 4 LLAxAAA B B B 2 2 2 3 3 3 3 3 4 4 4 4rB r EditableStrategyc \ d| d| }t | j }t | j }|t j u r:t
t | j d| }t | j ||| S t | j }t || j | } |t j u }
t | j dhk r| s|
r@| j dd } t | j |t || g S t! | j | S )zDDecides which strategy to use to implement an editable installation.
__editable__.r r# rN r{ )r rS r/ rA r3 rG
_empty_dir _LinkTreerZ _find_packages_simple_layoutr^ r7 setr}
_StaticPth_TopLevelFinder) rU rl r r
build_namerS r3
auxiliary_dirpackageshas_simple_layoutis_compat_modesrc_dirs r@ r z editable_wheel._select_strategyl s# 2T11C11
4+,, $$TY// =' ' ' &tD, (. (&**2s33G d /['8R8R7STT T t 0$777rB r5 rW )r5 r4 )rl rw r r r r r r )r5 r )
r rw r r r r r r r5 r )r rw )r rw )rl rw r rw r r r5 r )rC rD rE rF descriptionr r/ user_optionsrV ra rq rf r r r r r r r r rj r r rI rB r@ rK rK h sm
WK LK $ !6!<"==>L V V V V * A A A' ' '& & & &
=# =# =# =#~ # # #
' ' ' ', 8 84 4 4 4 8 8 8 8 8 8rB rK c & e Zd Zdd Zdd ZddZdS )r r r+ r list[str]r Mapping[str, str]r5 objectc d S rP rI )rU r r r s r@ __call__zEditableStrategy.__call__ s rB r) c d S rP rI rT s r@ __enter__zEditableStrategy.__enter__ s rB _exc_typetype[BaseException] | None
_exc_valueBaseException | None
_tracebackTracebackType | Nonec d S rP rI rU r r r s r@ __exit__zEditableStrategy.__exit__ s
rB N)r r+ r r r r r5 r r5 r) )r r r r r r r5 r )rC rD rE r r r rI rB r@ r r sJ %$$$ rB r c . e Zd Zdd ZddZddZd dZdS ) r rY r rl rw path_entries
list[Path]r5 rW c 0 || _ || _ || _ d S rP )rY rl r )rU rY rl r s r@ __init__z_StaticPth.__init__ s (rB r r+ r r r r c d d | j D }t | d }| d| j d| d S )N
c 3 X K | ]%}t | V &d S rP )rw r~ ).0ps r@ z&_StaticPth.__call__.. s2 HHC , ,HHHHHHrB r .pth)r` r _encode_pthwritestrrl )rU r r r entriescontentss r@ r z_StaticPth.__call__ sb ))HHd6GHHHHH '~~~..
6ty666AAAAArB r) c dt t t j | j d}t
|t z | S )Nz_
Editable install will be performed using .pth file to extend `sys.path` with:
z
)listr r\ fspathr r warning_LENIENT_WARNINGrU msgs r@ r z_StaticPth.__enter__ sQ
c")T .// 0 0 ../// rB r r r r c d S rP rI r
s r@ r z_StaticPth.__exit__ s
rB N)rY r rl rw r r r5 rW r r+ r r r r r5 rW r r r r r r r r5 rW )rC rD rE r r r r rI rB r@ r r sh ) ) ) )
B B B B
rB r c Z e Zd ZdZd# fd Zd$ fd Zd%dZd&d'dZd(dZd)d Z d*d"Z
xZ S )+r a`
Creates a ``.pth`` file that points to a link tree in the ``auxiliary_dir``.
This strategy will only link files (not dirs), so it can be implemented in
any OS, even if that means using hardlinks instead of symlinks.
By collocating ``auxiliary_dir`` and the original source code, limitations
with hardlinks should be avoided.
rY r rl rw r r r r5 rW c t | | _ t | | _ | d j | _ t ||| j g d S )Nr$ ) r r r~ r r copy_file_filesuperr )rU rY rl r r __class__s r@ r z_LinkTree.__init__ sn "- 0 0 i 0022))*55?
td&8%9:::::rB r r+ r r r r c z | || t ||| d S rP )
_create_linksr+ r )rU r r r r, s r@ r z_LinkTree.__call__ s=
5'***
w/////rB filer4 c * t t 5 t | | j }t
| t j d cd d d S # 1 swxY w Y d S )N/)
r
ValueErrorr r~ relative_tor rw replacer\ sep)rU r/ r_ s r@ _normalize_outputz_LinkTree._normalize_output s
j
!
! 2 2::%%''33DNCCDt99$$RVS11 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 ts A&BB B Nrelative_outputsrc_filec | j |z }|j s|j d | ||| d S )NT)parentslink)r r is_dirre r* )rU r7 r8 r< dests r@ _create_filez_LinkTree._create_file s\ !O3{!!## , K d + + +
8T
-----rB output_mappingc j dd t j rdnd} fd| D }d |D }|D ]3} | }|r||vr || 4| D ] \ }} ||| d S )NT)r: rc symhardc 3 L K | ] \ }} | |fV d S rP )r6 )r kvrU s r@ r z*_LinkTree._create_links.. s: XXAt--a00!4XXXXXXrB c i | ]
\ }}||| S rP rI )r rE rF s r@
z+_LinkTree._create_links.. s AAATQ1=Aq===rB r; )r re _can_symlink_filesitemsr6 r? ) rU outputsr@ link_type
normalisedmappingsoutputrelativesrcs ` r@ r. z_LinkTree._create_links s === /0B C COEE XXXX AUAUAWAWXXX
AAZAAA 4 4F--f55H
4HH 4 4!!(F333 %^^ - - = =MHc h) < < < < = =rB r) c N d}t |t z | S )Nz=Strict editable install will be performed using a link tree.
)r r _STRICT_WARNINGr" s r@ r z_LinkTree.__enter__ s# No-... rB r r r r c F d| j d}t j d| d S )Nz\
Strict editable installation performed using the auxiliary directory:
z
Please be careful to not remove this directory, otherwise you might not be able
to import/use your package.
Editable installation.)r r r= rU r r r r# s r@ r z_LinkTree.__exit__ s:
5s;;;;;rB )
rY r rl rw r r r r r5 rW r% )r/ rw r5 r4 rP )r7 rw r8 rw )r@ r r r& ) rC rD rE rF r r r6 r? r. r r
__classcell__)r, s @r@ r r s
;
;
;
;
;
;0 0 0 0 0 0 . . . . .
=
=
=
=
<
<
<
<
<
<
<
e Zd ZddZd d Zd d Zd dZd dZd dZdS )!r rY r rl rw r5 rW c " || _ || _ d S rP )rY rl )rU rY rl s r@ r z_TopLevelFinder.__init__ s rB 5tuple[str, str, dict[str, str], dict[str, list[str]]]c j j p t j }t t j t
j } j j pi }t ||| t t t j j pg d t D } fd j j
pg D }i |}d j d}t j | }||||fS )Nc 3 K | ]}|g fV d S rP rI )r nss r@ r z0_TopLevelFinder.template_vars.. s& DDb"bDDDDDDrB c L i | ] }|t |j j pd !S )rN )r rY r[ )r pkgrootsrU s r@ rH z1_TopLevelFinder.template_vars.. sB
"3ty/A/GRHH
rB r z.finder)rY r[ r\ r] r
r _find_top_level_modulesr^ _find_package_rootsdict_find_namespacesr _find_virtual_namespacesr| rl r safe_identifier)
rU r[ top_levelr^ namespaces_legacy_namespacesr rl finderr` s
` @r@
template_varsz _TopLevelFinder.template_vars s# 9%2.335LTY5W5WXX i+1r #I{HEE !3!9r5AADD$>> _simple_layout(['a'], {"": "src"}, "/tmp/myproj")
True
>>> _simple_layout(['a', 'a.b'], {"": "src"}, "/tmp/myproj")
True
>>> _simple_layout(['a', 'a.b'], {}, "/tmp/myproj")
True
>>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"": "src"}, "/tmp/myproj")
True
>>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "a", "b": "b"}, ".")
True
>>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a", "b": "_b"}, ".")
False
>>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a": "_a"}, "/tmp/myproj")
False
>>> _simple_layout(['a', 'a.a1', 'a.a1.a2', 'b'], {"a.a1.a2": "_a2"}, ".")
False
>>> _simple_layout(['a', 'a.b'], {"": "src", "a.b": "_ab"}, "/tmp/myproj")
False
>>> # Special cases, no packages yet:
>>> _simple_layout([], {"": "src"}, "/tmp/myproj")
True
>>> _simple_layout([], {"a": "_a", "": "src"}, "/tmp/myproj")
False
c 4 i | ]}|t | S rI r )r r_ r^ rS s r@ rH z"_simple_layout.. s(
X
X
Xc$S+{CC
X
X
XrB rN c 3 K | ]:\ }}t j t g| d R | V ;dS r{ N)r same_pathr split)r keyvaluer s r@ r z!_simple_layout.. sa C V5ciinn555u== rB )r r\ r_
commonpathr _parent_pathrJ all)r r^ rS layoutr s `` @r@ r r j s > Y
X
X
X
Xx
X
X
XF .; B:--
W
fllnn E E
F
FF ,,.. rB c p | | }| dt j z S )a7 Infer the parent path containing a package, that if added to ``sys.path`` would
allow importing that package.
When ``pkg`` is directly mapped into a directory with a different name, return its
own path.
>>> _parent_path("a", "src/a")
'src'
>>> _parent_path("b", "src/c")
'src/c'
r1 ) removesuffixrstripr\ r5 )r_ pkg_pathr s r@ r r s/
"
"3
'
'F ==rv & &&rB rY r
Iterator[str]c # K t | j pg E d {V | j pg }d |D }| j r
| j V n| j pg }|d |D z
}|D ] }| d \ }}}|V d S )Nc g | ]}d |v | S r{ rI r mods r@
z"_find_packages.. s >>>c3#::c:::rB c . g | ]}d |j v |j S r rl r xs r@ r z"_find_packages.. s! HHHa#--16---rB r{ )iterr
py_modules ext_package ext_modules
rpartition)rY r nested_modulesr modulepackage_s r@ r r s DM'R((((((((( &BJ>>Z>>>N I &," HH;HHHH ))#..
A
rB c # K | j pg }d |D E d {V | j s | j pg }d |D E d {V d S d S )Nc 3 " K | ]
}d |v|V dS r rI r s r@ r z*_find_top_level_modules.. s& <<S^^^^^^<. s0 EEq3af3D3DAF3D3D3D3DEErB )r r r )rY r r s r@ ra ra s &BJ<. s@ ! ! ! ^ -c; I I
J
J! ! !rB )sorted_remove_nested)r r^ r[ pkg_rootss `` r@ rb rb sI
! ! ! ! !(##! ! !I
) $ $$rB r_ c t | }|j }| r!t | S t | |j z S )z(Works for packages and top-level modules)r r ry rw r~ rl )r_ path_r s r@ r r sY JJE
\F ||~~ 25==??###6>>##ej0111rB r c # > K | D ]}d|vr| d }t t | dz
dd D ]Y}d |d| }t t || d }| r|| vr|V ZdS )a8 By carefully designing ``package_dir``, it is possible to implement the logical
structure of PEP 420 in a package without the corresponding directories.
Moreover a parent package can be purposefully/accidentally skipped in the discovery
phase (e.g. ``find_packages(include=["mypkg.*"])``, when ``mypkg.foo`` is included
by ``mypkg`` itself is not).
We consider this case to also be a virtual namespace (ignoring the original
directory) to emulate a non-editable installation.
This function will try to find these kinds of namespaces.
r{ r" r NrN )r rangelenr` r r ry )r r_ partsi partial_namer_ s r@ re re s # # c>> #s5zzA~q"-- # #A 88E"1"I..L), 2FFGGD;;==
#L $A$A"""" # # #rB r Iterator[tuple[str, list[str]]]c # K | D ]]}t ||d }t | r)t |d s||gfV ^d S )NrN z __init__.py)r r ry )r r r_ r_ s r@ rd rd s| i44 :: tD-'@'@'G'G'I'I - rB c : t | }t t | D ]H\ t fd| D r| I|S )Nc 3 N K | ] \ }}|k ot || V d S rP )
_is_nested)r other
other_pathr_ r_ s r@ r z!_remove_nested.. sR
!z
5L EZT5* E E
rB )rc copyreversedr rJ anypop)r rO r_ r_ s @@r@ r r s
)..""
#
#F d9??#4#4 5 566 T
%.__%6%6
JJsOOO MrB r_ r r parent_pathc t j | }| |dd d d }| | o"|t j t
|g|R k S )a
Return ``True`` if ``pkg`` is nested inside ``parent`` both logically and in the
file system.
>>> _is_nested("a.b", "path/a/b", "a", "path/a")
True
>>> _is_nested("a.b", "path/a/b", "a", "otherpath/a")
False
>>> _is_nested("a.b", "path/a/b", "c", "path/c")
False
>>> _is_nested("a.a", "path/a/a", "a", "path/a")
True
>>> _is_nested("b.a", "path/b/a", "a", "path/a")
False
rN r" r{ )r normpathr4 stripr
startswithr )r_ r r r
norm_pkg_pathrests r@ r r s N8,,M ;;vr1 % % + +C 0 0 6 6s ; ;D >>& ! ! mu~ [ 4 8 8 ' rB dir_c Z t j | d t j | | S )zFCreate a directory ensured to be empty. Existing files may be removed.T)
ignore_errors)r rmtreer\ makedirs)r s r@ r r s, N4t,,,,K KrB c " e Zd ZddZd Zd ZdS )r r5 rW c L || _ || _ || _ || _ g | _ d S rP )rZ r[ r
editable_namerK )rU rZ r r r[ s r@ r z _NamespaceInstaller.__init__ s, (
0 *"$ rB c f t j | j | j | j z S )zInstallation target.)r\ r_ r` r r nspkg_extrT s r@ _get_nspkg_filez#_NamespaceInstaller._get_nspkg_file% s% w||D 143E3VWWWrB c D t t | j S )z1Where the modules/packages should be loaded from.)reprrw r[ rT s r@ _get_rootz _NamespaceInstaller._get_root) s C
&&'''rB Nr )rC rD rE r r r rI rB r@ r r sI % % % %X X X( ( ( ( (rB r a
from __future__ import annotations
import sys
from importlib.machinery import ModuleSpec, PathFinder
from importlib.machinery import all_suffixes as module_suffixes
from importlib.util import spec_from_file_location
from itertools import chain
from pathlib import Path
MAPPING: dict[str, str] = {mapping!r}
NAMESPACES: dict[str, list[str]] = {namespaces!r}
PATH_PLACEHOLDER = {name!r} + ".__path_hook__"
class _EditableFinder: # MetaPathFinder
@classmethod
def find_spec(cls, fullname: str, path=None, target=None) -> ModuleSpec | None: # type: ignore
# Top-level packages and modules (we know these exist in the FS)
if fullname in MAPPING:
pkg_path = MAPPING[fullname]
return cls._find_spec(fullname, Path(pkg_path))
# Handle immediate children modules (required for namespaces to work)
# To avoid problems with case sensitivity in the file system we delegate
# to the importlib.machinery implementation.
parent, _, child = fullname.rpartition(".")
if parent and parent in MAPPING:
return PathFinder.find_spec(fullname, path=[MAPPING[parent]])
# Other levels of nesting should be handled automatically by importlib
# using the parent path.
return None
@classmethod
def _find_spec(cls, fullname: str, candidate_path: Path) -> ModuleSpec | None:
init = candidate_path / "__init__.py"
candidates = (candidate_path.with_suffix(x) for x in module_suffixes())
for candidate in chain([init], candidates):
if candidate.exists():
return spec_from_file_location(fullname, candidate)
return None
class _EditableNamespaceFinder: # PathEntryFinder
@classmethod
def _path_hook(cls, path) -> type[_EditableNamespaceFinder]:
if path == PATH_PLACEHOLDER:
return cls
raise ImportError
@classmethod
def _paths(cls, fullname: str) -> list[str]:
paths = NAMESPACES[fullname]
if not paths and fullname in MAPPING:
paths = [MAPPING[fullname]]
# Always add placeholder, for 2 reasons:
# 1. __path__ cannot be empty for the spec to be considered namespace.
# 2. In the case of nested namespaces, we need to force
# import machinery to query _EditableNamespaceFinder again.
return [*paths, PATH_PLACEHOLDER]
@classmethod
def find_spec(cls, fullname: str, target=None) -> ModuleSpec | None: # type: ignore
if fullname in NAMESPACES:
spec = ModuleSpec(fullname, None, is_package=True)
spec.submodule_search_locations = cls._paths(fullname)
return spec
return None
@classmethod
def find_module(cls, _fullname) -> None:
return None
def install():
if not any(finder == _EditableFinder for finder in sys.meta_path):
sys.meta_path.append(_EditableFinder)
if not NAMESPACES:
return
if not any(hook == _EditableNamespaceFinder._path_hook for hook in sys.path_hooks):
# PathEntryFinder is needed to create NamespaceSpec without private APIS
sys.path_hooks.append(_EditableNamespaceFinder._path_hook)
if PATH_PLACEHOLDER not in sys.path:
sys.path.append(PATH_PLACEHOLDER) # Used just to trigger the path hook
rl r r dict[str, list[str]]c t t | t j d }t
| || S )z_Create a string containing the code for the``MetaPathFinder`` and
``PathEntryFinder``.
r )r rl r r )rc r rJ operator
itemgetter_FINDER_TEMPLATEformatr s r@ rp rp sL 6'--//x/B1/E/EFFFGGG " "g* " U UUrB c e Zd ZdZdS )r zCFile system does not seem to support either symlinks or hard links.N)rC rD rE rF rI rB r@ r r s MMMMrB r )rq rw r5 ro )r r r5 r )r r r^ r rS r r5 r )rY r r5 r )r r r^ r r[ r r5 r )r_ r r5 rw )r r r5 r )r r r r r5 r )r r r5 r )
r_ rw r rw r rw r rw r5 r )r r, r5 r, )rl rw r r r r r5 rw )brF
__future__r ry loggingr r\ r r collections.abcr r r
contextlibr enumr inspectr itertoolsr
r pathlibr tempfiler
typesr typingr r r r rN r r r r r r r r2 r r discoveryr rY r warningsr r! r# r r$ r r% rt r& r r' r r( r typing_extensionsr) _vendor.wheel.wheelfiler+ r, getLoggerrC r r/ rS r! rK r r r r r rI r r r ra rb r re rd r r r Installerr r rp FileErrorr rI rB r@ r s%
# " " " " "
7 7 7 7 7 7 7 7 7 7 $ $ $ $ $ $ $ $ ' ' ' ' ' ' 9 9 9 9 9 9 9 9 9 9 9 9 J J J J J J J J J J J J J J J J ! ! ! ! ! ! ! ! ) ) ) ) ) ) D D D D D D D D % % % % % % . . . . . . 1 1 1 1 1 1 . . . . . . + + + + + + C C C C C C 4&&&&&&333333 WT!!!
'
H
%
%&$ &$ &$ &$ &$D &$ &$ &$R \8 \8 \8 \8 \8W \8 \8 \8~
x
< >< >< >< >< >< >< >