{|jZ d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl
Z
ddl Z ddlm Z
ddlZ ddlZg dZ ddlZdZej* dvZer@ddlZddlmZmZmZmZm Z m Z m Z m Z m Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z) ejU g d nYerCdd
l+m,Z- ej\ Z/ej` Z1ejd Z3ejh Z5ejl Z7n dZ-dZ/dZ1dZ3dZ5dZ7ddl8Z8ddl9Z9 G d d e: Z; G d
de; Z< G d de; Z=er G d d Z> G d de? Z@n, eAe8dd ZB eCe9d r
e9j ZEn e9j ZEerdZGd ZHng ZGd ZHdZIdZJd ZKd ZLd ZMd ZNdd d!ZOd" ZPdd d#ZQ G d$ d%eR ZSddddd&d'ZTd( ZUddd)d*ZVddd)d+ZWd, ZX eX ZYdZZ G d- d. Z[y# e$ r dZY w xY w# e$ r dZY w xY w)/a Subprocesses with accessible I/O streams
This module allows you to spawn processes, connect to their
input/output/error pipes, and obtain their return codes.
For a complete description of this module see the Python documentation.
Main API
========
run(...): Runs a command, waits for it to complete, then returns a
CompletedProcess instance.
Popen(...): A class for flexibly executing a command in a new process
Constants
---------
DEVNULL: Special value that indicates that os.devnull should be used
PIPE: Special value that indicates a pipe should be created
STDOUT: Special value that indicates that stderr should go to stdout
Older API
=========
call(...): Runs a command, waits for it to complete, then returns
the return code.
check_call(...): Same as call() but raises CalledProcessError()
if return code is not 0
check_output(...): Same as check_call() but returns the contents of
stdout instead of a return code
getoutput(...): Runs a command in the shell, waits for it to complete,
then returns the output
getstatusoutput(...): Runs a command in the shell, waits for it to complete,
then returns a (exitcode, output) tuple
N) monotonic)PopenPIPESTDOUTcall
check_callgetstatusoutput getoutput check_outputrunCalledProcessErrorDEVNULLSubprocessErrorTimeoutExpiredCompletedProcessTF> wasi
emscripten)CREATE_NEW_CONSOLECREATE_NEW_PROCESS_GROUPSTD_INPUT_HANDLESTD_OUTPUT_HANDLESTD_ERROR_HANDLESW_HIDESTARTF_USESTDHANDLESSTARTF_USESHOWWINDOWABOVE_NORMAL_PRIORITY_CLASSBELOW_NORMAL_PRIORITY_CLASSHIGH_PRIORITY_CLASSIDLE_PRIORITY_CLASSNORMAL_PRIORITY_CLASSREALTIME_PRIORITY_CLASSCREATE_NO_WINDOWDETACHED_PROCESSCREATE_DEFAULT_ERROR_MODECREATE_BREAKAWAY_FROM_JOB)r r r r r r r r STARTUPINFOr r r r r r! r" r# r$ r% ) fork_execc e Zd Zy)r N)__name__
__module__ __qualname__ #/usr/lib64/python3.12/subprocess.pyr r { s r- r c R e Zd ZdZddZd Zed Zej d Zy)r
zRaised when run() is called with check=True and the process
returns a non-zero exit status.
Attributes:
cmd, returncode, stdout, stderr, output
Nc < || _ || _ || _ || _ y N)
returncodecmdoutputstderr)selfr2 r3 r4 r5 s r. __init__zCalledProcessError.__init__ s $ r- c & | j r@| j dk r1d| j dt j | j dS d| j | j fz S # t $ r d| j | j fz cY S w xY w)Nr Command 'z ' died with .z)Command '%s' died with unknown signal %d.z.Command '%s' returned non-zero exit status %d.)r2 r3 signalSignals
ValueErrorr6 s r. __str__zCalledProcessError.__str__ s ??t 2
4 &..$//1A"BD D DHHdooG/ /
/
4B 4??"2F4 4 4
4s 0A( (%BBc | j S )z+Alias for output attribute, to match stderrr4 r> s r. stdoutzCalledProcessError.stdout s {{r- c || _ y r1 rA r6 values r. rB zCalledProcessError.stdout r- NN r) r* r+ __doc__r7 r? propertyrB setterr, r- r. r
r
~ s=
/ ]] r- r
c R e Zd ZdZddZd Zed Zej d Zy)r zThis exception is raised when the timeout expires while waiting for a
child process.
Attributes:
cmd, output, stdout, stderr, timeout
Nc < || _ || _ || _ || _ y r1 )r3 timeoutr4 r5 )r6 r3 rN r4 r5 s r. r7 zTimeoutExpired.__init__ s r- c < d| j d| j dS )Nr9 z' timed out after z seconds)r3 rN r> s r. r? zTimeoutExpired.__str__ s 4<<) *r- c | j S r1 rA r> s r. rB zTimeoutExpired.stdout s {{r- c || _ y r1 rA rD s r. rB zTimeoutExpired.stdout rF r- rG rH r, r- r. r r s= * ]] r- r c ( e Zd ZddddddddZd Zy)r& r NdwFlags hStdInput
hStdOutput hStdError wShowWindowlpAttributeListc d || _ || _ || _ || _ || _ |xs dg i| _ y )N handle_listrS )r6 rT rU rV rW rX rY s r. r7 zSTARTUPINFO.__init__ s8 "DL &DN (DO &DN *D #2#I}b6ID r- c | j j }d|v rt |d |d< t | j | j
| j | j | j | S )Nr[ rS ) rY copylistr& rT rU rV rW rX )r6 attr_lists r. r] zSTARTUPINFO.copy sf ,,113I )+/ -0H+I -( t||)- *.//)- +/+;+;/8 :
:r- )r) r* r+ r7 r] r, r- r. r& r& s &'4D #D J
:r- r& c > e Zd ZdZej
fdZd Zd ZeZ y)HandleFc < | j sd| _ || y y )NT)closed)r6 CloseHandles r. Closez Handle.Close s ;; " D! r- c T | j sd| _ t | S t d )NTzalready closed)rc intr= r> s r. Detachz
Handle.Detach s& ;; " 4y -. .r- c J d| j j t | fz S )Nz%s(%d)) __class__r) rg r> s r. __repr__zHandle.__repr__ s t~~ 6 6D BB Br- N)
r) r* r+ rc _winapird re rh rk __del__r, r- r. ra ra s' $+$7$7 "
/ C r- ra PIPE_BUFi PollSelectorc y r1 r, r, r- r. _cleanuprq s r- c t y t d d D ]; } | j t j }|& t j | = y # t
$ r Y Jw xY w)N
_deadstate)_active_internal_pollsysmaxsizeremover= )instress r. rq rq s[ ? AJD%%%=CNN4(
" s A A A c v g } t j j }|dkD r| j dd|z z | S )zgReturn a list of command-line arguments reproducing the current
optimization settings in sys.flags.r -O)rw flagsoptimizeappend)argsrE s r. "_optim_args_from_interpreter_flagsr " s9 D II E qy C#+%& Kr- c ddddddd} t }| j D ]< \ }}t t j | }|dkD s&|j d ||z z > t j j r|j d
nt j j r|j d t j j r|j d t j j r|j d
t j dd }t t di }t j j }t j j }|dkD r|j d n|r|j d |r|j d |D ] }|j d|z |r|j d dD ]- }||v s|| } | du r|}
n|d| }
|j d|
f / |S )z}Return a list of command-line arguments reproducing the current
settings in sys.flags, sys.warnoptions and sys._xoptions.dBSvbq)debugdont_write_bytecodeno_siteverbose
bytes_warningquietr r z-Iz-Ez-sz-PN _xoptions zerror::BytesWarningzdefault::BytesWarningdefaultz-W)-Xdev) faulthandler tracemalloc
importtimefrozen_modules showrefcountutf8T=r )r itemsgetattrrw r r isolatedignore_environment no_user_site safe_path warnoptionsr dev_modery extend) flag_opt_mapr flagoptr warnoptsxoptionsr r rE args r. _args_from_interpreter_flagsr , s #
L . /D!'') c CIIt $ q5 KKcAg
& *
yy D 99 ' ' KK 99 ! ! KK 99 KK q!HsK,HII++Myy!!Hq-. /0 " D3J M": (? SME}!$e, KKs $: Kr- c t j j rt j } | j j
}d}| j x} r.| j j
|k7 rn|dz
}| j x} r.t j dt | t j j ryt j S )N r z"'encoding' argument not specified.zutf-8)
rw r warn_default_encoding _getframef_code co_filenamef_backwarningswarnEncodingWarning utf8_modelocale getencoding)ffilename
stacklevels r. _text_encodingr i s yy&& MMO88''
88mamxx##x/ !OJ 88mam
:%z 3 yy!!##r- rN c t |i |5 } |j | cddd S # |j xY w# 1 sw Y yxY w)zRun command with arguments. Wait for command to complete or
for timeout seconds, then return the returncode attribute.
The arguments are the same as for the Popen constructor. Example:
retcode = call(["ls", "-l"])
r N)r waitkill)rN popenargskwargsps r. r r } sJ
$V $ 66'6*
% $
FFH
% $s ?)<?Ac f t | i |}|r$|j d }|| d }t || y)aO Run command with arguments. Wait for command to complete. If
the exit code was zero then return, otherwise raise
CalledProcessError. The CalledProcessError object will have the
return code in the returncode attribute.
The arguments are the same as for the call function. Example:
check_call(["ls", "-l"])
r r )r getr
)r r retcoder3 s r. r r sB I((Gjj ;A,C #.. r- c dD ] }||v st | d d|v rS|d N|j d s3|j d s"|j d s|j d rd}nd }||d< t |t | d
d |j S ) a Run command with arguments and return its output.
If the exit code was non-zero it raises a CalledProcessError. The
CalledProcessError object will have the return code in the returncode
attribute and output in the output attribute.
The arguments are the same as for the Popen constructor. Example:
>>> check_output(["ls", "-l", "/dev/null"])
b'crw-rw-rw- 1 root root 1, 3 Oct 18 2007 /dev/null\n'
The stdout argument is not allowed as it is used internally.
To capture standard error in the result, use stderr=STDOUT.
>>> check_output(["/bin/sh", "-c",
... "ls -l non_existent_file ; exit 0"],
... stderr=STDOUT)
b'ls: non_existent_file: No such file or directory\n'
There is an additional optional argument, "input", allowing you to
pass a string to the subprocess's stdin. If you use this argument
you may not also use the Popen constructor's "stdin" argument, as
it too will be used internally. Example:
>>> check_output(["sed", "-e", "s/foo/bar/"],
... input=b"when in the course of fooman events\n")
b'when in the course of barman events\n'
By default, all communication is in bytes, and therefore any "input"
should be bytes, and the return value will be bytes. If in text mode,
any "input" should be a string, and the return value will be a string
decoded according to locale encoding, or by "encoding" if set. Text mode
is triggered by setting any of text, encoding, errors or universal_newlines.
)rB checkz- argument not allowed, it will be overridden.inputuniversal_newlinestextencodingerrors r- T)rB rN r )r= r r r rB )rN r r kwemptys r. r r s F "
< t#P QR R " &VG_ 4 ::* +vzz&/AVZZPZE[::h'EE w $t r- c H e Zd ZdZddZd Z eej Z d Z
y)r aE A process that has finished running.
This is returned by run().
Attributes:
args: The list or str args passed to run().
returncode: The exit code of the process, negative for signals.
stdout: The standard output (None if not captured).
stderr: The standard error (None if not captured).
Nc < || _ || _ || _ || _ y r1 )r r2 rB r5 )r6 r r2 rB r5 s r. r7 zCompletedProcess.__init__ s $ r- c dj | j dj | j g}| j *|j dj | j | j
*|j dj | j
dj t
| j dj | S )Nz args={!r}zreturncode={!r}z stdout={!r}z stderr={!r}z{}({})z, ) formatr r2 rB r r5 typer) join)r6 r s r. rk zCompletedProcess.__repr__ s ""499-!(( 9; ;; " KK
,,T[[9 : ;; " KK
,,T[[9 :tDz 2 2DIIdODDr- c | j r6t | j | j | j | j y)z6Raise CalledProcessError if the exit code is non-zero.N)r2 r
r rB r5 r> s r. check_returncodez!CompletedProcess.check_returncode s4 ??$T__dii%)[[2
2 r- rG ) r) r* r+ rI r7 rk classmethodtypes GenericAlias__class_getitem__r r, r- r. r r s* E $E$6$672r- r )r capture_outputrN r c | %|j d t d t |d< |r?|j d |j d t d t |d< t |d< t |i |5 } |j | | \ }}|j }
|r|
rt |
|j || ddd t j
S # t
$ rJ} |j
t r |j \ | _ | _ |j d} ~ w |j
xY w# 1 sw Y xY w) a Run command with arguments and return a CompletedProcess instance.
The returned instance will have attributes args, returncode, stdout and
stderr. By default, stdout and stderr are not captured, and those attributes
will be None. Pass stdout=PIPE and/or stderr=PIPE in order to capture them,
or pass capture_output=True to capture both.
If check is True and the exit code was non-zero, it raises a
CalledProcessError. The CalledProcessError object will have the return code
in the returncode attribute, and output & stderr attributes if those streams
were captured.
If timeout (seconds) is given and the process takes too long,
a TimeoutExpired exception will be raised.
There is an optional argument "input", allowing you to
pass bytes or a string to the subprocess's stdin. If you use this argument
you may not also use the Popen constructor's "stdin" argument, as
it will be used internally.
By default, all communication is in bytes, and therefore any "input" should
be bytes, and the stdout and stderr will be bytes. If in text mode, any
"input" should be a string, and stdout and stderr will be strings decoded
according to locale encoding, or by "encoding" if set. Text mode is
triggered by setting any of text, encoding, errors or universal_newlines.
The other arguments are the same as for the Popen constructor.
Nstdinz/stdin and input arguments may not both be used.rB r5 z@stdout and stderr arguments may not be used with capture_output.r r4 r5 )r r= r r communicater r
_mswindowsrB r5 r pollr
r r ) r r rN r r r processrB r5 excr s r. r r sJ <
::g * NO O w ::h +vzz(/C/O 4 5
5 x x $V $ $ 0 0 0 HNFF& ,,. W$Wgll,26C
C/
%2 GLL'66 BB-
LLN *1)<)<)>&
CJ
LLN )
% $s1 4E 6C -E D="AD''D==E E c B g }d}t t j | D ] }g }|r|j d d|v xs d|v xs | }|r|j d |D ]x }|dk( r|j | |dk( r4|j dt | z dz g }|j d S|r|j | g }|j | z |r|j | |s|j | |j d dj
| S ) a
Translate a sequence of arguments into a command line
string, using the same rules as the MS C runtime:
1) Arguments are delimited by white space, which is either a
space or a tab.
2) A string surrounded by double quotation marks is
interpreted as a single argument, regardless of white space
contained within. A quoted string can be embedded in an
argument.
3) A double quotation mark preceded by a backslash is
interpreted as a literal double quotation mark.
4) Backslashes are interpreted literally, unless they
immediately precede a double quotation mark.
5) If backslashes immediately precede a double quotation mark,
every pair of backslashes is interpreted as a literal
backslash. If the number of backslashes is odd, the last
backslash escapes the next double quotation mark as
described in rule 3.
F "\r z\"r )maposfsdecoder lenr r )seqresult needquoter bs_bufcs r. list2cmdliner @ s < FI2;;$ MM# CZ