w>>r param!Self | str | Iterable[str] | Nonereturnr
c $ t || r|S t |t r| | S t |t r | | S || S t dt
| )zg
Construct a CommandSpec from a parameter to build_scripts, which may
be None.
Nz!Argument has an unsupported type )
isinstancestr from_stringr from_environment TypeErrortype)r r- s r
from_paramzCommandSpec.from_param3 s eS ! ! L eS ! ! *??5)) ) eX & & 3u:: ='')) )IDKKIIJJJr c > | | g S N)r, r s r r4 z CommandSpec.from_environmentC s! sC''))*+++r stringr2 c F t j |fi | j } | | S )z}
Construct a command spec from a simple string representing a command
line parseable by shlex.split.
)shlexsplit
split_args)r r: itemss r r3 zCommandSpec.from_stringG s+ F55cn55s5zzr script_textc t j | | | _ t j | }t
| sdg| j d d< d S d S )Nz-xr )r< r= _extract_optionsr
subprocess list2cmdlineisascii)selfr@ cmdlines r install_optionszCommandSpec.install_optionsP sc {4#8#8#E#EFF )$//w & $vDL! & &r c | dz d }t | }|r| d pdnd}| S )zH
Extract any options from the first line of the script.
r r )
splitlines_first_line_rematchgroupstrip) orig_scriptfirstrN r s r rB z CommandSpec._extract_optionsV sb
t#//11!4 &&u--*/7%++a..&BR}} r c V | | t | j z S r9 )_renderlistr )rF s r as_headerzCommandSpec.as_header` s# ||D4 #5#5 5666r c d}|D ]8}| | r!| | r | dd c S 9| S )Nz"'r )
startswithendswith)item_QUOTESqs r
_strip_quoteszCommandSpec._strip_quotesc sW " "Aq!!
"dmmA&6&6
"AbDz!!! r c N t j d | D }d|z dz S )Nc 3 n K | ]0}t | V 1d S r9 )r r^ rP ).0r[ s r z&CommandSpec._render..m sI *
*
8 classmethodr! r, r7 r4 r3 rH staticmethodrB rV r^ rT r r r r r sE
G J [ ? ? [?
K
K
K [
K , , [, [& & & & \ 7 7 7 \ % % \% % %r r c & e Zd Z ed ZdS )WindowsCommandSpecF)r N)r r r r r> r r r rg rg s s %(((JJJr rg c e Zd ZdZ ej d ZeZ e
dd Z e d Z
e
d Ze
d Ze
ddd ZdS ) ScriptWriterz`
Encapsulates behavior around writing entry point scripts for console and
gui apps.
aJ
# EASY-INSTALL-ENTRY-SCRIPT: %(spec)r,%(group)r,%(name)r
import re
import sys
# for compatibility with easy_install; see #2198
__requires__ = %(spec)r
try:
from importlib.metadata import distribution
except ImportError:
try:
from importlib_metadata import distribution
except ImportError:
from pkg_resources import load_entry_point
def importlib_load_entry_point(spec, group, name):
dist_name, _, _ = spec.partition('==')
matches = (
entry_point
for entry_point in distribution(dist_name).entry_points
if entry_point.group == group and entry_point.name == name
)
return next(matches).load()
globals().setdefault('load_entry_point', importlib_load_entry_point)
if __name__ == '__main__':
sys.argv[0] = re.sub(r'(-script\.pyw?|\.exe)?$', '', sys.argv[0])
sys.exit(load_entry_point(%(spec)r, %(group)r, %(name)r)())
Nc # K t |d s8t j d t j |j }|| }|j d|j }dD ]}| d}|j
| D ]^}|j }| |j | j
t z }| ||j || } | E d{V _dS )z
Yield write_script() argument tuples for a distribution's
console_scripts and gui_scripts entry points.
entry_pointsz%Unsupported distribution encountered.Nz==consolegui_scripts)rO )hasattrr emitr Distributionategg_info
get_headernameversionrk select_ensure_safe_nametemplatelocals_get_script_args)
r distheaderspectype_rO eprv r@ argss
r get_argszScriptWriter.get_args s t^,, ; "#J K K K(++DM::D >^^%%F)--t|--% E &&&E'..U.;;
w%%bg... !lVXX 5 ++E27FKPP
r c R t j d| }|rt d dS )z?
Prevent paths in *_scripts entry point names.
z[\\/]z+Path separators not allowed in script namesN)research
ValueError)rv has_path_seps r ry z ScriptWriter._ensure_safe_name s9
y400 L JKK K L Lr c t j dk s t j dk r)t j dk rt
S | S )zD
Select the best ScriptWriter for this environment.
win32javant)r' platformr$ rv _nameWindowsScriptWriterr! r s r r! zScriptWriter.best s@
<7 " "rw&'8'8RX=M=M&++-- -Jr c # K |||z fV d S r9 r )r r rv r~ r@ s r r| z ScriptWriter._get_script_args s$ Vk)******r rK r@ r2 r( (str | CommandSpec | Iterable[str] | Noner/ c | j | }| | | S )z;Create a #! line, getting options (if any) from script_text)command_spec_classr! r7 rH rV )r r@ r( cmds r ru zScriptWriter.get_header sH $))++66zBB K(((}} r r9 )rK N)r@ r2 r( r r/ r2 )r r r rc textwrapdedentlstriprz r r rd r re ry r! r| ru r r r ri ri w s
x! # #F
fhhG
J % [ 0 L L \L [ + + [+ ?C [ r ri c j e Zd ZeZed Zed Zed Ze d Z
dS )r c ~ t t | }t j dd }|| S )zC
Select the best ScriptWriter suitable for Windows
)r( naturalSETUPTOOLS_LAUNCHERr( )dict WindowsExecutableLauncherWriterr$ r) r* )r
writer_lookuplaunchers r r! zWindowsScriptWriter.best sA
6
:>>"7 FF X&&r c # K t dd | }|t j d d vr- dj d i t
}t j | g d}| | |
|| }fd|D }|z ||z d |fV d
S ) z For Windows, add a .py extension.pya.pywrl PATHEXT;zK{ext} not listed in PATHEXT; scripts will not be recognized as executables.)r .py
-script.py.pyc.pyor .exec g | ]}|z S r r ra xrv s r
z8WindowsScriptWriter._get_script_args.. ***D1H***r tNr ) r r$ r) lowerr= formatr{ r rq remove_adjust_header) r r rv r~ r@ extmsgoldblockerss ` r r| z$WindowsScriptWriter._get_script_args s 6v...u5 bj+113399#>> > >-! ! xx! !C
"3 ' ' 'KKK
3##E622****c***Sj&;.X======r c d}d}|dk r||}}t j t j | t j }| || }| | r|n|S )z
Make sure 'pythonw' is used for gui and 'python' is used for
console (regardless of what sys.executable is).
z pythonw.exez
python.exern )r: repl)r compileescape
IGNORECASEsub _use_header)r r orig_headerpatternr
pattern_ob
new_headers r r z"WindowsScriptWriter._adjust_header sm E>> 'TGZ ' 2 2BMBB
^^;T^BB
__Z 8 8IzzkIr c | dd d }t j dk pt j | S )z
Should _adjust_header use the replaced header?
On non-windows systems, always use. On
Windows systems, only use the replaced header if it resolves
to an executable on the system.
rX "r )rP r' r shutilwhich)r clean_headers r r z WindowsScriptWriter._use_header s< "!B$'--c22 |w&D&,|*D*DDr N) r r r rg r rd r! r| r re r r r r r r s +
'
' [
'
>
> [
> J J [ J E E \ E E Er r c $ e Zd Zed ZdS )r c # K |dk rd}d}dg}nd}d}g d}| || }fd|D } |z ||z d| fV d z t | d
fV t sd z }
|
t dfV d S d S )
zG
For Windows, add a .py extension and an .exe launcher
rn z -script.pywr clir )r r r c g | ]}|z S r r r s r r zDWindowsExecutableLauncherWriter._get_script_args..+ r r r r bz
.exe.manifestN)r get_win_launcheris_64bitload_launcher_manifest) r r rv r~ r@
launcher_typer r hdrr m_names ` r r| z0WindowsExecutableLauncherWriter._get_script_args s
E>> !M C(CC !M C)))C //****c***cz3,c8<<<< 6M ] + +
zz > O+F1$77= = = = = = > >r N)r r r rd r| r r r r r s- > > [> > >r r c F | d}t r@t dk r| dd }n-| dd }n| dd }t j d | S )z
Load the Windows launcher (executable) suitable for launching a script.
`type` should be either 'cli' or 'gui'
Returns the executable as a byte string.
r z win-arm64.z-arm64.z-64.z-32.
setuptools)r r
replacer filesjoinpath
read_bytes)r6 launcher_fns r r r < s ---Kzz 7 >>[ ( (%--c9==KK%--c6::KK!))#v66 ?< ( ( 1 1+ > > I I K KKr c t j t d }| d t z S )Nzlauncher manifest.xmlzutf-8)encoding)r r r r read_textvars)rv ress r r r O s=
/(
#
#
,
,-D
E
EC =='= * *TVV 33r c t t j t rt S t j t j S )z_
Return a regular expression based on first_line_re suitable for matching
strings.
)r1 r r r2 r r decoder r r rM rM T s@
-'-- :m+2244 5 55r c 2 t j d dk S )NP )structcalcsizer r r r r ` s ?3 1 $$r c V | d n# t $ r Y dS w xY wdS )NasciiFT)encode UnicodeError)ss r rE rE d sC uu 4s
&&)&
__future__r r$ r r< r r rC r' r collections.abcr typingr r
_importlibr r typing_extensionsr
warningsr distutils.command.build_scriptsr distutils.utilr
r rU r rg ri r r r r rM r rE r r r r sj " " " " " "
$ $ $ $ $ $ + + + + + + + + + + + + + + + + '&&&&&& ' ' ' ' ' ' 9 9 9 9 9 9 ' ' ' ' ' ' %
R% R% R% R% R%$ R% R% R%j) ) ) ) ) ) ) )g g g g g g g g T8E 8E 8E 8E 8E, 8E 8E 8Ev > > > > >&9 > > >@L L L&4 4 4
6 6 6% % % r