֦iZ 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>> import subprocess
>>> subprocess.getstatusoutput('ls /bin/ls')
(0, '/bin/ls')
>>> subprocess.getstatusoutput('cat /bin/junk')
(1, 'cat: /bin/junk: No such file or directory')
>>> subprocess.getstatusoutput('/bin/junk')
(127, 'sh: /bin/junk: not found')
>>> subprocess.getstatusoutput('/bin/kill $$')
(-15, '')
T)shellr r5 r r r Nr|
)r r r
r4 r2 )r3 r r dataexitcodeexs r. r r sl *!Ct$v%-f> BCyDCRy T> !yy==!s * AAAc $ t | || d S )a% Return output (stdout or stderr) of executing cmd in a shell.
Like getstatusoutput(), except the exit status is ignored and the return
value is a string containing the command's output. Example:
>>> import subprocess
>>> subprocess.getoutput('ls /bin/ls')
'/bin/ls'
r r )r )r3 r r s r. r
r
s 3& A! DDr- c t st t d syt j dv ry t j
d } | j
d }t | dk7 rt |d }t t t |d j
d
}t j d k( r |d k( r|d
k\ ryy# t t t f$ r Y yw xY w)a Check if posix_spawn() can be used for subprocess.
subprocess requires a posix_spawn() implementation that properly reports
errors to the parent process, & sets errno on the following failures:
* Process attribute actions failed.
* File actions failed.
* exec() failed.
Prefer an implementation which can use vfork() in some cases for best
performance.
posix_spawnF)darwinsunos5TCS_GNU_LIBC_VERSIONr )maxsplitr r r: linuxglibc)r )r hasattrr rw platformconfstrsplitr r= tupler rg AttributeErrorOSError)verpartslibcversions r. _use_posix_spawnr s ]3
||++
jj./ 1 % u:? QxCq !456 <<7 "tw7g;M
J 0
s BB6 6C
C
c : e Zd ZdZdZ d-dddddddddd dZd Z eej Z
e d Z e j d Z d
Zd Zd Zej$ ej( fd
Zd Zd Zd.dZd Zd Z d/dZd0dZ d Z e j> d Z e!rDd Z"d Z#d Z$d Z%de&jN e&jP e&jR fdZ*d Z+d Z,d Z-d Z.d Z/e/Z0yd! Z"d" Z1d# Z%e2e3e4fd$Z5de6e7e8jr fd%Z*d& Z:d' Z+d( Z-d) Z;d* Z.d+ Z/d, Z0y)1r ar Execute a child program in a new process.
For a complete description of the arguments see the Python documentation.
Arguments:
args: A string, or a sequence of program arguments.
bufsize: supplied as the buffering argument to the open() function when
creating the stdin/stdout/stderr pipe file objects
executable: A replacement program to execute.
stdin, stdout and stderr: These specify the executed programs' standard
input, standard output and standard error file handles, respectively.
preexec_fn: (POSIX only) An object to be called in the child process
just before the child is executed.
close_fds: Controls closing or inheriting of file descriptors.
shell: If true, the command will be executed through the shell.
cwd: Sets the current directory before the child is executed.
env: Defines the environment variables for the new process.
text: If true, decode stdin, stdout and stderr using the given encoding
(if set) or the system default otherwise.
universal_newlines: Alias of text, provided for backwards compatibility.
startupinfo and creationflags (Windows only)
restore_signals (POSIX only)
start_new_session (POSIX only)
process_group (POSIX only)
group (POSIX only)
extra_groups (POSIX only)
user (POSIX only)
umask (POSIX only)
pass_fds (POSIX only)
encoding and errors: Text mode encoding and error handling to use for
file objects stdin, stdout and stderr.
Attributes:
stdin, stdout, stderr, pid, returncode
Fr| N) usergroup extra_groupsr r r umaskpipesize
process_groupc
t s+t t j t j
d t
t j | _ d| _
d| _ |d}t |t s t d |d}t |t s t d t r
|Ht! d |r |s t# j$ dt& d }|
t! d
|d k7 r t! d || _ d| _ d| _ d| _ d| _ d| _ || _ || _ || _ |$| "t; | t; | k7 r t= d
|xs
|xs |xs | | _ | j> r|tA x| _ }d| _! d| _" | j> r |dk( rd }d}nd}|d}d} |tG tH d s t! d t |tJ r! d dl&} | jQ | jR } n6t |t r|} n#t djU tW | | d k rt! d| d} |tG tH d s t! d t |tJ r t! d g } |D ] } t | tJ r0 d dl&} | jY | jQ | jR Ct | t r| jY | et djU tW | | D ] } | d k s t! d| d}!|}tG tH d s t! d t |tJ r! d dl-}"|"j] | j^ }!n t |t r|}!n t d |!d k rt! d |! | ja ||| \ }#}$}%}&}'}(t r{|$dk7 r$tc jd |$jg d }$|%dk7 r$tc jd |%jg d }%|'dk7 r$tc jd |'jg d }' |$dk7 rQti jj |$d | | _ | j> r)ti jl | j* d || | _ |%dk7 rOti jj |%d!| | _ | j> r'ti jl | j, ||" | _ |'dk7 rOti jj |'d!| | _ | j> r'ti jl | j. ||" | _ | jo ||||||
| |
|| |#|$|%|&|'|(|| | |!||| y# tN $ r t! d w xY w# tN $ r t! d w xY w# tN $ r t! d w xY w# tq d| j* | j, | j. f D ]" }) |)js # t $ r Y w xY w | jD sg }*|tt k( r|*jY |# |tt k( r|*jY |& |tt k( r|*jY |( tG | d# r|*jY | jv |*D ]N }+ t r!t |+tx r|+j{ ntI jr |+ A# t $ r Y Lw xY w xY w)$zCreate new Popen instance.z does not support processes.NFr| zbufsize must be an integerzpipesize must be an integerz0preexec_fn is not supported on Windows platformsz pass_fds overriding close_fds.Tz2startupinfo is only supported on Windows platformsr z4creationflags is only supported on Windows platformszlCannot disambiguate when both text and universal_newlines are supplied but different. Pass one or the other.g ?r setregidz>The 'group' parameter is not supported on the current platformzHThe group parameter cannot be a string on systems without the grp modulez,Group must be a string or an integer, not {}z!Group ID cannot be negative, got setgroupszEThe 'extra_groups' parameter is not supported on the current platformz#Groups must be a list, not a stringzIItems in extra_groups cannot be strings on systems without the grp modulez9Items in extra_groups must be a string or integer, not {}setreuidz=The 'user' parameter is not supported on the current platformzGThe user parameter cannot be a string on systems without the pwd modulez#User must be a string or an integerz User ID cannot be negative, got wb)
write_throughline_bufferingr r rbr _devnull)>_can_fork_execr errnoENOTSUPrw r rq threadingLock
_waitpid_lock_input_communication_started
isinstancerg TypeErrorr r= r r RuntimeWarningr r rB r5 pidr2 r r r boolr text_moder _sigint_wait_secs_closed_child_pipe_fdsr
r strgrp ImportErrorgetgrnamgr_gidr r r pwdgetpwnampw_uid _get_handlesmsvcrtopen_osfhandlerh ioopen
TextIOWrapper_execute_childfiltercloser r% ra re ),r6 r bufsize
executabler rB r5
preexec_fn close_fdsr cwdenvr startupinfo
creationflagsrestore_signalsstart_new_sessionpass_fdsr r r r r r r r r r# gidr7 gids extra_group gid_checkuidr; p2creadp2cwritec2preadc2pwriteerrreaderrwriter to_closefds, r. r7 zPopen.__init__' s
#,, /K L
'^^ - &+# ?G'3' 89 9 H(C( 9: : % "- . .
>O & "- . . ! "- . .
!3!?'(DJ6! #F G
G "IVItI7I >>h .'5'7 7DMH
"& &+# >>!|!% !& M 2z* "4 5 5 E3'J
ll5)00E3' N!'U !46 6 Qw #DSE!JKK #2{+ "E F F L#. !FGGD + k3/7" KK [ 9 @ @A S1KK ,# %9%+VD,=%>@ @ ,& " q=$'H %TUU " 2z* "8 9 9 D#&J ll4(//D#& EFFQw #CC5!IJJ& # / /vv F ( ( ( 2~!00 1BAF"} //0@!D"} //0@!D6 2~ WWXtW =
>>!#!1!1$**D+9%-f">DJ "} gggtW = >>"$"2"24;;%-f#>DK"} gggtW = >>"$"2"24;;%-f#>DK
j*i (#s +]E ' ' ' / #T3 1=
Bo # J$ &I J JJ8 ' 7 ( *6 7 778 # J$ &I J JJP D4::t{{DKK"HIGGI J .. D= OOG,T> OOH-T> OOH-4, OODMM2"B %*R*@ HHJ HHRL"
#
sz "U/ V V D%V7 /VV V472["*W;:["; X["XB ["<[[" [ [" [ ["c d| j j d| j d| j d}t | dkD r|d d dz }|S )NP L z...>)rj r) r2 r r )r6 obj_reprs r. rk zPopen.__repr__( s] ''( ) ??+7499-q
B x=2 }v-Hr- c | j S r1 )r3 r> s r. r zPopen.universal_newlines3 s ~~ r- c $ t | | _ y r1 )r2 r3 )r6 r s r. r zPopen.universal_newlines9 s 01r- c j |j || }|j dd j dd S )Nz
r
)decodereplace)r6 r r r s r. _translate_newlineszPopen._translate_newlines= s0 {{8V,||FD)11$==r- c | S r1 r, r> s r. __enter__zPopen.__enter__A s r- c | j r| j j | j r| j j | j r| j j |t k( r<| j
dkD r% | j
| j
d| _ y d| _ y | j y # t $ r
Y d| _ y w xY w# |t k( rF| j
dkD r- | j
| j
n# t $ r Y nw xY wd| _ Y y | j w xY w)Nr r ) rB rF r5 r KeyboardInterruptr4 _waitr r )r6 exc_typerE tracebacks r. __exit__zPopen.__exit__D s ;; KK ;; KK zz
",, ))A-
4+A+A
B *+& *+&
IIK
* )*& ,, ))A-
4+A+A
B) )*&
IIKsH &C
C
C C E: DE D# E"D## E0Ec | j sy | j |d| j z t | | j | | j t
t
j
| y y y )Nz subprocess %s is still running)sourcers )_child_createdr2 r1 ResourceWarningrv ru r )r6 _maxsize_warns r. rm z
Popen.__del__` si "" ?? "
2TXX=!$
0
x0 ?? "w': NN4 (; "r- c t | d s7t j t j t j | _ | j
S )Nr% )r
r rB devnullO_RDWRr% r> s r. _get_devnullzPopen._get_devnullo s0 tZ( GGBJJ :DM}} r- c r |r | j j | | j j
y # t $ r Y 't $ r)}|j t j
k( rn Y d }~Sd }~ww xY w# t $ r Y y t $ r)}|j t j
k( rn Y d }~y d }~ww xY wr1 )r writeBrokenPipeErrorr r' EINVALrF )r6 r r s r. _stdin_writezPopen._stdin_writet s
' JJ #
99 ,
yyELL( s8 ; A: A7A7 A22A7: B6B6
B11B6c | j r
|r t d || j s| j | j | j gj d dk\ rd}d}| j r| j
| n| j r5| j j }| j j n@| j r4| j j }| j j | j ||fS |t |z }nd} | j ||| \ }} d| _ | j | j | }||fS # t $ r_ |&t | j | j | }n | j }d| _ | j! | # t" $ r Y w xY ww xY w# d| _ w xY w)a9 Interact with process: Send data to stdin and close it.
Read data from stdout and stderr, until end-of-file is
reached. Wait for process to terminate.
The optional "input" argument should be data to be sent to the
child process, or None, if no data should be sent to the child.
communicate() returns a tuple (stdout, stderr).
By default, all communication is in bytes, and therefore any
"input" should be bytes, and the (stdout, stderr) will be bytes.
If in text mode (indicated by self.text_mode), any "input" should
be a string, and (stdout, 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.
z.Cannot send input after starting communicationNr r r T)r- r= r rB r5 countr readrF r _time _communicatero minr4 _remaining_timerp r )r6 r rN rB r5 endtimesigint_timeoutstss r. r zPopen.communicate s $ & &5 MN N
OD$?$?
ZZdkk 2 8 8 >! CFFzz!!%( ))+ !!# ))+ !!# IIK: 7 " 'G+
3!%!2!25'7!K" /3+))D$8$8$A)BC ) %
&%()?)?)-)=)=g)F&HN &*%;%;N)*&JJ~J6 &
/3+s= 'E* *AG/GG G G
GGG G c " | j S )zSCheck if child process has terminated. Set and return returncode
attribute.)rv r> s r. r z
Popen.poll s ""$$r- c " |y|t z
S )z5Convenience for _communicate when computing timeouts.N)r )r6 r s r. r zPopen._remaining_time s ?UW$ $r- c |y|s
t |kD rDt | j ||rdj | nd|rdj | d y)z2Convenience for checking if a timeout has expired.Nr- r )r r r r )r6 r orig_timeout
stdout_seq
stderr_seqskip_check_and_raises r. _check_timeoutzPopen._check_timeout sf ? 57W#4 II|3=388J/43=388J/I
I DHI
I $5r- c |
t |z } | j | S # t $ r_ |&t | j | j }n | j }d| _ | j | # t $ r Y w xY ww xY w)z=Wait for child process to terminate; returns self.returncode.r r )r rp ro r r4 r r )r6 rN r r s r. r z
Popen.wait s g'G ::g:. .
"!$T%;%;%)%9%9'%B"D "&!7!7%&D "
>
2
"
s. # AB (A;:B ; BB BB c t | dd }t j 5 }t ra|dk7 r|j |j
|dk7 r|j |j
|dk7 r|j |j
n|dk7 r*|dk7 r%||k7 r |j t j | |dk7 r*|dk7 r%||k7 r |j t j | |dk7 r*|dk7 r%||k7 r |j t j | | |j t j | d d d d| _ y # 1 sw Y d| _ y xY w)Nr% r| T) r
contextlib ExitStackr callbackre r rF r5 ) r6 rW rX rY rZ r[ r\
devnull_fdstacks r. _close_pipe_fdszPopen._close_pipe_fds s
T:t4
!
!
#ub=NN7==1r>NN8>>2r>NN8>>2b=X^:8MNN288W5r>gmJ8NNN288X6r>gmJ8NNN288X6%rxx4# $( '+#) $( '+#s DE Ec # K g } | y# t | d r |j | j | `|D ]N } t r!t |t
r|j
nt j | A# t $ r Y Lw xY w xY ww)zCHelper to ensure file descriptors opened in _get_handles are closedr% N)
r
r r% r r. ra re r rF r )r6 r] r^ s r. _on_error_fd_closerzPopen._on_error_fd_closer s N tZ(
.M !jV&<
s< B
B
0B
zPopen._get_handles7 s } FN/ & GX & GX & GX))+}= % 2 273K3K LG %,%7%7a%@
"(/%,,W5 ++A.d](/(:(:4(C%GX(.w9IXG!(('8)<=g% $ 2 243D3D3F GG s+ $ 2 25 9G % 2 25<<> BG 009> & 3 3G4M4M NH '&-&8&8q&A 8#)(#3%,,X6 ++A.t^(/(:(:4(C%GX(.w9IXG!(('8)<=w& % 3 3D4E4E4G HH , % 3 3F ;H & 3 3FMMO DH 11(;> & 3 3G4L4L MH '&-&8&8q&A 8#)(#3%,,X6 ++A.t^(/(:(:4(C%GX(.w9IXG!(('8)<=v% 'Hw& % 3 3D4E4E4G HH , % 3 3F ;H & 3 3FMMO DH 11(;{ ,~ XXX'
' ,+s O PP c t j t j |t j ddt j }t | S )z2Return a duplicate of handle, which is inheritabler r )rl DuplicateHandleGetCurrentProcessDUPLICATE_SAME_ACCESSra )r6 handlehs r. r zPopen._make_inheritable sE ''))+V))+Q--/A !9 r- c t |D ch c]2 }|dz dk7 s&t j | t j k7 r|4 c} S c c}w )zFilter out console handles that can't be used
in lpAttributeList["handle_list"] and make sure the list
isn't empty. This also removes duplicate handles. )r^ rl GetFileTypeFILE_TYPE_CHAR)r6 r[ r s r. _filter_handle_listzPopen._filter_handle_list sV k 4kF "SLC / # / / 7 # 2 2 3 k 4 5
5 4s 7Ac |rJ d t |t rnit |t r|
r t d t |g }n?t |t
j r|
r t d t |g }n t | }|t j | }| t }n|j }d| ||fv}|r8|xj t j z c_
| |_
||_ ||_ |j }t# |xr d|v xr |d }|s|r|r| i x}|_ t% |j' dg x}|d< |r#|t) | t) | t) | gz
}| j+ | |dd |r |st- j. dt0 d}|
r|xj t j2 z c_
t j4 |_ |st
j8 j' d } | skt
j8 j' d
d } t
j: j= | d d
} t
j: j? | s tA d t
j: j? | r| }n|} djC | | }|t j | }tE jF d|||| t jH ||ddt) | | ||| \ } } } }!| jK | | |
||| d| _& tO | | _( | | _) t jT | y# | jK | | |
||| w xY w)z$Execute program (MS Windows version)z"pass_fds not supported on Windows.z$bytes args is not allowed on Windows0path-like args is not allowed when shell is trueNr| r[ z?startupinfo.lpAttributeList['handle_list'] overriding close_fdsFComSpec
SystemRootr System32zcmd.exez:shell not found: neither %ComSpec% nor %SystemRoot% is setz
{} /c "{}"subprocess.PopenT)+r. r6 bytesr/ r r PathLiker r& r] rT rl r rU rV rW rY r2 r^ r rg r r r r0 r r rX environpathr isabsFileNotFoundErrorr rw audit
CreateProcessr rv ra _handler1 rd )"r6 r rH rI rJ rQ rK rL rM rN r rW rX rY rZ r[ r\ unused_restore_signals
unused_gid unused_gids
unused_uid unused_umaskunused_start_new_sessionunused_process_groupuse_std_handlesattribute_listhave_handle_listr[ comspec system_roothphtr1 tids" r. rD zPopen._execute_child s? E!E E<$$D%(#$JKK#TF+D"++.# %4 5 5#TF+#D)% [[ 4
" )m * . . 0 (H(E EO ##w'C'CC#(/ %)1 &(0 % ( 8 8N #N %B$1^$C%B$2=$A C
O !)CEEN[%@ ++M2>?@ n] ; # CL#h-X #OOK!%!9!9+!F A $
'=>LN !&I##w'C'CC#*1// '! !jjnnY 7G"&(jjnn\2&F "$'',,{J "R !ww}}W 5"34p"q qww}}W-%,
(G#**GT:kk#& II(*dC E
8#*#8#8T)-t),]);)6),),)4$6 BS $$Wh%,h%,h8
#'D !":DLDH # $$Wh%,h%,h8s ,M M$c | j - || j d |k( r || j | _ | j S )zCheck if child process has terminated. Returns returncode
attribute.
This method is called by __del__, so it can only refer to objects
in its local scope.
r )r2 r )r6 rt _WaitForSingleObject_WAIT_OBJECT_0_GetExitCodeProcesss r. rv zPopen._internal_poll s; &' a8NJ&9$,,&GDO?? "r- c ^ |t j }n|dk rd}nt |dz }| j mt j | j
| }|t j k( rt | j | t j | j
| _ | j S )z-Internal implementation of wait() on Windows.r i )
rl INFINITErg r2 WaitForSingleObjectr WAIT_TIMEOUTr r GetExitCodeProcess)r6 rN timeout_millisr s r. rp z Popen._wait, s !(!1!1A !"!$Wt^!4& 44T\\5CEW 1 11(G<<")"<" s MM"'') $ HHJr- c | j rzt | d sng | _ t j | j
| j | j f | _ d| j _ | j j | j rzt | d sng | _
t j | j
| j | j f | _ d| j _ | j j | j r| j | | j Z| j j | j | | j j! rt# | j$ | | j Z| j j | j | | j j! rt# | j$ | d }d }| j r&| j }| j j' | j r&| j }| j j' |r|d nd }|r|d nd }||fS )N _stdout_buff)targetr T _stderr_buffr )rB r
r r) Threadr
stdout_threaddaemonstartr5 r
stderr_threadr r r r is_aliver r rF )r6 r r r rB r5 s r. r zPopen._communicateC s {{74 #@$&!!((0B0B/3{{D zPopen._get_handles s; !' GX & GX & GX))+}=d](* %GX!(('8)<=}}q(WUN-K He.@.@$--Pg% " / / 1G s+ #G $llnG>t^(* %GX!(('8)<=}}q(WUN-K He.@.@$--Pw& # 0 0 2H , %H &}}H>t^(* %GX!(('8)<=}}q(WUN-K He.@.@$--Pv% 2~#+#&>>#8#8#:w& # 0 0 2H , %H &}}Hc ,f XXX'
'g ,+s I7J''J0c |t j }i } |r3g } dD ]' }
t t |
d }|| j | ) | | d< g }||| fD ]) }|dk7 s |j t j
|f + |df|df|
dffD ]- \ }}|dk7 s |j t j ||f / |r|| d< t j |||fi | | _ d | _ | j ||||| |
y)
z'Execute program using os.posix_spawn().N)SIGPIPESIGXFZSIGXFSZ setsigdefr| r r r file_actionsT) r r r r; r POSIX_SPAWN_CLOSEPOSIX_SPAWN_DUP2r r1 rv r )r6 r rH rL rO rW rX rY rZ r[ r\ r sigsetsignamesignumr r^ fd2s r. _posix_spawnzPopen._posix_spawn s#
{jjF ?G $VWd ;F )
f- @ '-{# L '28 '')=)=r(BC 3 ! 1
1
C
8 '')<)z'Popen._execute_child..X s1 0>'< GGLLS)9: F'')'7'7'<0> +> #&h-K OOM2 ) / %uVC[4I-J'K #Xw #X (- +-> )3c5 &
4DH +/D' HH]+$$Wh%,h%,h8 ){ 77<7D D(L 3|#4u#< & !zz$((A 6HCdhh //4*-++ 7 ( . .tQ 7 7NIw
&nn .G (/ ."7"7"@'()$ 2G< #Ir 2I .0"$'* H,"$'+ '6 A~"$++i"8#/ 29g| TT 29g FF*733U % HH]+ & ) " 7%7N $I C J J"' "5 7G7sE 8D9P> 1A#Q .AQ2 &R >QQ Q/2 Q>=Q>'R+*R+c L || r || | _ y || | _ y):All callers to this function MUST hold self._waitpid_lock.N)r2 )r6 r _waitstatus_to_exitcode _WIFSTOPPED _WSTOPSIGs r. r" zPopen._handle_exitstatus s% 3 #,S>/"9#">r- c 2 | j | j j d sy | j &| j | j j S || j | \ }}|| j k( r| j | | j j | j S | j S # t $ r*}||| _ n|j |k( rd| _ Y d}~`d}~ww xY w# | j j w xY w)zCheck if child process has terminated. Returns returncode
attribute.
This method is called by __del__, so it cannot reference anything
outside of the local scope (nor can any methods it calls).
NFr )r2 r+ acquirereleaser1 r" r r' )r6 rt _waitpid_WNOHANG_ECHILDr1 r es r. rv zPopen._internal_poll s &))11%8 12 # &&..0 (( ;HCdhh //4 &&..0?? "4?? " ,!-*4G+ +, , &&..0s/ C 6C C7
C2-C: 2C77C: : Dc t j | j | \ }}||fS # t $ r | j }d}Y ||fS w xY w)r: r )r r! r1 r# )r6
wait_flagsr1 r s r. _try_waitzPopen._try_wait sV
ZZ* =
c :
%
hh:
s #) AAc D | j | j S |Lt |z }d} | j j d r | j ' | j j | j S | j t j \ }}|| j k( s|dk( sJ || j k( r8| j | | j j | j S | j j | j | }|dk rt | j | t |dz |d }t j | <| j w| j 5 | j ddd | j S | j d \ }}|| j k( r| j | ddd | j w| j S # | j j w xY w# 1 sw Y AxY w)z+Internal implementation of wait() on POSIX.NgMb@?Fr r g?)r2 r r+ r? r@ rG r WNOHANGr1 r" r r r r timesleep)r6 rN r delayr1 r remainings r. rp z Popen._wait s *&" 'G+ ))11%8 9 # : % ! . . 6 6 8" ?? "/ *.
)CJS##&$((?cQh >#> "dhh $ 7 7 < % . . 6 6 8" ?? "+ / ! . . 6 6 8 $ 4 4W =I A~ ,TYY @@ 9c :EJJu%! $ oo- ++ ??6 ! , ?? "
&*^^A%6
c $((? 3 3C 8 , oo- ?? "# ! . . 6 6 8 ,+s% G7 ;AG7 H"4H7 HH c
| j rD| j s8 | j j |s | j j d }d }| j sQi | _ | j rg | j
| j < | j rg | j
| j < | j r| j
| j }| j r| j
| j }| j | | j rt | j }t 5 }| j r,|r*|j | j t j | j r@| j j s*|j | j t j | j r@| j j s*|j | j t j |j# r| j% | }|&|dk r!| j' ||||d t) d |j+ | } | j' |||| | D ]o \ }
} |
j, | j u r| j. | j. t0 z } | xj. t3 j4 |
j6 | z
c_ | j. t9 | j k\ s|j; |
j, |
j, j |
j, | j | j fv st3 j< |
j6 d }
|
s5|j; |
j, |
j, j | j
|
j, j? |
r |j# rd d d | jA | j% | |djC | }|djC | }| jD rz|;| jG || j jH | j jJ }|;| jG || j jH | j jJ }||fS # t $ r Y w xY w# t $ r Y w xY w# t $ r9 |j; |
j, |
j, j Y w xY w# 1 sw Y @xY w)Nr T)r zN_check_timeout(..., skip_check_and_raise=True) failed to raise TimeoutExpired.i r r- )&r r- flushr rF _fileobj2outputrB r5 _save_inputr,
memoryview_PopenSelectorregister selectors EVENT_WRITErc
EVENT_READget_mapr r RuntimeErrorselectfileobj
_input_offset _PIPE_BUFr r r^ r
unregisterr r r r r3 rk r r )r6 r r r rB r5
input_viewselectorrN readykeyeventschunkr s r. r zPopen._communicate s> zz$"="=JJ$$&
((* FF ..')$;;8:D((5;;8:D((5{{ --dkk:{{ --dkk: U #{{ ' 4
!X::% %%djj)2G2GH;;t{{'9'9 %%dkk93G3GH;;t{{'9'9 %%dkk93G3GH &&( " 2 27 ;G *w{ ++G\,2FAE , G + > ? ? %OOG 4E'' vvN
(- V ;;$**4$.t/A/A/3/A/AI/M%OE 8 $ 2 2bhhsvvu6M M 2
$(#5#5T[[9I#I$,$7$7 $D$'KK$5$5$7 [[T[[$++,F F#%773665#9D#' ( 3 3CKK @ # 1 1 3 0 0 = D DT J% (-! &&( "X
IId 2 27 ;I < ! &)! &) ~~% ! 5 5f6:kk6J6J6:kk6H6H JF % ! 5 5f6:kk6J6J6:kk6H6H JF F# #{ '
+ l $3 4 ( 3 3CKK @ # 1 1 3 4= "!sa S S( 8FT=:3S8-"T=AT=+BT= S%$S%( S54S58>T:6T=9T::T==Uc | j ru| j hd| _ || _ |W| j rJ| j j | j j
| j j | _ y y y y y )Nr )r r, r\ r3 encoder r )r6 r s r. rQ zPopen._save_inputt sn zzdkk 1%&" # $ "&++"4"4TZZ5H5H59ZZ5F5F#HDK *8$ 2zr- c | j | j y t j | j | y# t
$ r Y yw xY w)r N)r r2 r r r1 ProcessLookupErrorr s r. r zPopen.send_signal sC $
IIK*
#&%
s A A A c B | j t j y)z/Terminate the process with SIGTERM
N)r r; r r> s r. r zPopen.terminate
V^^ ,r- c B | j t j y)z*Kill the process with SIGKILL
N)r r; SIGKILLr> s r. r z
Popen.kill rj r- )r| NNNNNTFNNNNr TFr, rG )Fr1 ) r r rD rl r
WAIT_OBJECT_0r rv rp r r r r r r r; r< r= r" rA rB r' ECHILDrG rQ r, r- r. r r s 6n N4815,0EI129>
'+$T t$b2 #B $E$6$67
2 2>8 #{{(--
!
2A H% % -2 I.+: & L '^
5} $~ -1%,%@%@ & 4 4$+$>$> #" #$
0 $d G
% = '@% 4Ng 4V 8O+6)2
? -18!5<< #F
& #Rc $L H @ -
-r- r )\rI r$ r' rA r r rJ r; rw r) r r r r r r r8 __all__r? r ModuleNotFoundErrorr r& rl r r r r r r r r r r r r r r! r" r# r$ r% r _posixsubprocessr' r r! rA waitstatus_to_exitcoder;
WIFSTOPPEDr< WSTOPSIGr= rI rB rZ rU Exceptionr r
r r& rg ra r r] r
ro rS SelectSelectorru rq r r r r r r r r r objectr r r r r
r r r r r, r- r. ry sQ D
#
D J %;;
O O O O O NN N O <::"$";"; mm KK ::
"& 'i &" " J _ 8 : :. ,
C0I
y.)"//"11 G
G
:z$( " "
& &* 2 j!2v !2J 5$eCCLCR &*$ @ $D
E -d $%
{- {-e E Js# F> G >G G GG