^j$ dZddlZddlZddlZddlZddlmZmZmZm Z ddl m Z edZ ddl mZdeededzfd Zej"fd e eeefd e ej&ege fd ede dzfd Zd eeezdefdZd eeezdeeeffdZd eeezdeeeedzffdZddedededeefdZ ddededeeeeffdZy)zCommon utilities for the various process_* implementations. This file is only meant to be imported by the platform-specific implementations of subprocess utilities, and it contains tools that are common to all of them. N)IOListTypeVarUnion)Callable_T) py3compatstreamreturncddl} |jS#t$r$}|j|jk7rYd}~yd}~wwxYw)zRead from a pipe ignoring EINTR errors. This is necessary because when reading from pipes with GUI event loops running in the background, often interrupts are raised that stop the command from completing.rN)errnoreadIOErrorEINTR)r r errs V/opt/ringagent/.cad-venv/lib/python3.12/site-packages/IPython/utils/_process_common.pyread_no_interruptr sC {{}  99 #  $ s A>Acmdcallbackstderrc Rtjjtjjtjdk(r|t j k7rd}nd}t|t}d}|r8tjdk(r%dtjvrtjd}t j|||t j t j ||} ||}|j! |j!|j#|j |j'|S|S#t$rLtdtjjtjjd}YwxYw#t$$rYwxYw#t$$rY|SwxYw#|j1 |j!|j#n#t$$rYnwxYw|j! |j'w#t$$rYwwxYwwxYw) aOpen a command in a shell subprocess and execute a callback. This function provides common scaffolding for creating subprocess.Popen() calls. It creates a Popen object and then calls the callback with it. Parameters ---------- cmd : str or list A command to be executed by the system, using :class:`subprocess.Popen`. If a string is passed, it will be run in the system shell. If a list is passed, it will be used directly as arguments. callback : callable A one-argument function that will be called with the Popen object. stderr : file descriptor number, optional By default this is set to ``subprocess.PIPE``, but you can also pass the value ``subprocess.STDOUT`` to force the subprocess' stderr to go into the same file descriptor as its stdout. This is useful to read stdout and stderr combined in the order they are generated. Returns ------- The return value of the provided callback is returned. win32FTNposixSHELL)shell executablestdinstdoutr close_fdsz^C)sysrflushrplatform subprocessPIPE isinstancestrosnameenvironPopenKeyboardInterruptprint returncode terminatepollOSErrorkill)rrrrrrpouts rprocess_handlerr40s8JJJJ ||w6Z__#<  sC EJ G#2::(=ZZ( E$.) * &#,  .Aqk <<    <<   J3J/  d         J  <<      <<     s-E F/F*AFF:FF: F'&F'* F76F7: H& G)(H&) G52H&4G55H&HH& H"H&!H""H&cjt|dtj}|ytj|S)aRun a command and return its stdout/stderr as a string. Parameters ---------- cmd : str or list A command to be executed in the system shell. Returns ------- output : str A string containing the combination of stdout and stderr from the subprocess, in whatever order the subprocess originally wrote to its file descriptors (so the order of the information in this string is the correct order as would be seen if running the command in a terminal). c(|jdS)Nr communicater2s rzgetoutput..s);)r4r#STDOUTr decode)rr3s r getoutputr?|s2 #;Z=N=N OC {   C  r;ct|ddS)a Return (standard output, standard error) of executing cmd in a shell. Accepts the same arguments as os.system(). Parameters ---------- cmd : str or list A command to be executed in the system shell. Returns ------- stdout : str stderr : str N)get_output_error_code)rs rgetoutputerrorrCs ! %bq ))r;ct|d}|y|\\}}}tj|tj||jfS)aEReturn (standard output, standard error, return code) of executing cmd in a shell. Accepts the same arguments as os.system(). Parameters ---------- cmd : str or list A command to be executed in the system shell. Returns ------- stdout : str stderr : str returncode: int c&|j|fS)Nr7r9s rr:z'get_output_error_code..sQ]]_a,@r;)r<r<N)r4r r>r-)rresultr3rr2s rrBrBsM$S"@ AF ~MJS#   C )"2"23"7 EEr; commandlinerstrictctj||}d|_d|_g} |jt |#t $rY|St $r"|r|j|jY|SwxYw)aSplit a command line's arguments in a shell-like manner. This is a modified version of the standard library's shlex.split() function, but with a default of posix=False for splitting, so that quotes in inputs are respected. if strict=False, then any errors shlex.split would raise will result in the unparsed remainder being the last element of the list, rather than raising. This is because we sometimes use arg_split to parse things other than command-line args. rTr<shlexwhitespace_split commentersappendnext StopIteration ValueErrortoken)rGrrHlextokenss r arg_splitrVs ++k /CCCN F   MM$s) $    M  MM#)) $  M sA A;&A;:A;c$dtdtdttffd }||d}||d}t|t|k7r|Dcgc]}|dfc}St ||Dcgc]\}}|d|vxsd |vfc}}Scc}wcc}}w) aSplit a command line and report which tokens were originally quoted. Returns a list of ``(token, was_quoted)`` pairs. ``token`` is the unquoted form, as ``shlex.split(posix=True)`` returns, and ``was_quoted`` is True if that token had any single- or double-quote characters in ``commandline``. Useful for callers like ``%run`` that want to honor shell quoting when deciding wether to apply further expansion (glob, tilde) to a token. Detection is shlex-based on both passes so the quote semantics are the same on Posix and Windows. If ``strict`` is False, malformed input (e.g. an unbalanced quote) returns whatever was parsed so far instead of raising. srr ctj||}d|_d|_g} |jt |#t $rY|St $r"r|j|jY|SwxYw)NrJTr<rK)rXrrTr3rHs r _tokenizez(arg_split_with_quotes.._tokenizeskk!5)#  49%!     399%  sA A<&A<;A<FrJT'")r&boollistlenzip)rGrHrZ raw_tokens clean_tokenstcleanraws ` rarg_split_with_quotesrfs S$s)";e4J[5L :#l++%11qE 11lJ7  E3 ,- 2 s  B-B )FT)T)__doc__r'rLr#r typingrrrrcollections.abcrr IPython.utilsr bytesrr$r&r*intr4r^r?tuplerCrBr]rVrfr;rrosl   ++$ T]# bi EDL &//I sDI~ I ((/0"45I I$Y IX!3c?!s!,*d3i*E#s(O*$FsT#YF5c3:9M3NF0#3#t#T#TRUY#N&*,,", %T ,r;