OwlCyberSecurity - MANAGER
Edit File: subprocess.cpython-310.pyc
o �?Og�K � @ sp d Z ddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddlm Z ddl Z zddlZW n eyE dZY nw g d�Zz ddlZddlZdZW n eym dZddlZddlZddlZY n0w ddlmZmZmZmZm 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) e�*g d�� G d d � d e+�Z,G d d � d e,�Z-G d d� de,�Z.er�G dd� d�Z/G dd� de0�Z1ne2edd�Z3e4ed�r�ej5Z6nej7Z6er�dZ8dd� Z9ng Z8dd� Z9dZ:dZ;dZ<d d � Z=d d � Z>dd �d!d"�Z?d#d$� Z@dd �d%d&�ZAG d'd(� d(eB�ZCddddd)�d*d+�ZDd,d-� ZEd.d/� ZFd0d1� ZGd2d3� ZHeH� ZIdZJG d4d5� d5�ZKdS )6a� 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)�Popen�PIPE�STDOUT�call� check_call�getstatusoutput� getoutput� check_output�run�CalledProcessError�DEVNULL�SubprocessError�TimeoutExpired�CompletedProcessTF)�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_JOB)r r r r r r r r � STARTUPINFOr r r r r r r r r! r" c @ s e Zd ZdS )r N)�__name__� __module__� __qualname__� r' r' �1/opt/alt/python310/lib64/python3.10/subprocess.pyr e s r c @ �< e Zd ZdZd dd�Zdd� Zedd� �Zejd d� �ZdS ) r z�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 � || _ || _|| _|| _d S �N)� returncode�cmd�output�stderr)�selfr, r- r. r/ r' r' r( �__init__o � zCalledProcessError.__init__c C s` | j r(| j dk r(z d| jt�| j �f W S ty' d| j| j f Y S w d| j| j f 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�r0 r' r' r( �__str__u s � ���zCalledProcessError.__str__c C � | j S )z+Alias for output attribute, to match stderr�r. r5 r' r' r( �stdout� s zCalledProcessError.stdoutc C � || _ d S r+ r8 �r0 �valuer' r' r( r9 � � �NN� r$ r% r& �__doc__r1 r6 �propertyr9 �setterr' r' r' r( r h s r c @ r) ) r z�This exception is raised when the timeout expires while waiting for a child process. Attributes: cmd, output, stdout, stderr, timeout Nc C r* r+ )r- �timeoutr. r/ )r0 r- rC r. r/ r' r' r( r1 � r2 zTimeoutExpired.__init__c C s d| j | jf S )Nz'Command '%s' timed out after %s seconds)r- rC r5 r' r' r( r6 � s �zTimeoutExpired.__str__c C r7 r+ r8 r5 r' r' r( r9 � s zTimeoutExpired.stdoutc C r: r+ r8 r; r' r' r( r9 � r= r> r? r' r' r' r( r � s r c @ s, e Zd Zddddddd�dd�Zdd� ZdS )r# r N��dwFlags� hStdInput� hStdOutput� hStdError� wShowWindow�lpAttributeListc C s0 || _ || _|| _|| _|| _|pdg i| _d S )N� handle_listrD )r0 rE rF rG rH rI rJ r' r' r( r1 � s zSTARTUPINFO.__init__c C s@ | j �� }d|v rt|d �|d< t| j| j| j| j| j|d�S )NrK rD ) rJ �copy�listr# rE rF rG rH rI )r0 Z attr_listr' r' r( rL � s �zSTARTUPINFO.copy)r$ r% r& r1 rL r' r' r' r( r# � s � r# c @ s2 e Zd ZdZejfdd�Zdd� Zdd� ZeZ dS ) �HandleFc C s | j s d| _ || � d S d S )NT)�closed)r0 � CloseHandler' r' r( �Close� s �z Handle.Closec C s | j s d| _ t| �S td��)NTzalready closed)rO �intr4 r5 r' r' r( �Detach� s z Handle.Detachc C s d| j jt| �f S )Nz%s(%d))� __class__r$ rR r5 r' r' r( �__repr__� s zHandle.__repr__N) r$ r% r& rO �_winapirP rQ rS rU �__del__r' r' r' r( rN � s rN ZPIPE_BUFi � PollSelectorc C s d S r+ r' r' r' r' r( �_cleanup� � rY c C sZ t d u rd S t d d � D ] } | jtjd�}|d ur*zt �| � W q ty) Y q w q d S )N�� _deadstate)�_active�_internal_poll�sys�maxsize�remover4 )�inst�resr' r' r( rY � 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)r_ �flags�optimize�append)�argsr< r' r' r( �"_optim_args_from_interpreter_flags s rm c C sN ddddddd�} t � }| �� D ]\}}ttj|�}|dkr'|�d || � qtjjr2|�d � ntjjr;|�d � tjjrD|�d � tj d d � }tjj }ttdi �}d|v }|dkrc|� d� n|rj|� d� |rq|� d� |D ] }|�d| � qs|r�|� d� dD ] }||v r�|| } | du r�|} nd|| f } |� d| f� q�|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 rg z-Iz-Ez-sN� _xoptions�dev� zerror::BytesWarningzdefault::BytesWarning�defaultz-W)�-Xr{ )Z faulthandler� tracemallocZ importtimeZ showrefcount�utf8Tz%s=%sr~ ) rm �items�getattrr_ ri rk �isolated�ignore_environment� no_user_site� warnoptionsrx ra �extend) Z flag_opt_maprl �flag�optrq Zwarnoptsrx Zxoptions�dev_moder< �argr' r' r( � _args_from_interpreter_flags sT � � �r� �rC c O sR t |i |���}z|j| d�W W d � S |�� � 1 s"w Y 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)rC � popenargs�kwargs�pr' r' r( r Q s ��r c O s: t | i |��}|r|�d�}|du r| 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"]) rl Nr )r �getr )r� r� �retcoder- r' r' r( r b s r c O sv d|v rt d��d|v r/|d du r/|�d�s&|�d�s&|�d�s&|�d�r)d }nd }||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. r9 z3stdout argument not allowed, it will be overridden.�inputN�universal_newlines�text�encoding�errors� � T)r9 rC �check)r4 r� r r r9 )rC r� r� �emptyr' r' r( r u s # ���r c @ s4 e Zd ZdZd dd�Zdd� Zeej�Z dd� Z dS ) 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 C r* r+ )rl r, r9 r/ )r0 rl r, r9 r/ r' r' r( r1 � r2 zCompletedProcess.__init__c C sh d� | j�d� | j�g}| jd ur|�d� | j�� | jd ur(|�d� | j�� d� t| �jd�|��S )Nz args={!r}zreturncode={!r}z stdout={!r}z stderr={!r}z{}({})z, ) �formatrl r, r9 rk r/ �typer$ �join)r0 rl r' r' r( rU � s � zCompletedProcess.__repr__c C s | j rt| j | j| j| j��dS )z6Raise CalledProcessError if the exit code is non-zero.N)r, r rl r9 r/ r5 r' r' r( �check_returncode� s ��z!CompletedProcess.check_returncoder> ) r$ r% r& r@ r1 rU � classmethod�types� GenericAlias�__class_getitem__r� r' r' r' r( r � s r )r� �capture_outputrC r� c O s$ | dur|� d�durtd��t|d< |r/|� d�dus#|� d�dur'td��t|d< t|d< t|i |���L}z |j| |d�\}}W n' tyb } z|�� trY|�� \| _| _ � |� � � d} ~ w |�� � |� � } |r{| r{t | |j ||d��W d � n1 s�w Y t|j | ||�S ) 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 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.r9 r/ z@stdout and stderr arguments may not be used with capture_output.r� �r. r/ )r� r4 r r � communicater r� � _mswindowsr9 r/ r� �pollr rl r ) r� r� rC r� r� r� Zprocessr9 r/ �excr� r' r' r( r � s> ���� �r c C s� g }d}t tj| �D ]d}g }|r|�d� d|v p d|v p | }|r'|�d� |D ]1}|dkr5|�|� q)|dkrL|�dt|� d � g }|�d� q)|rU|�|� g }|�|� q)|rb|�|� |rn|�|� |�d� q 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� )�map�os�fsdecoderk �lenr� r� )�seq�resultZ needquoter� Zbs_buf�cr' r' r( � list2cmdline s6 � r� c C sn z t | ddtd�}d}W n ty$ } z |j}|j}W Y d}~nd}~ww |dd� dkr3|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)�shellr� r/ r Nrd � )r r r r. r, )r- �dataZexitcodeZexr' r' r( r \ s �� r 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' r| )r )r- r' r' r( r { s r c C s� t sttd�s dS tjdv rdS z<t�d�} | jdd�}t|�dkr$t�|d }t t t |d �d ���}tjd krD|d krG|d krJW dS W dS W dS W dS t tt fyY Y dS 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)�darwinZsunos5T�CS_GNU_LIBC_VERSIONr| )�maxsplitr� r �.ZlinuxZglibc)r� � )r� �hasattrr� r_ �platform�confstr�splitr� r4 �tupler� rR �AttributeError�OSError)Zver�partsZlibc�versionr' r' r( �_use_posix_spawn� s. � � � ��r� c @ s� e Zd ZdZdZ dMddddddddd�d d �Zd d � Zeej �Z e d d� �Z e j dd� �Z dd� Zdd� Zdd� Zejejfdd�Zdd� Zdd� ZdNd d �Zd d � Zd d!� Z dOd"d#�ZdPd$d%�Z d&d'� Z e r�d(d)� Z d*d+� Z d,d-� Z!d.d/� Z"de#j$e#j%e#j&fd0d1�Z'd2d3� Z(d4d5� Z)d6d7� Z*d8d9� Z+d:d;� Z,e,Z-dS d<d)� Z d=d>� Z.d?d/� Z"e/j0e/j1e/j2fd@dA�Z3de/j4e/j5e6j7fdBd1�Z'dCdD� Z8dEd3� Z(dFd7� Z*dGdH� Z9dId9� Z+dJd;� Z,dKdL� Z-dS )Qr aP 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) 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 Frd NTr r' )�user�group� extra_groupsr� r� r� �umask�pipesizec + C s� t � t�� | _d| _d| _|du rd}t|t�s td��|du r#d}t|t�s,td��t r7|dur6t d��n |rC|sCt � dt � d}| durKt d ��|d krSt d ��|| _d| _d| _d| _d| _d| _|| _|| _|| _|dur�| dur�t| �t|�kr�td ��| �|||�\}}} } } } t r�|dkr�t�|� � d �}| dkr�t�| � � d �} | dkr�t�| � � d �} |p�|p�|p�| | _ | j r�|du r�d | _}d| _ d| _ | j r�|dkr�d} d}nd} d}!|du�r,t t!d�s�t d��t|t"��rzd dl#}"W n t$�y t d��w |"�%|�j&}!nt|t��r|}!n td�'t(|����|!d k �r,t d|!� ���d}#|du�r�t t!d��s=t d��t|t"��rGt d��g }#|D ];}$t|$t"��rqzd dl#}"W n t$�ye t d��w |#�)|"�%|$�j&� �qKt|$t��r~|#�)|$� �qKtd�'t(|$����|#D ]}%|%d k �r�t d|%� ����q�d}&|du�r�t t!d��s�t d��t|t"��r�zd dl*}'W n t$�y� t d ��w |'�+|�j,}&n t|t��r�|}&ntd ��|&d k �r�t d |&� ���zp|dk�rt-�.|d |�| _| j �rt-j/| jd| ||d �| _| dk�r t-�.| d!|�| _| j �r t-j/| j||d"�| _| dk�r7t-�.| d!|�| _| j �r7t-j/| j||d"�| _| �0|||||| | | || ||| | | | ||!|#|&||� W dS t1d| j| j| jf�D ]}(z|(�2� W �qb t3�yv Y �qbw | j �s�g })|t4k�r�|)�)|� |t4k�r�|)�)| � |t4k�r�|)�)| � t | d#��r�|)�)| j5� |)D ]#}*zt �r�t|*t6��r�|*�7� nt!�2|*� W �q� t3�y� Y �q�w � )$zCreate new Popen instance.NFrd 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.�localeg �?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_through�line_bufferingr� r� �rb)r� r� �_devnull)8rY � threadingZLock� _waitpid_lock�_input�_communication_started� isinstancerR � TypeErrorr� r4 �warnings�warn�RuntimeWarningrl r� r9 r/ �pidr, r� r� r� �boolr � _get_handles�msvcrtZopen_osfhandlerS � text_mode�_sigint_wait_secs�_closed_child_pipe_fdsr� r� �str�grp� ImportErrorZgetgrnamZgr_gidr� r� rk �pwd�getpwnamZpw_uid�io�open� TextIOWrapper�_execute_child�filter�closer� r r� rN rQ )+r0 rl �bufsize� executabler� r9 r/ � preexec_fn� close_fdsr� �cwd�envr� � startupinfo� creationflags�restore_signals�start_new_session�pass_fdsr� r� r� r� r� r� r� r� �p2cread�p2cwrite�c2pread�c2pwrite�errread�errwriter� �gidr� �gidsZ extra_groupZ gid_check�uidr� �fZto_close�fdr' r' r( r1 � sV � � � � � � � � � � � � � ��zPopen.__init__c C s@ d| j j� d| j� d| j�d�}t|�dkr |d d� d }|S )N�<z: returncode: z args: �>�P �L z...>)rT r$ r, rl r� )r0 Zobj_reprr' r' r( rU � s ��� zPopen.__repr__c C r7 r+ )r� r5 r' r' r( r� � s zPopen.universal_newlinesc C s t |�| _d S r+ )r� r� )r0 r� r' r' r( r� s c C s |� ||�}|�dd��dd�S )Nz r� � )�decode�replace)r0 r� r� r� r' r' r( �_translate_newlines s zPopen._translate_newlinesc C s | S r+ r' r5 r' r' r( � __enter__ rZ zPopen.__enter__c C s� | j r| j �� | jr| j�� z0| jr| j�� W |tkr;| jdkr6z | j| jd� W n ty5 Y nw d| _d S | �� d S |tkrf| jdkr]z | j| jd� W n ty\ Y nw d| _ Y d S | �� w )Nr r� ) r9 r� r/ r� �KeyboardInterruptr� �_waitr r� )r0 �exc_typer< � tracebackr' r' r( �__exit__ s8 � � � � zPopen.__exit__c C s\ | j sd S | jd u r|d| j t| d� | j|d� | jd u r*td ur,t�| � d S d S d S )Nz subprocess %s is still running)�sourcer[ )�_child_createdr, r� �ResourceWarningr^ r] rk )r0 Z_maxsizeZ_warnr' r' r( rW ) s � �z Popen.__del__c C s" t | d�st�tjtj�| _| jS )Nr� )r� r� r� �devnull�O_RDWRr� r5 r' r' r( � _get_devnull8 s zPopen._get_devnullc C s� |r-z| j �|� W n" ty Y n ty, } z|jtjkr!n� W Y d }~nd }~ww z| j �� W d S ty? Y d S tyY } z|jtjkrMn� W Y d }~d S d }~ww r+ )r� �write�BrokenPipeErrorr� �errnoZEINVALr� )r0 r� r� r' r' r( � _stdin_write= s. ��� ���zPopen._stdin_writec C sR | j r |r td��|du rM| j sM| j| j| jg�d�dkrMd}d}| jr*| �|� n| jr8| j�� }| j�� n | jrE| j�� }| j�� | � � ||fS |durWt � | }nd}z>z | � |||�\}}W n- t y� |durzt | j| �|��}n| j}d| _z| j|d� W � ty� Y � w w W d| _ nd| _ w | 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� r4 r� r9 r/ �countr# �readr� r� �_time� _communicater �minr� �_remaining_timer r )r0 r� rC r9 r/ �endtime�sigint_timeout�stsr' r' r( r� V sP � � ����zPopen.communicatec C s | � � S )zSCheck if child process has terminated. Set and return returncode attribute.)r^ r5 r' r' r( r� � s z Popen.pollc C s |du rdS |t � S )z5Convenience for _communicate when computing timeouts.N)r& )r0 r* r' r' r( r) � s zPopen._remaining_timec C sP |du rdS |s t � |kr&t| j||rd�|�nd|r"d�|�d��dd��dS )z2Convenience for checking if a timeout has expired.Nr� r� )r& r rl r� )r0 r* � orig_timeoutZ stdout_seqZ stderr_seq�skip_check_and_raiser' r' r( �_check_timeout� s ���zPopen._check_timeoutc C s| |dur t � | }z| j|d�W S ty= |dur%t| j| �|��}n| j}d| _z| j|d� W � ty< Y � w w )z=Wait for child process to terminate; returns self.returncode.Nr� r )r& r r r( r� r) r )r0 rC r* r+ r' r' r( r� � s& � ���z Popen.waitc C s t | dd �}t�� �m}tr,|dkr|�|j� |dkr!|�|j� |dkr+|�|j� n9|dkr?|dkr?||kr?|�tj|� |dkrR|dkrR||krR|�tj|� |dkre|dkre||kre|�tj|� |d urp|�tj|� W d � n1 szw Y d| _d S )Nr� rd T) r� � contextlib� ExitStackr� �callbackrQ r� r� r� ) r0 r r r r r r Z devnull_fd�stackr' r' r( �_close_pipe_fds� s* �� � zPopen._close_pipe_fdsc C sp |du r|du r|du rdS d\}}d\}}d\}} |du r:t �t j�}|du r9t �dd�\}} t|�}t �| � n4|tkrPt �dd�\}}t|�t|�}}n |tkr\t� | � � �}nt |t �rgt� |�}nt� |� � �}| �|�}|du r�t �t j�}|du r�t �dd�\} }t|�}t �| � n4|tkr�t �dd�\}}t|�t|�}}n |tkr�t� | � � �}nt |t �r�t� |�}nt� |� � �}| �|�}|du r�t �t j�} | du r�t �dd�\} } t| �} t �| � n?|tk�rt �dd�\}} t|�t| �}} n(|tk�r |} n |tk�rt� | � � �} nt |t ��r$t� |�} nt� |� � �} | �| �} |||||| fS )�|Construct and return tuple with IO objects: p2cread, p2cwrite, c2pread, c2pwrite, errread, errwrite N)rd rd rd rd rd rd �rd rd r )rV Z GetStdHandler Z CreatePiperN rP r r r� Z get_osfhandler r� rR �fileno�_make_inheritabler r r ) r0 r� r9 r/ r r r r r r �_r' r' r( r� � sv � � � �zPopen._get_handlesc C s& t �t �� |t �� ddt j�}t|�S )z2Return a duplicate of handle, which is inheritabler r| )rV ZDuplicateHandleZGetCurrentProcessZDUPLICATE_SAME_ACCESSrN )r0 �handle�hr' r' r( r8 4 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 kst �|�t jkr|�qS )� )rV Z GetFileTypeZFILE_TYPE_CHAR)�.0r: r' r' r( � <setcomp>D s ��z,Popen._filter_handle_list.<locals>.<setcomp>)rM )r0 rK r' r' r( �_filter_handle_list= s zPopen._filter_handle_listc ! C s� |rJ d��t |t�r n't |t�r | rtd��t|g�}nt |tj�r/| r)td��t|g�}nt|�}|dur<t�|�}|du rDt� }n|� � }d| ||fv}|rb| j t j O _ | |_ ||_||_|j}t|ood|v oo|d �}|sw|r�|r�|du r�i }|_t|�dg �� }|d< |r�|t| �t|�t|�g7 }| �|�|dd�< |r�|s�t�dt� d}| r�| j t jO _ t j|_|s�tj �d �}|s�tj �d d �} tj � | d d �}tj � |�s�t d��tj � |�r�|}n|}d�!||�}|dur�t�|�}t"�#d||||� z t �$||ddt| �| |||� \} } } } W | �%| | | |||� n | �%| | | |||� w d| _&t'| �| _(| | _)t �*| � dS )z$Execute program (MS Windows version)z"pass_fds not supported on Windows.z$bytes args is not allowed on Windows�0path-like args is not allowed when shell is trueNrd rK z?startupinfo.lpAttributeList['handle_list'] overriding close_fdsFZComSpecZ SystemRootr� ZSystem32zcmd.exez:shell not found: neither %ComSpec% nor %SystemRoot% is setz {} /c "{}"�subprocess.PopenT)+r� r� �bytesr� r� r� �PathLiker� r# rL rE rV r rF rG rH rJ r� rM r� rR r? r� r� r� r r rI �environ�pathr� �isabs�FileNotFoundErrorr� r_ �auditZ CreateProcessr4 r rN �_handler� rP )!r0 rl r� r� r� r r� r� r� r� r� r r r r r r Zunused_restore_signalsZ unused_gidZ unused_gidsZ unused_uidZ unused_umaskZunused_start_new_sessionZuse_std_handlesZattribute_listZhave_handle_listrK ZcomspecZ system_rootZhpZhtr� �tidr' r' r( r� J s� �� �� � ��� zPopen._execute_childc C s, | j du r|| 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, rI )r0 r\ Z_WaitForSingleObjectZ_WAIT_OBJECT_0Z_GetExitCodeProcessr' r' r( r^ � s zPopen._internal_pollc C s^ |du rt j}nt|d �}| jdu r,t �| j|�}|t jkr%t| j|��t � | j�| _| jS )z-Internal implementation of wait() on Windows.Ni� ) rV ZINFINITErR r, �WaitForSingleObjectrI Z WAIT_TIMEOUTr rl �GetExitCodeProcess)r0 rC Ztimeout_millisr� r' r' r( r � s � z Popen._waitc C s |� |�� � |�� d S r+ )rk r% r� )r0 Zfh�bufferr' r' r( � _readerthread� s zPopen._readerthreadc C sT | j r!t| d�s!g | _tj| j| j | jfd�| _d| j_| j�� | j rBt| d�sBg | _ tj| j| j | j fd�| _ d| j _| j �� | j rJ| � |� | j d urc| j�| �|�� | j�� rct| j|��| j d ur|| j �| �|�� | j �� r|t| j|��d }d }| j r�| j}| j �� | j r�| j }| j �� |r�|d nd }|r�|d nd }||fS )N� _stdout_buff)�targetrl T� _stderr_buffr )r9 r� rO r� ZThreadrN Z stdout_threadZdaemon�startr/ rQ Z stderr_threadr� r# r� r) Zis_aliver rl r� )r0 r� r* r- r9 r/ r' r' r( r' � sJ �� �� zPopen._communicatec C sn | j durdS |tjkr| �� dS |tjkr!t�| jtj� dS |tjkr0t�| jtj� dS t d� |���)� Send a signal to the process.NzUnsupported signal: {}) r, r3 �SIGTERM� terminateZ CTRL_C_EVENTr� r� r� ZCTRL_BREAK_EVENTr4 r� �r0 Zsigr' r' r( � send_signal! s zPopen.send_signalc C sV | j durdS z t�| jd� W dS ty* t�| j�}|tjkr$� || _ Y dS w )zTerminates the process.Nr| )r, rV ZTerminateProcessrI �PermissionErrorrL Z STILL_ACTIVE)r0 Zrcr' r' r( rU / s �zPopen.terminatec C s� d\}}d\}}d\}} |du rn3|t kr/t�� \}}| jdkr.ttd�r.t�|tj| j� n|tkr8| �� }n t |t �r@|}n|� � }|du rIn3|t krgt�� \}}| jdkrfttd�rft�|tj| j� n|tkrp| �� }n t |t �rx|}n|� � }|du r�nD|t kr�t�� \}} | jdkr�ttd�r�t�| tj| j� n&|t kr�|dkr�|} nt j� � } n|tkr�| �� } n t |t �r�|} n|� � } |||||| fS )r5 r6 Nr � F_SETPIPE_SZrd )r r� �piper� r� �fcntlrY r r r� rR r7 r r_ � __stdout__) r0 r� r9 r/ r r r r r r r' r' r( r� D s^ � � � �c C s� |du rt j}i } |r%g } dD ]} tt| d�}|dur | �|� q| | d< g }||| fD ]}|dkr:|�t j|f� q,|df|df| dffD ]\}}|dkrW|�t j||f� qF|r^|| d< t j|||fi | ��| _d | _ | � ||||| | � dS ) z'Execute program using os.posix_spawn().N)�SIGPIPEZSIGXFZ�SIGXFSZZ setsigdefrd r r| r� � file_actionsT) r� rD r� r3 rk �POSIX_SPAWN_CLOSE�POSIX_SPAWN_DUP2r� r� r r4 )r0 rl r� r� r� r r r r r r r� ZsigsetZsignameZsignumr_ r Zfd2r' r' r( � _posix_spawn� s> �� ���zPopen._posix_spawnc - s� t |ttf�r |g}nt |tj�r| rtd��|g}nt|�}| r6ttd�r(dnd}|dg| }� r6� |d< � du r>|d � t� d� |||� t r�tj � � �r�|du r�|s�|s�|du r�| d ksc| d kr�|d ksk|d kr�|d kss|d kr�|s�|du r�|du r�|du r�|dk r�| � |� ||| | | |||� dS � }t�� \}}g }|d k r�|�|� t�|�}|d k s�|D ]} t�| � q�z�z||dur�g } |�� D ] \} } t�| �} d | v r�td ��| �| d t�| � � q�nd} t�� �� tj � � �r�� f} nt� fdd�t�|�D ��} t|�}!|!�|� t�|| |ttt t |!���|| | | | ||||||||||||�| _ d| _ W t�|� nt�|� w | � | | | |||� t!� }" t�"|d�}#|"|#7 }"|#�rat#|"�dk�rbn�qMW t�|� nt�|� w |"�r�zt�$| j d�\}$}%|$| j k�r�| �%|%� ntj&| _'W n t(�y� Y nw z|"�)dd �\}&}'}(|(�*� }(W n t�y� d}&d}'d�+t|"��}(Y nw t,t-|&�*d�t.�})t/|)t0��r�|'�r�t |'d�}*|(dk}+|+�r�d}(|},n|},|*dk�r�t�1|*�}(|)|*|(|,��|)|(��dS )z Execute program (POSIX version)r@ Zgetandroidapilevelz/system/bin/shz/bin/shz-cr NrA rd r� r< � =z!illegal environment variable namec 3 s$ � | ] }t j�t �|�� �V qd S r+ )r� rE r� �fsencode)r= �dir�r� r' r( � <genexpr>� s � � �z'Popen._execute_child.<locals>.<genexpr>TiP� � :s SubprocessError� 0z#Bad exception data from child: {!r}�ascii� Znoexecr� )2r� r� rB r� rC r� rM r� r_ rH �_USE_POSIX_SPAWNrE �dirnamerb rZ rk �dupr� r� rd r4 r� � get_exec_path�set�add�_posixsubprocessZ fork_exec�sortedr� rR r� r r4 � bytearrayr% r� �waitpid�_handle_exitstatusr` r, �ChildProcessErrorr� r r� r� �builtinsr � issubclassr� �strerror)-r0 rl r� r� 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�krq Zexecutable_listZ fds_to_keepZ errpipe_data�partr� r, Zexception_nameZ hex_errno�err_msgZchild_exception_typeZ errno_numZchild_exec_never_calledZ err_filenamer' rf r( r� � s �� ���� � � � � � � � �� � �� � �c C s& ||�r ||� | _ dS ||�| _ dS )�:All callers to this function MUST hold self._waitpid_lock.N)r, )r0 r, �waitstatus_to_exitcodeZ _WIFSTOPPEDZ _WSTOPSIGr' r' r( rv K s zPopen._handle_exitstatusc C s� | j du rl| j�d�s dS zXz#| j dur | j W W | j�� S || j|�\}}|| jkr0| �|� W n" tyS } z|durA|| _ n|j|krId| _ W Y d}~nd}~ww W | j�� | j S W | j�� | j S | j�� w | 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� �acquire�releaser� rv r� r" )r0 r\ Z_waitpidZ_WNOHANGZ_ECHILDr� r, �er' r' r( r^ W s4 � � ��� � � �c C s@ zt �| j|�\}}W ||fS ty | j}d}Y ||fS w )r~ r )r� ru r� rw )r0 Z wait_flagsr� r, r' r' r( � _try_waitz s ��zPopen._try_waitc C sr | j dur| j S |duryt� | }d} | j�d�r\z;| j dur)W | j�� | j S | �tj�\}}|| jks<|dks<J �|| jkrO| � |� W | j�� | j S W | j�� n| j�� w | � |�}|dkrkt | j |��t |d |d�}t�|� q| j du r�| j�( | j dur� W d � | j S | �d�\}}|| jkr�| � |� W d � n1 s�w Y | j du s~| j S )z+Internal implementation of wait() on POSIX.Ng����Mb@?TFr r� g�������?)r, r& r� r� r� r� r� �WNOHANGr� rv r) r rl r( �time�sleep)r0 rC r* Zdelayr� r, Z remainingr' r' r( r � sP � � � � � � � � c C s$ | j r*| js*z| j �� W n ty Y nw |s*z| j �� W n ty) Y nw d }d }| jsFi | _| jr=g | j| j< | jrFg | j| j< | jrO| j| j }| jrX| j| j }| �|� | j ret | j �}t � ��}| j rv|rv|� | j t j� | jr�| jjs�|� | jt j� | jr�| jjs�|� | jt j� |�� �r=| �|�}|d ur�|dk r�| j||||dd� td��|�|�} | �||||� | D ]u\} } | j| j u �r|| j| jt � } z| jt�| j| �7 _W n ty� |� | j� | j�� Y q�w | jt | j �k�r|� | j� | j�� q�| j| j| jfv �r8t� | jd�} | �s/|� | j� | j�� | j| j � | � q�|�� s�W d � n 1 �sHw Y | j | �|�d� |d u�r`d�!|�}|d u�rjd�!|�}| j"�r�|d u�r~| �#|| jj$| jj%�}|d u�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_fileobj2outputr9 r/ � _save_inputr� � memoryview�_PopenSelector�register� selectorsZ EVENT_WRITErO Z EVENT_READZget_mapr) r/ � RuntimeError�selectZfileobj� _input_offset� _PIPE_BUFr� r r � unregisterr� r% rk r� r� r� r r� r� )r0 r� r* r- r9 r/ Z input_viewZselectorrC Zready�keyZevents�chunkr� r' r' r( r' � s� � � �� � � � ��� �, � �c C sV | j r#| jd u r%d| _|| _|d ur'| jr)| j�| j j| j j�| _d S d S d S d S d S )Nr )r� r� r� r� �encoder� r� )r0 r� r' r' r( r� s ��zPopen._save_inputc C s@ | � � | jdur dS z t�| j|� W dS ty Y dS w )rS N)r� r, r� r� r� �ProcessLookupErrorrV r' r' r( rW " s �c C � | � tj� dS )z/Terminate the process with SIGTERM N)rW r3 rT r5 r' r' r( rU B � c C r� )z*Kill the process with SIGKILL N)rW r3 �SIGKILLr5 r' r' r( r� G r� z Popen.kill)rd NNNNNTFNNNNr TFr' r> )Fr+ ):r$ r% r& r@ r r1 rU r� r� r� r� rA r� rB r r r r_ r` r� r� rW r r# r� r� r) r/ r� r4 r� r� r8 r? r� rV rK Z WAIT_OBJECT_0rL r^ r rN r' rW rU r� rb r� r � WIFSTOPPED�WSTOPSIGrv ru r� r" ZECHILDr� r� r' r' r' r( r � s� 5� � | D � H �2<' & � �# )f r )Lr@ rx r" r� r� r� r3 r_ r� r� r0 r r& r� r[ r� �__all__r� rV r� �ModuleNotFoundErrorrr r� r� r r r r r r r r r r r r r r r r r! r" r� � Exceptionr r r r# rR rN r� r� r� rX r� ZSelectSelectorr] rY r r r rm r� r r r �objectr r r� r r r� rl Z _USE_VFORKr r' r' r' r( �<module> s� " � �P % ;4% �FI 2