Ë
|
@ñúhªV ã ó d Z ddlmZ ddlZddlZddlZddlZddlmZ ddl m
|
Z
|
m Z ddl m Z mZmZmZmZ ddlmZmZmZmZmZ dd lmZ dd
|
lmZ e rdd l m Z dd l m Z m Z e d « Z! edd¬« Z" edd¬« Z# edd¬« Z$ G d d« Z%y)ztdistutils.cmd
|
|
Provides the Command class, the base class for the command classes
|
in the distutils.command package.
|
é )Ú annotationsN)Úabstractmethod)ÚCallableÚMutableSequence)Ú TYPE_CHECKINGÚAnyÚClassVarÚTypeVarÚoverloadé )Ú _modifiedÚ archive_utilÚdir_utilÚ file_utilÚutil©Úlog)ÚDistutilsOptionError©Ú Distribution)Ú TypeVarTupleÚUnpackÚ_TsÚ _StrPathTústr | os.PathLike[str])ÚboundÚ _BytesPathTúbytes | os.PathLike[bytes]Ú _CommandTÚCommandc ó e Zd ZU dZg Zded< g Zded< d-dZd Zd.dZ e
|
d.d « Z e
|
d.d
|
« Z d/d Z e
|
d.d « Zej fd0dZd1dZd2dZd2d3dZd4dZd2dZd4dZd4dZd5dZ d6dZd7d8dZe d9 d:d« Z e d9 d;d« Z d9 d<dZ d=d Z d>d Z d1d Z d? d@d Z!dAdBd Z"e dC dDd!« Z#e dC dEd"« Z# dC dFd#Z# dG dHd$Z$e dI dJd%« Z%e dI dKd&« Z% dI dLd'Z% dM dNd(Z&e dO dPd)« Z'e dQ dRd*« Z' dO dSd+Z' dT dUd,Z(y )Vr a} Abstract base class for defining command classes, the "worker bees"
|
of the Distutils. A useful analogy for command classes is to think of
|
them as subroutines with local variables called "options". The options
|
are "declared" in 'initialize_options()' and "defined" (given their
|
final values, aka "finalized") in 'finalize_options()', both of which
|
must be defined by every command class. The distinction between the
|
two is necessary because option values might come from the outside
|
world (command line, config file, ...), and any options dependent on
|
other options must be computed *after* these outside influences have
|
been processed -- hence 'finalize_options()'. The "body" of the
|
subroutine, where it does all its work based on the values of its
|
options, is the 'run()' method, which must also be implemented by every
|
command class.
|
z8ClassVar[list[tuple[str, Callable[[Any], bool] | None]]]Ú sub_commandszHClassVar[list[tuple[str, str, str]] | list[tuple[str, str | None, str]]]Ú user_optionsc ó ddl m} t ||« s t d« | j t
|
u r t d« || _ | j « d| _ |j | _
|
d| _ d| _ d| _ y)zÞCreate and initialize a new Command object. Most importantly,
|
invokes the 'initialize_options()' method, which is the real
|
initializer and depends on the actual command being
|
instantiated.
|
r r z$dist must be a Distribution instancez Command is an abstract classNF)Údistutils.distr Ú
|
isinstanceÚ TypeErrorÚ __class__r Ú RuntimeErrorÚ distributionÚinitialize_optionsÚ_dry_runÚverboseÚforceÚhelpÚ finalized)ÚselfÚdistr s úLH:\Change_password\venv_build\Lib\site-packages\setuptools/_distutils/cmd.pyÚ__init__zCommand.__init__K sz õ 0ä$ Ô-ÜÐ BÓCÐ CØ >>WÑ $Ü Ð =Ó>Ð >à ÔØ × Ñ Ô!ð ð || ð
|
ð ð ó c ót |dk( r)t | d|z « }|t | j |« S |S t |« )NÚdry_runÚ_)Úgetattrr* ÚAttributeError)r1 ÚattrÚmyvals r3 Ú __getattr__zCommand.__getattr__{ sB Ø 9Ò ÜD #¨¡*Ó-EØ}Ü t× 0Ñ 0°$Ó7Ð7à ä Ó&Ð &r5 c óJ | j s| j « d| _ y )NT)r0 Úfinalize_options©r1 s r3 Úensure_finalizedzCommand.ensure_finalized
s Ø~~Ø × !Ñ !Ô #Ø r5 c ó4 t d| j d« )aÙ Set default values for all the options that this command
|
supports. Note that these defaults may be overridden by other
|
commands, by the setup script, by config files, or by the
|
command-line. Thus, this is not the place to code dependencies
|
between options; generally, 'initialize_options()' implementations
|
are just a bunch of "self.foo = None" assignments.
|
|
This method must be implemented by all command classes.
|
ú abstract method -- subclass ú must override©r) r( r@ s r3 r+ zCommand.initialize_options ó" ô Ø*¨4¯>©>Ð*:¸.Ð Ió
|
ð
|
r5 c ó4 t d| j d« )a Set final values for all the options that this command supports.
|
This is always called as late as possible, ie. after any option
|
assignments from the command-line or from other commands have been
|
done. Thus, this is the place to code option dependencies: if
|
'foo' depends on 'bar', then it is safe to set 'foo' from 'bar' as
|
long as 'foo' still has the same value it was assigned in
|
'initialize_options()'.
|
|
This method must be implemented by all command classes.
|
rC rD rE r@ s r3 r? zCommand.finalize_options¦ s" ô Ø*¨4¯>©>Ð*:¸.Ð Ió
|
ð
|
r5 Nc ó^ ddl m} |d| j « d}| j ||z t j
|
¬« |dz }| j D ]Y \ }}}|j |« }|d dk( r|d d }t | |« }| j || d | z t j
|
¬« [ y )
|
Nr )Ú longopt_xlatezcommand options for 'z':)Úlevelz éÿÿÿÿú=z = ) Údistutils.fancy_getoptrI Úget_command_nameÚannounceÚloggingÚINFOr# Ú translater9 )r1 ÚheaderÚindentrI Úoptionr8 Úvalues r3 Ú dump_optionszCommand.dump_options¶ s· Ý8à >Ø,¨T×-BÑ-BÓ-DÐ,EÀRÐHFØ fvo¬W¯\©\ Ô:Ø$ Ø × -Ñ -ò NLFAqØ×%Ñ% mÓ4FØbzSÒ Ø ÜD &Ó)EØ MM& f X¨S°°Ð#8Ñ8ÄÇ Á MÕ Mñ Nr5 c ó4 t d| j d« )a¾ A command's raison d'etre: carry out the action it exists to
|
perform, controlled by the options initialized in
|
'initialize_options()', customized by other commands, the setup
|
script, the command-line, and config files, and finalized in
|
'finalize_options()'. All terminal output and filesystem
|
interaction should be done by 'run()'.
|
|
This method must be implemented by all command classes.
|
rC rD rE r@ s r3 Úrunz Command.runÄ rF r5 c ó0 t j ||« y ©Nr )r1 ÚmsgrJ s r3 rO zCommand.announceÓ s Ü sÕr5 c óh ddl m} |r*t |« t j j « yy)z~Print 'msg' to stdout if the global DEBUG (taken from the
|
DISTUTILS_DEBUG environment variable) flag is true.
|
r )ÚDEBUGN)Údistutils.debugr^ ÚprintÚsysÚstdoutÚflush)r1 r\ r^ s r3 Ú debug_printzCommand.debug_printÖ s& õ *á Ü #JÜ JJ× Ñ Õ ð r5 c ó t | |« }|t | ||« |S t |t « st d| d| d| d« |S )Nú'z ' must be a z (got `z`))r9 Úsetattrr& Ústrr )r1 rU ÚwhatÚdefaultÚvals r3 Ú_ensure_stringlikezCommand._ensure_stringlikeí sT ÜdFÓ#Ø ;Ü D& 'Ô *ØNÜC¤Ô%Ü&¨¨6¨(°,¸t¸fÀGÈCÈ5ÐPRÐ'SÓTÐ TØ
|
r5 c ó* | j |d|« y)zWEnsure that 'option' is a string; if not defined, set it to
|
'default'.
|
ÚstringN)rl )r1 rU rj s r3 Ú ensure_stringzCommand.ensure_stringö s ð × Ñ ¨°'Õ:r5 c óø t | |« }|yt |t « r"t | |t j
|
d|« « yt |t « rt d |D « « }nd}|st d| d|d« y)zîEnsure that 'option' is a list of strings. If 'option' is
|
currently a string, we split it either on /,\s*/ or /\s+/, so
|
"foo bar baz", "foo,bar,baz", and "foo, bar baz" all become
|
["foo", "bar", "baz"].
|
Nz,\s*|\s+c 3 ó< K | ] }t |t « y wr[ )r& rh )Ú.0Úvs r3 ú <genexpr>z-Command.ensure_string_list.<locals>.<genexpr> s è ø Ò9° A¤s×+Ñ9ùs Frf z!' must be a list of strings (got ú)) r9 r& rh rg ÚreÚsplitÚlistÚallr )r1 rU rk Úoks r3 Úensure_string_listzCommand.ensure_string_listü s ô dFÓ#Ø ;Ø Ü SÔ !Ü D&¤"§(¡(¨;¸Ó"<Õ =ä#tÔ$ÜÑ9°SÔ9Ó9àÙÜ*ØxÐ @ÀÀÀqÐIóð ð r5 c óf | j |||« }| ||« st d|z ||fz « y y )Nzerror in '%s' option: )rl r )r1 rU Útesterri Ú error_fmtrj rk s r3 Ú_ensure_tested_stringz Command._ensure_tested_string sF Ø×%Ñ% f¨d°GÓ<Ø ?¡6¨#¤;Ü&Ø)¨IÑ5¸&À#¸ ÑFóð ð $/?r5 c ó\ | j |t j j dd« y)z5Ensure that 'option' is the name of an existing file.Úfilenamez$'%s' does not exist or is not a fileN)r ÚosÚpathÚisfile©r1 rU s r3 Úensure_filenamezCommand.ensure_filename s" à ×"Ñ"Ø BGGNN JÐ0Võ
|
r5 c ó\ | j |t j j dd« y )Nzdirectory namez)'%s' does not exist or is not a directory)r r r Úisdirr
s r3 Úensure_dirnamezCommand.ensure_dirname s$ Ø ×"Ñ"Ø Ü GGMMØ Ø 7õ
|
r5 c ó^ t | d« r | j S | j j S )NÚ command_name)Úhasattrr r( Ú__name__r@ s r3 rN zCommand.get_command_name( s( Ü 4 Ô (Ø×$Ñ$Ð $à>>×*Ñ*Ð *r5 c ó¶ | j j |« }|j « |D ]) \ }}t | |« t | |t ||« « + y)a> Set the values of any "undefined" options from corresponding
|
option values in some other command object. "Undefined" here means
|
"is None", which is the convention used to indicate that an option
|
has not been changed between 'initialize_options()' and
|
'finalize_options()'. Usually called from 'finalize_options()' for
|
options that depend on some other command rather than another
|
option of the same command. 'src_cmd' is the other command from
|
which option values will be taken (a command object will be created
|
for it if necessary); the remaining arguments are
|
'(src_option,dst_option)' tuples which mean "take the value of
|
'src_option' in the 'src_cmd' command object, and copy it to
|
'dst_option' in the current command object".
|
N)r* Úget_command_objrA r9 rg )r1 Úsrc_cmdÚ option_pairsÚ src_cmd_objÚ
|
src_optionÚ
|
dst_options r3 Úset_undefined_optionsz Command.set_undefined_options. s\ ð" ×'Ñ'×7Ñ7¸Ó@ Ø×$Ñ$Ô&Ø&2ò LÑ "J
|
ÜtZÓ(Ñ0Üj¬'°+¸zÓ*JÕKñ Lr5 c ó^ | j j ||« }|j « |S )zûWrapper around Distribution's 'get_command_obj()' method: find
|
(create if necessary and 'create' is true) the command object for
|
'command', call its 'ensure_finalized()' method, and return the
|
finalized command object.
|
)r* r rA )r1 ÚcommandÚcreateÚcmd_objs r3 Úget_finalized_commandz Command.get_finalized_commandG s- ð ×#Ñ#×3Ñ3°G¸VÓDØ× Ñ Ô"Ør5 c ó y r[ © ©r1 r Úreinit_subcommandss r3 Úreinitialize_commandz Command.reinitialize_commandS s ð r5 c ó y r[ r r s r3 r z Command.reinitialize_commandW s ð r5 c ó: | j j ||« S r[ )r* r r s r3 r z Command.reinitialize_command[ s ð × Ñ ×5Ñ5°gÐ?QÓRÐRr5 c ó: | j j |« y)zÂRun some other command: uses the 'run_command()' method of
|
Distribution, which creates and finalizes the command object if
|
necessary and then invokes its 'run()' method.
|
N)r* Ú run_command)r1 r s r3 r£ zCommand.run_command` s ð
|
×Ñ×%Ñ% gÕ.r5 c ój g }| j D ]! \ }}| || « s|j |« # |S )ak Determine the sub-commands that are relevant in the current
|
distribution (ie., that need to be run). This is based on the
|
'sub_commands' class attribute: each tuple in that list may include
|
a method that we call to determine if the subcommand needs to be
|
run for the current distribution. Return a list of command names.
|
)r" Úappend)r1 ÚcommandsÚcmd_nameÚmethods r3 Úget_sub_commandszCommand.get_sub_commandsg sA ð Ø $× 1Ñ 1ò *Ñ HfØ~¡¨¥ Ø Õ)ð *ð r5 c óN t j d| j « |« y )Nzwarning: %s: %s
|
)r ÚwarningrN )r1 r\ s r3 Úwarnz Command.warnv s Ü Ð'¨×)>Ñ)>Ó)@À#ÕFr5 c óJ t j |||| j ¬« y ©N©r7 )r Úexecuter7 )r1 ÚfuncÚargsr\ rJ s r3 r° zCommand.executey s ô T4 ¨d¯l©lÖ;r5 c óH t j ||| j ¬« y r® )r Úmkpathr7 )r1 ÚnameÚmodes r3 r´ zCommand.mkpath s Üd¨D¯L©LÖ9r5 c ó y r[ r ©r1 ÚinfileÚoutfileÚ preserve_modeÚpreserve_timesÚlinkrJ s r3 Ú copy_filezCommand.copy_file
s ð (+r5 c ó y r[ r r¸ s r3 r¾ zCommand.copy_file s ð ,/r5 c ód t j ||||| j || j ¬« S )zÑCopy a file respecting verbose, dry-run and force flags. (The
|
former two default to whatever is in the Distribution object, and
|
the latter defaults to false for commands that don't define it.)r¯ )r r¾ r. r7 r¸ s r3 r¾ zCommand.copy_file s6 ô ×"Ñ"Ø Ø Ø Ø Ø
|
|
NØ ØLLô
|
ð
|
r5 c ód t j |||||| j | j ¬« S )z\Copy an entire directory tree respecting verbose, dry-run,
|
and force flags.
|
r¯ )r Ú copy_treer. r7 )r1 r¹ rº r» r¼ Úpreserve_symlinksrJ s r3 r zCommand.copy_tree¯ s6 ô ×!Ñ!Ø Ø Ø Ø Ø Ø
|
|
NØLLô
|
ð
|
r5 c ó y r[ r ©r1 ÚsrcÚdstrJ s r3 Ú move_filezCommand.move_fileÅ s ð r5 c ó y r[ r rÅ s r3 rÈ zCommand.move_fileÉ s ð "r5 c óF t j ||| j ¬« S )z$Move a file respecting dry-run flag.r¯ )r rÈ r7 rÅ s r3 rÈ zCommand.move_fileÍ s ô ×"Ñ" 3¨°T·\±\ÔBÐBr5 c ó: ddl m} |||| j ¬« y)z2Spawn an external command respecting dry-run flag.r )Úspawnr¯ N)Údistutils.spawnrÌ r7 )r1 ÚcmdÚ search_pathrJ rÌ s r3 rÌ z Command.spawnÖ s õ *á c;¨¯ © Ö5r5 c ó y r[ r ©r1 Ú base_nameÚformatÚroot_dirÚbase_dirÚownerÚgroups r3 Ú make_archivezCommand.make_archiveÞ ó ð r5 c ó y r[ r rÑ s r3 rØ zCommand.make_archiveè rÙ r5 c óN t j ||||| j ||¬« S )N)r7 rÖ r× )r rØ r7 rÑ s r3 rØ zCommand.make_archiveò s0 ô ×(Ñ(Ø Ø Ø Ø ØLLØØô
|
ð
|
r5 c ó\ |d| d}t |t « r|f}n!t |t t f« s t d« |!dj |dj |« « }| j st j ||« r| j ||||« yt j |« y)aÌ Special case of 'execute()' for operations that process one or
|
more input files and generate one output file. Works just like
|
'execute()', except the operation is skipped and a different
|
message printed if 'outfile' already exists and is newer than all
|
files listed in 'infiles'. If the command defined 'self.force',
|
and it is true, then the command is unconditionally run -- does no
|
timestamp checks.
|
Nz skipping z (inputs unchanged)z9'infiles' must be a string, or a list or tuple of stringszgenerating {} from {}z, ) r& rh rx Útupler' rÓ Újoinr. r Ú newer_groupr° r Údebug)r1 Úinfilesrº r± r² Úexec_msgÚskip_msgrJ s r3 Ú make_filezCommand.make_file s ð$ Ð Ø" 7 )Ð+>Ð?Hô gsÔ #Ø jGÜG¤d¬E ]Ô3ÜÐ WÓXÐ Xà Ð Ø.×5Ñ5°g¸t¿y¹yÈÓ?QÓRHð
|
::×.Ñ.¨w¸Ô@Ø LLt X¨uÕ 5ô IIhÕ r5 )r2 r ÚreturnÚNone)rå ræ )NÚ )r\ ÚobjectrJ Úintrå ræ )r\ rè rå ræ r[ )rU rh rj ú
|
str | Nonerå ræ )rU rh rå ræ )rå rh )r rh r ztuple[str, str]rå ræ )T)r rh r Úboolrå r )F)r rh r rë rå r )r r r rë rå r )r z str | Commandrå r )r rh rå ræ )rå ú list[str])Nr )
|
r± ú Callable[[Unpack[_Ts]], object]r² útuple[Unpack[_Ts]]r\ rè rJ ré rå ræ )iÿ )rµ rh r¶ ré rå ræ )TTNr )r¹ r rº r r» rë r¼ rë r½ rê rJ ré rå z tuple[_StrPathT | str, bool])r¹ r rº r r» rë r¼ rë r½ rê rJ ré rå z tuple[_BytesPathT | bytes, bool])r¹ ú3str | os.PathLike[str] | bytes | os.PathLike[bytes]rº rï r» rë r¼ rë r½ rê rJ ré rå z@tuple[str | os.PathLike[str] | bytes | os.PathLike[bytes], bool])TTFr )r¹ r rº rh r» rë r¼ rë rà rë rJ ré rå rì )r )rÆ r rÇ r rJ ré rå z_StrPathT | str)rÆ r rÇ r rJ ré rå z_BytesPathT | bytes)rÆ rï rÇ rï rJ ré rå rï )Tr )rÎ zMutableSequence[str]rÏ rë rJ ré rå ræ )NNNN)rÒ rh rÓ rh rÔ ú:str | os.PathLike[str] | bytes | os.PathLike[bytes] | NonerÕ rê rÖ rê r× rê rå rh )NNN)rÒ r rÓ rh rÔ rï rÕ rê rÖ rê r× rê rå rh )rÒ r rÓ rh rÔ rð rÕ rê rÖ rê r× rê rå rh )NNr )rá z!str | list[str] | tuple[str, ...]rº rï r± rí r² rî râ rè rã rè rJ ré rå ræ ))r Ú
|
__module__Ú __qualname__Ú__doc__r" Ú__annotations__r# r4 r= rA r r+ r? rW rY rP r^ rO rd rl ro r{ r r r rN r r r r r£ r© r¬ r° r´ r¾ r rÈ rÌ rØ rä r r5 r3 r r " s|
ñ ð> ð ð ó ð ð ð ó ó- ò`'ó ð$ ò
|
ó ð
|
ð ò
|
ó ð
|
ó Nð ò
|
ó ð
|
ð 29· ± ô ó ó.ô;ó ó*ó
|
ó
|
ó+ð LØðLØ+:ðLà óLô2ð à7<ðØðØ04ðà òó ðð à=BðØ ðØ6:ðà òó ðð :?ðSØ$ðSà óSó
|
/ó ó Gð Øð <à-ð<ð !ð<ð ð <ð
|
ð <ð
|
ó <ô:ð ð
|
#Ø #Ø Øð+à&ð+ð ð+ð ð +ð
|
ð +ð ð +ð ð+ð
|
&ò+ó ð+ð ð
|
#Ø #Ø Øð/à*ð/ð ð/ð ð /ð
|
ð /ð ð /ð ð/ð
|
*ò/ó ð/ð #Ø #Ø Øð
|
àCð
|
ð Eð
|
ð ð
|
ð
|
ð
|
ð ð
|
ð ð
|
ð
|
Jó
|
ð4 #Ø #Ø"'Øð
|
à&ð
|
ð ð
|
ð ð
|
ð
|
ð
|
ð ð
|
ð ð
|
ð
|
ó
|
ð, àHIð Ø)ð Ø09ð ØBEð à ò ó ð ð àNOð"Ø-ð"Ø4?ð"ØHKð"à ò"ó ð"ð ð Cà @ðCð AðCð ð Cð
|
|
=ó Cð QRð6Ø'ð6Ø6:ð6ØJMð6à ó6ð ð
|
PTØ #Ø Ø ðàðð ðð Mð ð
|
ð ð ð ð ðð
|
òó ðð ð $Ø Ø ðà)ðð ðð Fð ð
|
ð ð ð ð ðð
|
òó ðð PTØ #Ø Ø ð
|
à)ð
|
ð ð
|
ð Mð
|
ð
|
ð
|
ð ð
|
ð ð
|
ð
|
ó
|
ð2 Ø Øð% à2ð% ð Eð% ð .ð % ð
|
!ð % ð ð % ð ð% ð ð% ð
|
ô% r5 )&ró Ú
|
__future__r rP r rv ra Úabcr Úcollections.abcr r Útypingr r r r
|
r rç r r r r r Ú_logr Úerrorsr r% r Útyping_extensionsr r r r r r r r r5 r3 ú<module>rü sx ðñõ #ã Û Û Û
|
Ý ß 5ß BÕ Bç @Õ @Ý Ý (áå+ç6á
|
uÓ
|
Cá KÐ'?Ô @ ÙmÐ+GÔH Ù K yÔ 1 ÷H ò H r5
|
