B
œ< "b#+ã @ s` d Z ddlZejdkZddlZddlZddlZddlZddlZddl Z ddl
Z
ddlm Z G dd„ de
ƒZG dd„ deƒZG d d
„ d
eƒZer¶ddlZddlZddlZG d d „ d ƒZnDddlZddlZddlZddlZeed
dƒZeedƒrôejZ nej Z ddddddddddddd
dgZ er°ddlm 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,m-Z-m.Z.m/Z/m0Z0 e 1d d d d d d!d"d#d d$d%d&d'd(d)d*d+d,d-g¡ G d.d/„ d/e2ƒZ3erÄdZ4d0d1„ Z5n g Z4d2d1„ Z5d3Z6d4Z7d5Z8d6d7„ Z9d8d9„ Z:dd:œd;d„Z;dd„ de>ƒZ?dd?dd?d@œdAd„Z@dBdC„ ZAdDd„ ZBdEd„ ZCG dFd„ de>ƒZDdS )Ga• 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
é NZwin32)Ú monotonicc @ s e Zd ZdS )ÚSubprocessErrorN)Ú__name__Ú
__module__Ú __qualname__© r r ú//opt/alt/python37/lib64/python3.7/subprocess.pyr 9 s r c @ s< e Zd ZdZd
dd„Zdd„ Zedd„ ƒZejd d„ ƒZdS ) ÚCalledProcessErrorz£Raised when run() is called with check=True and the process
returns a non-zero exit status.
Attributes:
cmd, returncode, stdout, stderr, output
Nc C s || _ || _|| _|| _d S )N)Ú
returncodeÚcmdÚoutputÚstderr)Úselfr
r r r
r r r Ú__init__C s zCalledProcessError.__init__c C sb | j rN| j dk rNyd| jt | j ¡f S tk
rJ d| j| j f S X nd| j| j f S d S )Nr zCommand '%s' died with %r.z)Command '%s' died with unknown signal %d.z.Command '%s' returned non-zero exit status %d.)r
r ÚsignalZSignalsÚ
ValueError)r r r r Ú__str__I s zCalledProcessError.__str__c C s | j S )z+Alias for output attribute, to match stderr)r )r r r r ÚstdoutU s zCalledProcessError.stdoutc C s
|| _ d S )N)r )r Úvaluer r r r Z s )NN) r r r Ú__doc__r r Úpropertyr Úsetterr r r r r < s
r c @ s< e Zd ZdZd
dd„Zdd„ Zedd„ ƒZejd d„ ƒZdS ) ÚTimeoutExpiredz›This exception is raised when the timeout expires while waiting for a
child process.
Attributes:
cmd, output, stdout, stderr, timeout
Nc C s || _ || _|| _|| _d S )N)r Útimeoutr r
)r r r r r
r r r r h s zTimeoutExpired.__init__c C s d| j | jf S )Nz'Command '%s' timed out after %s seconds)r r )r r r r r n s zTimeoutExpired.__str__c C s | j S )N)r )r r r r r r s zTimeoutExpired.stdoutc C s
|| _ d S )N)r )r r r r r r v s )NN) r r r r r r r r r r r r r r a s
r c @ s, e Zd Zdddddddœdd„Zdd„ ZdS )Ú STARTUPINFOr N)ÚdwFlagsÚ hStdInputÚ
hStdOutputÚ hStdErrorÚ wShowWindowÚlpAttributeListc C s0 || _ || _|| _|| _|| _|p(dg i| _d S )NÚ handle_list)r r r r r r )r r r r r r r r r r r ‚ s zSTARTUPINFO.__init__c C s@ | j ¡ }d|kr"t|d ƒ|d< t| j| j| j| j| j|dS )Nr! )r r r r r r ) r ÚcopyÚlistr r r r r r )r Z attr_listr r r Ú_copy‹ s
zSTARTUPINFO._copy)r r r r r$ r r r r r s r ZPIPE_BUFi Ú PollSelectorÚPopenÚPIPEÚSTDOUTÚcallÚ
check_callÚgetstatusoutputÚ getoutputÚ check_outputÚrunÚDEVNULLÚCompletedProcess)ÚCREATE_NEW_CONSOLEÚCREATE_NEW_PROCESS_GROUPÚSTD_INPUT_HANDLEÚSTD_OUTPUT_HANDLEÚSTD_ERROR_HANDLEÚSW_HIDEÚSTARTF_USESTDHANDLESÚSTARTF_USESHOWWINDOWÚABOVE_NORMAL_PRIORITY_CLASSÚBELOW_NORMAL_PRIORITY_CLASSÚHIGH_PRIORITY_CLASSÚIDLE_PRIORITY_CLASSÚNORMAL_PRIORITY_CLASSÚREALTIME_PRIORITY_CLASSÚCREATE_NO_WINDOWÚDETACHED_PROCESSÚCREATE_DEFAULT_ERROR_MODEÚCREATE_BREAKAWAY_FROM_JOBr1 r2 r3 r4 r5 r6 r7 r8 r9 r: r; r< r= r> r? r@ rA rB c @ s6 e Zd ZdZejfdd„Zdd„ Zdd„ ZeZ eZ
dS ) ÚHandleFc C s | j sd| _ || ƒ d S )NT)Úclosed)r Ú CloseHandler r r ÚCloseÊ s z Handle.Closec C s | j sd| _ t| ƒS tdƒ‚d S )NTzalready closed)rD Úintr )r r r r ÚDetachÏ s z
Handle.Detachc C s d| j jt| ƒf S )Nz%s(%d))Ú __class__r rG )r r r r Ú__repr__Õ s zHandle.__repr__N) r r r rD Ú_winapirE rF rH rJ Ú__del__r r r r r rC Ç s rC c C s d S )Nr r r r r Ú_cleanupç s rM c C s` t d kr d S xNt d d … D ]>} | jtjd}|d k ryt | ¡ W q tk
rV Y qX qW d S )N)Ú
_deadstate)Ú_activeÚ_internal_pollÚsysÚmaxsizeÚremover )ÚinstZresr r r rM ð s éÿÿÿÿéþÿÿÿéýÿÿÿc C s* g } t jj}|dkr&| dd| ¡ | S )zgReturn a list of command-line arguments reproducing the current
optimization settings in sys.flags.r ú-ÚO)rQ ÚflagsÚoptimizeÚappend)Úargsr r r r Ú"_optim_args_from_interpreter_flags s
r^ c C sb dddddddœ} t ƒ }x:| ¡ D ].\}}ttj|ƒ}|dkr"| d || ¡ q"W tjjrh| d
¡ n$tjjrz| d ¡ tjjrŒ| d ¡ tj d
d
… }tjj
}ttdi ƒ}d|k}|dkrÊ| d¡ n|rØ| d¡ |ræ| d¡ x|D ]}| d| ¡ qìW |r| d¡ xJdD ]B}||kr|| } | dkr>|}
n d|| f }
| d|
f¡ qW |S )z}Return a list of command-line arguments reproducing the current
settings in sys.flags, sys.warnoptions and sys._xoptions.ÚdÚBÚSÚvÚbÚq)ÚdebugÚdont_write_bytecodeÚno_siteÚverboseÚ
bytes_warningÚquietr rX z-Iz-Ez-sNÚ _xoptionsÚdevé zerror::BytesWarningzdefault::BytesWarningÚdefaultz-W)z-Xrl )Z faulthandlerÚ tracemallocZ
importtimeZshowalloccountZ showrefcountÚutf8Tz%s=%sz-X)
r^ ÚitemsÚgetattrrQ rZ r\ ÚisolatedÚignore_environmentÚ no_user_siteÚ warnoptionsri rS Úextend) Z flag_opt_mapr] ÚflagZoptrb Zwarnoptsri ZxoptionsÚdev_moder Úargr r r Ú _args_from_interpreter_flags sN
r{ )r c O s> t ||Ž*}y |j| dS | ¡ ‚ Y nX W dQ R X dS )zÞRun command with arguments. Wait for command to complete or
timeout, then return the returncode attribute.
The arguments are the same as for the Popen constructor. Example:
retcode = call(["ls", "-l"])
)r N)r& ÚwaitÚkill)r Ú popenargsÚkwargsÚpr r r r) K s c O s6 t | |Ž}|r2| d¡}|dkr(| d }t||ƒ‚dS )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] Nr )r) Úgetr )r~ r Úretcoder r r r r* \ s
c O sT d|krt dƒ‚d|kr<|d dkr<| dd¡r4dnd|d< t|t| d d
œ|—ŽjS ) 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.
r z3stdout argument not allowed, it will be overridden.ÚinputNÚuniversal_newlinesFÚ ó T)r r Úcheck)r r r. r' r )r r~ r r r r r- o s #c @ s* e Zd ZdZd dd„Zdd„ Zdd„ ZdS )
r0 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 C s || _ || _|| _|| _d S )N)r] r
r r
)r r] r
r r
r r r r © s zCompletedProcess.__init__c C sh d | j¡d | j¡g}| jd k r4| d | j¡¡ | jd k rP| d | j¡¡ d t| ƒjd |¡¡S )Nz args={!r}zreturncode={!r}z stdout={!r}z stderr={!r}z{}({})z, ) Úformatr] r
r r\ r
Útyper Újoin)r r] r r r rJ ¯ s
zCompletedProcess.__repr__c C s | j r t| j | j| j| jƒ‚dS )z6Raise CalledProcessError if the exit code is non-zero.N)r
r r] r r
)r r r r Úcheck_returncode¸ s z!CompletedProcess.check_returncode)NN)r r r r r rJ r‹ r r r r r0 ž s
F)rƒ Úcapture_outputr r‡ c O s | dk r&| d¡dk r tdƒ‚t|d< |r^| d¡dk sF| d¡dk rNtdƒ‚t|d< t|d< t||Ž¢}y|j| |d\}}W n^ tk
rÊ } z,| ¡ tr°| ¡ \| _| _ n|
¡ ‚ W dd} ~ X Y n | ¡ ‚ Y nX | ¡ }
|r|
rt |
|j
||d‚W dQ R X t|j
|
||ƒS ) aK 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.
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 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.
NÚstdinz/stdin and input arguments may not both be used.r r
z@stdout and stderr arguments may not be used with capture_output.)r )r r
)r r r' r& Ú communicater r} Ú
_mswindowsr r
r| Úpollr r] r0 ) rƒ rŒ r r‡ r~ r Zprocessr r
Úexcr‚ r r r r. ¿ s4 c C sè g }d}xÔ| D ]Ì}g }|r$| d¡ d|kp8d|kp8| }|rH| d¡ xj|D ]b}|dkrf| |¡ qN|dkr”| dt|ƒ d ¡ g }| d¡ qN|r¦| |¡ g }| |¡ qNW |rÂ| |¡ |r| |¡ | d¡ qW d |¡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ú ú ú"ú\é z\"r… )r\ Úlenrw rŠ )ÚseqÚresultZ needquoterz Zbs_bufÚcr r r Ú list2cmdline s4
r› c
C sl yt | ddtd}d}W n. tk
rF } z|j}|j}W dd}~X Y nX |dd… dkrd|dd… }||fS )aö Return (exitcode, output) of executing cmd in a shell.
Execute the string 'cmd' in a shell with 'check_output' and
return a 2-tuple (status, output). The locale encoding is used
to decode the output and process newlines.
A trailing newline is stripped from the output.
The exit status for the command can be interpreted
according to the rules for the function 'wait'. Example:
>>> 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)ÚshellÚtextr
r NrU Ú
)r- r( r r r
)r ÚdataZexitcodeZexr r r r+ M s c C s 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'
rm )r+ )r r r r r, l s
c @ s˜ e Zd ZdZdZdGddddœd d
„Zed d „ ƒZejd
d „ ƒZdd„ Z dd„ Z
dd„ Z e j
ejfdd„Zdd„ Zdd„ ZdHdd„Zd d „ Zd d „ ZdId d!„ZdJd"d#„Zerd$d%„ Zd&d'„ Zd(d)„ Zd*d+„ Z de j e j e j fd,d-„Z!d.d/„ Z"d0d1„ Z#d2d3„ Z$d4d5„ Z%d6d7„ Z&e&Z'n‚d8d%„ Zd9d+„ Z e(j)e(j*e(j+e(j,e(j-e(j.fd:d;„Z/de(j0e(j1e2j3fd„ Z4d?d/„ Z"d@d3„ Z$dAdB„ Z5dCd5„ Z%dDd7„ Z&dEdF„ Z'dS )Kr& aâ 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)
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
FrU NTr r )ÚencodingÚerrorsr c C sZ t ƒ t ¡ | _d| _d| _|dkr(d}t|tƒs:tdƒ‚t rP|dk rˆt
dƒ‚n8|rh|sht dt
¡ d}|
dk rxt
dƒ‚|d krˆt
d
ƒ‚|| _d| _d| _d| _d| _d| _|| _|| _|dk rà| dk ràt| ƒt|ƒkràtd ƒ‚| |||¡\}}}}}}t rN|dkrt | ¡ d ¡}|dkr4t | ¡ d ¡}|dkrNt | ¡ d ¡}|pb|pb|pb| | _ d | _ d| _ yÜ|dkr²t |d
|¡| _| j r²t j!| jd|dk||d| _|dkrèt |d|¡| _| j rèt j!| j||d| _|dkr t |d|¡| _| j r t j!| j||d| _| "||||||
| |
|| ||||||||¡ W n xDt#d| j| j| jfƒD ]*}y | $¡ W n t%k
r” Y nX qnW | j sNg } |t&kr¼| '|¡ |t&krÐ| '|¡ |t&krä| '|¡ t(| dƒrü| '| j)¡ xP| D ]H} y*t r$t| t*ƒr$| +¡ n
t, $| ¡ W n t%k
rF Y nX qW ‚ Y nX dS )zCreate new Popen instance.NFrU zbufsize 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 Ð?Úwbrm )Ú
write_throughÚline_bufferingr r¡ Úrb)r r¡ Ú_devnull)-rM Ú threadingZLockÚ
_waitpid_lockÚ_inputÚ_communication_startedÚ
isinstancerG Ú TypeErrorr r ÚwarningsÚwarnÚRuntimeWarningr] r r r
Úpidr
r r¡ Úboolr Ú _get_handlesÚmsvcrtZopen_osfhandlerH Ú text_modeÚ_sigint_wait_secsÚ_closed_child_pipe_fdsÚioÚopenÚ
TextIOWrapperÚ_execute_childÚfilterÚcloseÚOSErrorr' r\ Úhasattrr¦ rC rF Úos) r r] ÚbufsizeÚ
executabler r r
Ú
preexec_fnÚ close_fdsrœ ÚcwdÚenvr„ Ú startupinfoÚ
creationflagsÚrestore_signalsÚstart_new_sessionÚpass_fdsr r¡ r Úp2creadÚp2cwriteÚc2preadÚc2pwriteÚerrreadÚerrwriteÚfZto_closeÚfdr r r r © s°
zPopen.__init__c C s | j S )N)r´ )r r r r r„ > s zPopen.universal_newlinesc C s t |ƒ| _d S )N)r± r´ )r r„ r r r r„ D s c C s | ||¡}| dd¡ dd¡S )Nz
rž ú
)ÚdecodeÚreplace)r rŸ r r¡ r r r Ú_translate_newlinesH s zPopen._translate_newlinesc C s | S )Nr )r r r r Ú __enter__L s zPopen.__enter__c C sˆ | j r| j ¡ | jr | j ¡ z| jr2| j ¡ W d |tkrz| jdkrpy| j| jd W n tk
rn Y nX d| _d S | ¡ X d S )Nr )r ) r r¼ r
r ÚKeyboardInterruptrµ Ú_waitr r| )r Úexc_typer Ú tracebackr r r Ú__exit__O s
zPopen.__exit__c C sT | j s
d S | jd kr(|d| j t| d | j|d | jd krPtd k rPt | ¡ d S )Nz subprocess %s is still running)Úsource)rN )Ú_child_createdr
r° ÚResourceWarningrP rO r\ )r Z_maxsizeZ_warnr r r rL k s
z
Popen.__del__c C s" t | dƒs t tjtj¡| _| jS )Nr¦ )r¾ r¿ r¸ ÚdevnullÚO_RDWRr¦ )r r r r Ú _get_devnullz s
zPopen._get_devnullc
C s² |rZy| j |¡ W nD tk
r( Y n2 tk
rX } z|jtjkrFn‚ W d d }~X Y nX y| j ¡ W nD tk
r| Y n2 tk
r¬ } z|jtjkršn‚ W d d }~X Y nX d S )N)r ÚwriteÚBrokenPipeErrorr½ ÚerrnoZEINVALr¼ )r rƒ r‘ r r r Ú _stdin_write s" zPopen._stdin_writec C sT | j r|rtdƒ‚|dkr”| j s”| j| j| jg d¡dkr”d}d}| jrT| |¡ n6| jrp| j ¡ }| j ¡ n| jrŠ| j ¡ }| j ¡ | ¡ n¸|dk r¨t
ƒ | }nd}z„y| |||¡\}}W nh t k
r, |dk ròt
| j| |¡ƒ}n| j}d| _y| j|d W n tk
r$ Y nX ‚ Y nX W dd| _ X | j | |¡d}||fS )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 r r
Úcountræ Úreadr¼ r| Ú_timeÚ _communicaterØ Úminrµ Ú_remaining_timerÙ r )r rƒ r r r
ÚendtimeÚsigint_timeoutÚstsr r r rŽ ˜ sD
zPopen.communicatec C s | ¡ S )zSCheck if child process has terminated. Set and return returncode
attribute.)rP )r r r r r Ü s z
Popen.pollc C s |dkr dS |t ƒ S dS )z5Convenience for _communicate when computing timeouts.N)ré )r rí r r r rì â s zPopen._remaining_timec C sL |dkr dS |st ƒ |krHt| j||r0d |¡nd|r@d |¡ndd‚dS )z2Convenience for checking if a timeout has expired.Nr† )r r
)ré r r] rŠ )r rí Ú orig_timeoutZ
stdout_seqZ
stderr_seqÚskip_check_and_raiser r r Ú_check_timeoutê s zPopen._check_timeoutc C sˆ |dk rt ƒ | }y | j|dS tk
r‚ |dk rJt| j| |¡ƒ}n| j}d| _y| j|d W n tk
rz Y nX ‚ Y nX dS )z=Wait for child process to terminate; returns self.returncode.N)r r )ré rÙ rØ rë rµ rì r )r r rí rî r r r r| ö s
z
Popen.waitc C s~ |dkr |dkr |dkr dS d\}}d\}}d\}} |dkrtt t j¡}|dkrÜt dd¡\}}
t|ƒ}t |
¡ nh|tkr t dd¡\}}t|ƒt|ƒ }}n<|tkr¸t |
¡ ¡}n$t |t ƒrÎt |¡}nt |
¡ ¡}| |¡}|dkr*t t j¡}|dkr˜t dd¡\}
}t|ƒ}t |
¡ nn|tkrXt dd¡\}}t|ƒt|ƒ }}n@|tkrrt |
¡ ¡}n&t |t ƒrŠt |¡}nt |
¡ ¡}| |¡}|dkræt t j¡} | dkrdt dd¡\}
} t| ƒ} t |
¡ n~|tkrt dd¡\}} t|ƒt| ƒ }} nP|tkr$|} n@|tkr>t |
¡ ¡} n&t |t ƒrVt |¡} nt |
¡ ¡} | | ¡} |||||| fS )z|Construct and return tuple with IO objects:
p2cread, p2cwrite, c2pread, c2pwrite, errread, errwrite
N)rU rU rU rU rU rU )rU rU r )rK Z GetStdHandler3 Z
CreatePiperC rE r' r/ r³ Z
get_osfhandlerâ r« rG ÚfilenoÚ_make_inheritabler4 r5 r( ) r r r r
rË rÌ rÍ rÎ rÏ rÐ Ú_r r r r² sn
zPopen._get_handlesc C s& t t ¡ |t ¡ ddt j¡}t|ƒS )z2Return a duplicate of handle, which is inheritabler rm )rK ZDuplicateHandleZGetCurrentProcessZDUPLICATE_SAME_ACCESSrC )r ÚhandleÚhr r r rô Z s
zPopen._make_inheritablec C s t dd„ |D ƒƒS )z°Filter 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.c S s, h | ]$}|d @ d ks$t |¡t jkr|’qS )é )rK Z GetFileTypeZFILE_TYPE_CHAR)Ú.0rö r r r ú j s z,Popen._filter_handle_list..)r# )r r! r r r Ú_filter_handle_listc s zPopen._filter_handle_listc C sD t |tƒst|ƒ}|dkr"tƒ }n| ¡ }d| ||fk}|r^| jtjO _| |_||_ ||_
|j }t |oxd|kox|d ƒ}|sˆ|rú|rú|dkrši }|_ t
| dg ¡ƒ }|d< |rÐ|t| ƒt|ƒt|ƒg7 }| |¡|dd…< |rú|söt dt¡ d}|
rˆ| jtjO _tj|_|sxtj d¡}|sdtj dd¡}tj |d d
¡}tj |¡sdt d ƒ‚tj |¡r||}n|}d ||¡}z@t ||ddt| ƒ| ||dk r¶t |¡nd|¡ \}}}} W d| dkrÜ| ¡ |dkrî| ¡ |dkr | ¡ t!| d
ƒrt "| j#¡ d| _$X d| _%t&|ƒ| _'|| _(t )|¡ dS )z$Execute program (MS Windows version)NrU r! z?startupinfo.lpAttributeList['handle_list'] overriding close_fdsFZComSpecZ
SystemRootr… ZSystem32zcmd.exez:shell not found: neither %ComSpec% nor %SystemRoot% is setz
{} /c "{}"r¦ T)*r« Ústrr› r r$ r rK r7 r r r r r± r# r rG rû r r® r¯ r8 r6 r r¿ ÚenvironÚpathrŠ ÚisabsÚFileNotFoundErrorrˆ Z
CreateProcessÚfspathrF r¾ r¼ r¦ r¶ rÞ rC Ú_handler° rE ) r r] rÁ r rà rÊ rÄ rÅ rÆ rÇ rœ rË rÌ rÍ rÎ rÏ rÐ Zunused_restore_signalsZunused_start_new_sessionZuse_std_handlesZattribute_listZhave_handle_listr! ZcomspecZ system_rootZhpZhtr° Útidr r r rº p s|
zPopen._execute_childc C s, | j dkr&|| jdƒ|kr&|| jƒ| _ | j S )zÎCheck 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.
Nr )r
r )r rN Z_WaitForSingleObjectZ_WAIT_OBJECT_0Z_GetExitCodeProcessr r r rP á s
zPopen._internal_pollc C s^ |dkrt j}n t|d ƒ}| jdkrXt | j|¡}|t jkrJt| j|ƒ‚t | j¡| _| jS )z-Internal implementation of wait() on Windows.Niè )
rK ZINFINITErG r
ÚWaitForSingleObjectr Z WAIT_TIMEOUTr r] ÚGetExitCodeProcess)r r Ztimeout_millisr™ r r r rÙ ò s
z Popen._waitc C s | | ¡ ¡ | ¡ d S )N)r\ rè r¼ )r ZfhÚbufferr r r Ú
_readerthread s zPopen._readerthreadc C s\ | j rBt| dƒsBg | _tj| j| j | jfd| _d| j_| j ¡ | j r„t| dƒs„g | _
tj| j| j | j
fd| _ d| j _| j ¡ | j r”|
|¡ | j d k rÆ| j | |¡¡ | j ¡ rÆt| j|ƒ‚| j d k rø| j | |¡¡ | j ¡ røt| j|ƒ‚d }d }| j r| j}| j ¡ | j r0| j
}| j ¡ |d k rB|d }|d k rT|d }||fS )NÚ _stdout_buff)Útargetr] TÚ _stderr_buffr )r r¾ r r§ ZThreadr Z
stdout_threadZdaemonÚstartr
r
Z
stderr_threadr ræ rŠ rì Zis_aliver r] r¼ )r rƒ rí rð r r
r r r rê sF
zPopen._communicatec C sl | j dk rdS |tjkr"| ¡ nF|tjkr>t | jtj¡ n*|tjkrZt | jtj¡ nt d
|¡ƒ‚dS )z Send a signal to the process.NzUnsupported signal: {}) r
r ÚSIGTERMÚ terminateZ CTRL_C_EVENTr¿ r} r° ZCTRL_BREAK_EVENTr rˆ )r Úsigr r r Ú send_signal; s
zPopen.send_signalc C sX | j dk rdS yt | jd¡ W n2 tk
rR t | j¡}|tjkrH‚ || _ Y nX dS )zTerminates the process.Nrm )r
rK ZTerminateProcessr ÚPermissionErrorr Z STILL_ACTIVE)r Zrcr r r r
I s
zPopen.terminatec
C s, d\}}d\}}d\}} |dkr"n@|t kr8t ¡ \}}n*|tkrJ| ¡ }nt|tƒrZ|}n| ¡ }|dkrln@|t kr‚t ¡ \}}n*|tkr”| ¡ }nt|tƒr¤|}n| ¡ }|dkr¶nf|t krÌt ¡ \}} nP|tkrî|dkrâ|} n
t j
¡ } n.|tkr| ¡ } nt|tƒr|} n| ¡ } |||||| fS )z|Construct and return tuple with IO objects:
p2cread, p2cwrite, c2pread, c2pwrite, errread, errwrite
)rU rU NrU ) r' r¿ Úpiper/ râ r« rG ró r( rQ Ú
__stdout__)
r r r r
rË rÌ rÍ rÎ rÏ rÐ r r r r² ^ sJ
c * s t |ttfƒr|g}nt|ƒ}|
rLttdƒr0dnd}|dg| }ˆ rLˆ |d< ˆ dkr\|d ‰ ˆ }t ¡ \}}g }x |dk r| |¡ t |¡}qrW x|D ]}t
|¡ q˜W zÖzî|dk rg }xL| ¡ D ]:\}}t |¡}d|krêt
d ƒ‚| |d t |¡ ¡ qÈW nd}t ˆ ¡‰ tj ˆ ¡r,ˆ f} n t‡ fd
d „t |¡D ƒƒ} t|ƒ} | |¡ t || |tttt| ƒƒƒ||| | |
||||||||¡| _d | _W dt
|¡ X t| d
dƒ} | dkrÞ| dkrÞ| | krÞt
| ¡ |dkr|
dkr|| krt
|¡ |dkr.|dkr.|| kr.t
|¡ | dk rBt
| ¡ d | _ t ƒ } x0t |d¡} | | 7 } | rxt | ƒdkrPP qPW W dt
|¡ X | r¾y6t | jd¡\}!}"|!| jkrÂ| !|"¡ ntj"| _#W n t$k
râ Y nX y | %dd¡\}#}$}%|% &¡ }%W n, t
k
r. d}#d}$d 't| ƒ¡}%Y nX tt(|# &d¡t)ƒ}&t*|&t+ƒr¶|$r¶t|$dƒ}'|%dk}(|(rvd}%|})n|})|'dkrªt ,|'¡}%|'t-j.krª|%dt/|)ƒ 7 }%|&|'|%|)ƒ‚|&|%ƒ‚dS )z Execute program (POSIX version)Zgetandroidapilevelz/system/bin/shz/bin/shz-cr Nrø ó =z!illegal environment variable namec 3 s" | ]}t j t |¡ˆ ¡V qd S )N)r¿ rþ rŠ Úfsencode)rù Údir)rÁ r r ú Ï s z'Popen._execute_child..Tr¦ rU iPà ó :r– s SubprocessErroró 0z#Bad exception data from child: {!r}Úasciié Znoexecr… z: )0r« rü Úbytesr# r¾ rQ r¿ r r\ Údupr¼ rq r r rþ ÚdirnameÚtupleÚ
get_exec_pathÚsetÚaddÚ_posixsubprocessZ fork_execÚsortedÚmaprG r° rÞ rr r¶ Ú bytearrayrè r— ÚwaitpidÚ_handle_exitstatusrR r
ÚChildProcessErrorÚsplitrÔ rˆ Úbuiltinsr Ú
issubclassr½ Ústrerrorrå ZENOENTÚrepr)*r r] rÁ r rà rÊ rÄ rÅ rÆ rÇ rœ rË rÌ rÍ rÎ rÏ rÐ rÈ rÉ Z
unix_shellZorig_executableZ errpipe_readZ
errpipe_writeZlow_fds_to_closeZlow_fdZenv_listÚkrb Zexecutable_listZ fds_to_keepZ
devnull_fdZ errpipe_dataÚpartr° rï Zexception_nameZ hex_errnoZerr_msgZchild_exception_typeZ errno_numZchild_exec_never_calledZ err_filenamer )rÁ r rº ” s¾
c C sL ||ƒr||ƒ | _ n2||ƒr*||ƒ| _ n ||ƒr@||ƒ | _ ntdƒ‚dS )z:All callers to this function MUST hold self._waitpid_lock.zUnknown child exit status!N)r
r )r rï Z _WIFSIGNALEDZ _WTERMSIGZ
_WIFEXITEDZ _WEXITSTATUSZ _WIFSTOPPEDZ _WSTOPSIGr r r r' # s zPopen._handle_exitstatusc
C s® | j dkr¨| j d¡sdS z€y8| j dk r.| j S || j|ƒ\}}|| jkrR| |¡ W nB tk
r– } z$|dk rv|| _ n|j|kr†d| _ W dd}~X Y nX W d| j ¡ X | j S )zõCheck 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 )r
r¨ Úacquirer° r' r½ rå Úrelease)r rN Z_waitpidZ_WNOHANGZ_ECHILDr° rï Úer r r rP 5 s
c C s> yt | j|¡\}}W n tk
r4 | j}d}Y nX ||fS )z:All callers to this function MUST hold self._waitpid_lock.r )r¿ r& r° r( )r Z
wait_flagsr° rï r r r Ú _try_waitX s
zPopen._try_waitc C s | j dk r| j S |dk r¶tƒ | }d}xà| j d¡rxz6| j dk rBP | tj¡\}}|| jkrh| |¡ P W d| j ¡ X |
|¡}|dkr–t | j |ƒ‚t
|d |dƒ}t |¡ q(W nRxP| j dkr| j4 | j dk rØP | d¡\}}|| jkrú| |¡ W dQ R X q¸W | j S )z+Internal implementation of wait() on POSIX.Ngü©ñÒMb@?Fr r– gš™™™™™©?)r
ré r¨ r0 r3 r¿ ÚWNOHANGr° r' r1 rì r r] rë ÚtimeZsleep)r r rí Zdelayr° rï Z remainingr r r rÙ e s8
c
C s, | j rX| jsXy| j ¡ W n tk
r. Y nX |sXy| j ¡ W n tk
rV Y nX d }d }| jsi | _| jr~g | j| j< | jrg | j| j< | jr¢| j| j }| jr´| j| j }| |¡ | j rÎt
| j ƒ}t ƒ Æ}| j rò|rò| | j t
j¡ | jr| jjs| | jt
j¡ | jr6| jjs6| | jt
j¡ x^| ¡ r–| |¡}|d k r~|dk r~| j||||dd tdƒ‚| |¡} | ||||¡ xø| D ]ð\}
} |
j| j kr<|| j| jt … } y | jt |
j| ¡7 _W n, tk
r | |
j¡ |
j ¡ Y n*X | jt | j ƒkrŒ| |
j¡ |
j ¡ nP|
j| j| jfkržt |
jd¡}
|
sz| |
j¡ |
j ¡ | j|
j |
¡ qžW q:W W d Q R X | j | |¡d |d k rÈd !|¡}|d k rÜd !|¡}| j"r$|d k r| #|| jj$| jj%¡}|d k r$| #|| jj$| jj%¡}||fS )Nr T)rñ zN_check_timeout(..., skip_check_and_raise=True) failed to raise TimeoutExpired.i € )r r† )&r rª Úflushrä r¼ Z_fileobj2outputr r
Ú _save_inputr© Ú
memoryviewÚ_PopenSelectorÚregisterÚ selectorsZ EVENT_WRITErD Z
EVENT_READZget_maprì rò Ú RuntimeErrorÚselectZfileobjÚ
_input_offsetÚ _PIPE_BUFr¿ rã rÒ Z
unregisterr— rè r\ r| rŠ r´ rÖ r r¡ )r rƒ rí rð r r
Z
input_viewZselectorr ZreadyÚkeyZeventsÚchunkrŸ r r r rê Ž s–
(
c C sF | j rB| jd krBd| _|| _|d k rB| jrB| j | j j| j j¡| _d S )Nr )r r© r> r´ Úencoder r¡ )r rƒ r r r r7 ô s zPopen._save_inputc C s | j dkrt | j|¡ dS )z Send a signal to the process.N)r
r¿ r} r° )r r r r r r s
c C s | tj¡ dS )z/Terminate the process with SIGTERM
N)r r r )r r r r r
s c C s | tj¡ dS )z*Kill the process with SIGKILL
N)r r ÚSIGKILL)r r r r r} s z
Popen.kill)rU NNNNNTFNNNNr TFr )NN)F)N)6r r r r rÞ r r r„ r rÖ r× rÜ rQ rR r r® rL râ ræ rŽ r rì rò r| r r² rô rû rº rK r Z
WAIT_OBJECT_0r rP rÙ r rê r r
r} r¿ Ú WIFSIGNALEDÚWTERMSIGÚ WIFEXITEDÚ WEXITSTATUSÚ
WIFSTOPPEDÚWSTOPSIGr' r& r4 rå ZECHILDr3 r7 r r r r r& y sl -
D
H
q46 "
)f )Er rQ Úplatformr r· r¿ r5 r r* r rå r ré Ú Exceptionr r r r§ r³ rK r r" r= r; rr r? r¾ r% r9 ZSelectSelectorÚ__all__r1 r2 r3 r4 r5 r6 r7 r8 r9 r: r; r< r= r> r? r@ rA rB rw rG rC rO rM r' r( r/ r^ r{ r) r* r- Úobjectr0 r. r› r+ r, r& r r r r Ú* sz
%
P
;/"DI