class Run(object): """Class to handle processes. :ivar cmds: The ``cmds`` argument passed to the __init__ method (a command line passed in a list, or a list of command lines passed as a list of list). :ivar status: The exit status. As the exit status is only meaningful after the process has exited, its initial value is None. When a problem running the command is detected and a process does not get created, its value gets set to the special value 127. :ivar out: process standard output (if instanciated with output = PIPE) :ivar err: same as out but for standard error :ivar pid: PID. Set to -1 if the command failed to run. """ def __init__(self, cmds, cwd=None, output=PIPE, error=STDOUT, input=None, bg=False, timeout=None, env=None, set_sigpipe=True, parse_shebang=False, ignore_environ=True): """Spawn a process. :param cmds: two possibilities: 1) a command line: a tool name and its arguments, passed in a list. e.g. ['ls', '-a', '.'] 2) a list of command lines (as defined in (1)): the different commands will be piped. This means that [['ps', '-a'], ['grep', 'vxsim']] will be equivalent to the system command line 'ps -a | grep vxsim'. :type cmds: list[str] | list[list[str]] :param cwd: directory in which the process should be executed (string or None). If None then current directory is used :type cwd: str | None :param output: can be PIPE (default), a filename string, a fd on an already opened file, a python file object or None (for stdout). :type output: int | str | file | None :param error: same as output or STDOUT, which indicates that the stderr data from the applications should be captured into the same file handle as for stdout. :type error: int | str | file | None :param input: same as output :type input: int | str | file | None :param bg: if True then run in background :type bg: bool :param timeout: limit execution time (in seconds), None means unlimited :type timeout: int | None :param env: dictionary for environment variables (e.g. os.environ) :type env: dict :param set_sigpipe: reset SIGPIPE handler to default value :type set_sigpipe: bool :param parse_shebang: take the #! interpreter line into account :type parse_shebang: bool :param ignore_environ: Applies only when env parameter is not None. When set to True (the default), the only environment variables passed to the program are the ones provided by the env parameter. Otherwise, the environment passed to the program consists of the environment variables currently defined (os.environ) augmented by the ones provided in env. :type ignore_environ: bool :raise OSError: when trying to execute a non-existent file. If you specify a filename for output or stderr then file content is reseted (equiv. to > in shell). If you prepend the filename with '+' then the file will be opened in append mode (equiv. to >> in shell) If you prepend the input with '|', then the content of input string will be used for process stdin. """ def add_interpreter_command(cmd_line): """Add the interpreter defined in the #! line to cmd_line. If the #! line cannot be parsed, just return the cmd_line unchanged On windows, /usr/bin/env will be ignored to avoid a dependency on cygwin and /bin/bash & /bin/sh are replaced by $SHELL if defined. :param cmd_line: command line :type cmd_line: list[str] """ if not parse_shebang: # nothing to do return cmd_line prog = which(cmd_line[0], default=None) if prog is None: # Not found. Do not modify the command line return cmd_line with open(prog) as f: try: header = f.read()[0:2] except UnicodeDecodeError: # py3-only # unknown header - cannot decode the first two bytes return cmd_line if header != "#!": # Unknown header return cmd_line # Header found, get the interpreter command in the first line f.seek(0) line = f.readline() interpreter_cmds = [ l.strip() for l in line[line.find('!') + 1:].split() ] # Pass the program path to the interpreter if len(cmd_line) > 1: cmd_line = [prog] + list(cmd_line[1:]) else: cmd_line = [prog] if sys.platform == 'win32': # unix: no cover if interpreter_cmds[0] == '/usr/bin/env': return interpreter_cmds[1:] + cmd_line elif interpreter_cmds[0] in ('/bin/bash', '/bin/sh') and \ 'SHELL' in os.environ: return [os.environ['SHELL']] + cmd_line return interpreter_cmds + cmd_line # First resolve output, error and input self.input_file = File(input, 'r') self.output_file = File(output, 'w') self.error_file = File(error, 'w') self.status = None self.out = '' self.err = '' self.cmds = [] if env is not None and not ignore_environ: # ignore_environ is False, so get a copy of the current # environment and update it with the env dictionnary. tmp = os.environ.copy() tmp.update(env) env = tmp rlimit_args = [] if timeout is not None: rlimit = get_rlimit() if os.path.exists(rlimit): rlimit_args = [rlimit, '%d' % timeout] else: logger.warning('cannot find rlimit at %s', rlimit) rlimit_args = [] try: if isinstance(cmds[0], basestring): self.cmds = rlimit_args + list(add_interpreter_command(cmds)) else: self.cmds = [add_interpreter_command(c) for c in cmds] self.cmds[0] = rlimit_args + list(self.cmds[0]) cmdlogger.debug('Run: cd %s; %s', cwd if cwd is not None else os.getcwd(), self.command_line_image()) if isinstance(cmds[0], basestring): popen_args = { 'stdin': self.input_file.fd, 'stdout': self.output_file.fd, 'stderr': self.error_file.fd, 'cwd': cwd, 'env': env, 'universal_newlines': True } if sys.platform != 'win32' and \ set_sigpipe: # windows: no cover # preexec_fn is no supported on windows popen_args['preexec_fn'] = subprocess_setup if WIN_NEW_PG and sys.platform == 'win32': popen_args['creationflags'] = \ subprocess.CREATE_NEW_PROCESS_GROUP self.internal = Popen(self.cmds, **popen_args) else: runs = [] for index, cmd in enumerate(self.cmds): if index == 0: stdin = self.input_file.fd else: stdin = runs[index - 1].stdout # When connecting two processes using a Pipe don't use # universal_newlines mode. Indeed commands transmitting # binary data between them will crash # (e.g. gzip -dc foo.txt | tar -xf -) if index == len(self.cmds) - 1: stdout = self.output_file.fd txt_mode = True else: stdout = subprocess.PIPE txt_mode = False popen_args = { 'stdin': stdin, 'stdout': stdout, 'stderr': self.error_file.fd, 'cwd': cwd, 'env': env, 'universal_newlines': txt_mode } if sys.platform != 'win32' and \ set_sigpipe: # windows: no cover # preexec_fn is no supported on windows popen_args['preexec_fn'] = subprocess_setup if WIN_NEW_PG and sys.platform == 'win32': popen_args['creationflags'] = \ subprocess.CREATE_NEW_PROCESS_GROUP try: runs.append(Popen(cmd, **popen_args)) except OSError: logger.error('error when spawning %s', cmd) # We have an error (e.g. file not found), try to kill # all processes already started. for p in runs: p.terminate() raise self.internal = runs[-1] except Exception as e: # defensive code self.__error(e, self.cmds) raise self.pid = self.internal.pid if not bg: self.wait() def command_line_image(self): """Get shell command line image of the spawned command(s). :rtype: str This just a convenient wrapper around the function of the same name. """ return command_line_image(self.cmds) def close_files(self): """Close all file descriptors.""" self.output_file.close() self.error_file.close() self.input_file.close() def __error(self, error, cmds): """Set pid to -1 and status to 127 before closing files.""" self.close_files() logger.error(error) def not_found(path): """Raise OSError. :param path: path of the executable :type path: str """ logger.error("%s not found", path) e3.log.debug('PATH=%s', os.environ['PATH']) raise OSError(errno.ENOENT, 'No such file or directory, %s not found' % path) # Try to send an helpful message if one of the executable has not # been found. if isinstance(cmds[0], basestring): if which(cmds[0], default=None) is None: not_found(cmds[0]) else: for cmd in cmds: if which(cmd[0], default=None) is None: not_found(cmd[0]) def wait(self): """Wait until process ends and return its status. :return: exit code of the process :rtype: int """ if self.status is not None: # Wait has already been called return self.status # If there is no pipe in the loop then just do a wait. Otherwise # in order to avoid blocked processes due to full pipes, use # communicate. if self.output_file.fd != subprocess.PIPE and \ self.error_file.fd != subprocess.PIPE and \ self.input_file.fd != subprocess.PIPE: self.status = self.internal.wait() else: tmp_input = None if self.input_file.fd == subprocess.PIPE: tmp_input = self.input_file.get_command() (self.out, self.err) = self.internal.communicate(tmp_input) self.status = self.internal.returncode self.close_files() return self.status def poll(self): """Check the process status and set self.status if available. This method checks whether the underlying process has exited or not. If it hasn't, then it just returns None immediately. Otherwise, it stores the process' exit code in self.status and then returns it. :return: None if the process is still alive; otherwise, returns the process exit status. :rtype: int | None """ if self.status is not None: # Process is already terminated and wait been called return self.status result = self.internal.poll() if result is not None: # Process is finished, call wait to finalize it (closing handles, # ...) return self.wait() else: return None def kill(self, recursive=True, timeout=3): """Kill the process. :param recursive: if True, try to kill the complete process tree :type recursive: bool :param timeout: wait timeout (in seconds) after sending the kill signal (when recursive=True) :type timeout: int """ if recursive: kill_process_tree(self.internal, timeout=timeout) else: self.internal.kill() def interrupt(self): """Send SIGINT to the process, kill on Windows.""" if sys.platform == 'win32': self.kill() # Ctrl-C event is unreliable on Windows else: self.internal.send_signal(signal.SIGINT) def is_running(self): """Check whether the process is running. :rtype: bool """ if psutil is None: # defensive code # psutil not imported, use our is_running function return is_running(self.pid) else: return self.internal.is_running() def children(self): """Return list of child processes (using psutil). :rtype: list[psutil.Process] """ if psutil is None: # defensive code raise NotImplementedError('Run.children() require psutil') return self.internal.children()
class Run(object): """Class to handle processes. :ivar cmds: The ``cmds`` argument passed to the __init__ method (a command line passed in a list, or a list of command lines passed as a list of list). :ivar status: The exit status. As the exit status is only meaningful after the process has exited, its initial value is None. When a problem running the command is detected and a process does not get created, its value gets set to the special value 127. :ivar out: process standard output (if instanciated with output = PIPE) :ivar err: same as out but for standard error :ivar pid: PID. Set to -1 if the command failed to run. """ def __init__(self, cmds, cwd=None, output=PIPE, error=STDOUT, input=None, bg=False, timeout=None, env=None, set_sigpipe=True, parse_shebang=False, ignore_environ=True, python_executable=sys.executable): """Spawn a process. :param cmds: two possibilities: 1) a command line: a tool name and its arguments, passed in a list. e.g. ['ls', '-a', '.'] 2) a list of command lines (as defined in (1)): the different commands will be piped. This means that [['ps', '-a'], ['grep', 'vxsim']] will be equivalent to the system command line 'ps -a | grep vxsim'. :type cmds: list[str] | list[list[str]] :param cwd: directory in which the process should be executed (string or None). If None then current directory is used :type cwd: str | None :param output: can be PIPE (default), a filename string, a fd on an already opened file, a python file object or None (for stdout). :type output: int | str | file | None :param error: same as output or STDOUT, which indicates that the stderr data from the applications should be captured into the same file handle as for stdout. :type error: int | str | file | None :param input: same as output :type input: int | str | file | None :param bg: if True then run in background :type bg: bool :param timeout: limit execution time (in seconds), None means unlimited :type timeout: int | None :param env: dictionary for environment variables (e.g. os.environ) :type env: dict :param set_sigpipe: reset SIGPIPE handler to default value :type set_sigpipe: bool :param parse_shebang: take the #! interpreter line into account :type parse_shebang: bool :param ignore_environ: Applies only when env parameter is not None. When set to True (the default), the only environment variables passed to the program are the ones provided by the env parameter. Otherwise, the environment passed to the program consists of the environment variables currently defined (os.environ) augmented by the ones provided in env. :type ignore_environ: bool :param python_executable: name or path to the python executable :type python_executable: str :raise OSError: when trying to execute a non-existent file. If you specify a filename for output or stderr then file content is reseted (equiv. to > in shell). If you prepend the filename with '+' then the file will be opened in append mode (equiv. to >> in shell) If you prepend the input with '|', then the content of input string will be used for process stdin. """ def add_interpreter_command(cmd_line): """Add the interpreter defined in the #! line to cmd_line. If the #! line cannot be parsed, just return the cmd_line unchanged If the interpreter command line contains /usr/bin/env python it will be replaced by the value of python_executable On windows, /usr/bin/env will be ignored to avoid a dependency on cygwin :param cmd_line: command line :type cmd_line: list[str] """ if not parse_shebang: # nothing to do return cmd_line prog = which(cmd_line[0], default=None) if prog is None: # Not found. Do not modify the command line return cmd_line with open(prog) as f: header = f.read()[0:2] if header != "#!": # Unknown header return cmd_line # Header found, get the interpreter command in the first line f.seek(0) line = f.readline() interpreter_cmds = [l.strip() for l in line[line.find('!') + 1:].split()] # Pass the program path to the interpreter if len(cmd_line) > 1: cmd_line = [prog] + list(cmd_line[1:]) else: cmd_line = [prog] # If the interpreter is '/usr/bin/env python', use # python_executable instead to keep the same python executable if interpreter_cmds[0:2] == ['/usr/bin/env', 'python']: if len(interpreter_cmds) > 2: return [python_executable] + \ interpreter_cmds[2:] + cmd_line else: return [python_executable] + cmd_line elif sys.platform == 'win32': # unix: no cover if interpreter_cmds[0] == '/usr/bin/env': return interpreter_cmds[1:] + cmd_line elif interpreter_cmds[0] in ('/bin/bash', '/bin/sh') and \ 'SHELL' in os.environ: return [os.environ['SHELL']] + cmd_line return interpreter_cmds + cmd_line # First resolve output, error and input self.input_file = File(input, 'r') self.output_file = File(output, 'w') self.error_file = File(error, 'w') self.status = None self.out = '' self.err = '' self.cmds = [] if env is not None and not ignore_environ: # ignore_environ is False, so get a copy of the current # environment and update it with the env dictionnary. tmp = os.environ.copy() tmp.update(env) env = tmp rlimit_args = [] if timeout is not None: rlimit = get_rlimit() if os.path.exists(rlimit): rlimit_args = [rlimit, '%d' % timeout] else: logger.warning('cannot find rlimit at %s', rlimit) rlimit_args = [] try: if isinstance(cmds[0], basestring): self.cmds = rlimit_args + list(add_interpreter_command(cmds)) else: self.cmds = [add_interpreter_command(c) for c in cmds] self.cmds[0] = rlimit_args + list(self.cmds[0]) cmdlogger.debug('Run: cd %s; %s' % ( cwd if cwd is not None else os.getcwd(), self.command_line_image())) if isinstance(cmds[0], basestring): popen_args = { 'stdin': self.input_file.fd, 'stdout': self.output_file.fd, 'stderr': self.error_file.fd, 'cwd': cwd, 'env': env, 'universal_newlines': True} if sys.platform != 'win32' and set_sigpipe: # preexec_fn is no supported on windows popen_args['preexec_fn'] = subprocess_setup self.internal = Popen(self.cmds, **popen_args) else: runs = [] for index, cmd in enumerate(self.cmds): if index == 0: stdin = self.input_file.fd else: stdin = runs[index - 1].stdout # When connecting two processes using a Pipe don't use # universal_newlines mode. Indeed commands transmitting # binary data between them will crash # (e.g. gzip -dc foo.txt | tar -xf -) if index == len(self.cmds) - 1: stdout = self.output_file.fd txt_mode = True else: stdout = subprocess.PIPE txt_mode = False popen_args = { 'stdin': stdin, 'stdout': stdout, 'stderr': self.error_file.fd, 'cwd': cwd, 'env': env, 'universal_newlines': txt_mode} if sys.platform != 'win32' and set_sigpipe: # preexec_fn is no supported on windows popen_args['preexec_fn'] = subprocess_setup try: runs.append(Popen(cmd, **popen_args)) except OSError as e: logger.error('error when spawning %s', cmd) # We have an error (e.g. file not found), try to kill # all processes already started. for p in runs: p.terminate() raise self.internal = runs[-1] except Exception as e: self.__error(e, self.cmds) raise self.pid = self.internal.pid if not bg: self.wait() def command_line_image(self): """Get shell command line image of the spawned command(s). :rtype: str This just a convenient wrapper around the function of the same name. """ return command_line_image(self.cmds) def close_files(self): """Close all file descriptors.""" self.output_file.close() self.error_file.close() self.input_file.close() def __error(self, error, cmds): """Set pid to -1 and status to 127 before closing files.""" self.close_files() logger.error(error) def not_found(path): """Raise OSError. :param path: path of the executable :type path: str """ logger.error("%s not found", path) e3.log.debug('PATH=%s', os.environ['PATH']) raise OSError(errno.ENOENT, 'No such file or directory, %s not found' % path) # Try to send an helpful message if one of the executable has not # been found. if isinstance(cmds[0], basestring): if which(cmds[0], default=None) is None: not_found(cmds[0]) else: for cmd in cmds: if which(cmd[0], default=None) is None: not_found(cmd[0]) def wait(self): """Wait until process ends and return its status. :return: exit code of the process :rtype: int """ if self.status is not None: # Wait has already been called return self.status # If there is no pipe in the loop then just do a wait. Otherwise # in order to avoid blocked processes due to full pipes, use # communicate. if self.output_file.fd != subprocess.PIPE and \ self.error_file.fd != subprocess.PIPE and \ self.input_file.fd != subprocess.PIPE: self.status = self.internal.wait() else: tmp_input = None if self.input_file.fd == subprocess.PIPE: tmp_input = self.input_file.get_command() (self.out, self.err) = self.internal.communicate(tmp_input) self.status = self.internal.returncode self.close_files() return self.status def poll(self): """Check the process status and set self.status if available. This method checks whether the underlying process has exited or not. If it hasn't, then it just returns None immediately. Otherwise, it stores the process' exit code in self.status and then returns it. :return: None if the process is still alive; otherwise, returns the process exit status. :rtype: int | None """ if self.status is not None: # Process is already terminated and wait been called return self.status result = self.internal.poll() if result is not None: # Process is finished, call wait to finalize it (closing handles, # ...) return self.wait() else: return None def kill(self): """Kill the process.""" self.internal.kill() def interrupt(self): """Send SIGINT CTRL_C_EVENT to the process.""" # On windows CTRL_C_EVENT is available and SIGINT is not; # and the other way around on other platforms. interrupt_signal = getattr(signal, 'CTRL_C_EVENT', signal.SIGINT) self.internal.send_signal(interrupt_signal) def is_running(self): """Check whether the process is running. :rtype: bool """ if psutil is None: # psutil not imported, use our is_running function return is_running(self.pid) else: return self.internal.is_running() def children(self): """Return list of child processes (using psutil). :rtype: list[psutil.Process] """ if psutil is None: raise NotImplementedError('Run.children() require psutil') return self.internal.children()
class Run: """Class to handle processes. :ivar cmds: The ``cmds`` argument passed to the __init__ method (a command line passed in a list, or a list of command lines passed as a list of list). :ivar status: The exit status. As the exit status is only meaningful after the process has exited, its initial value is None. When a problem running the command is detected and a process does not get created, its value gets set to the special value 127. :ivar raw_out: process standard output as bytes (if instanciated with output = PIPE). Use self.out to get a decoded string. :ivar raw_err: same as raw_out but for standard error. :ivar pid: PID. Set to -1 if the command failed to run. """ def __init__( self, cmds: AnyCmdLine, cwd: Optional[str] = None, output: STDOUT_VALUE | DEVNULL_VALUE | PIPE_VALUE | str | IO | None = PIPE, error: STDOUT_VALUE | DEVNULL_VALUE | PIPE_VALUE | str | IO | None = STDOUT, input: DEVNULL_VALUE | PIPE_VALUE | str | IO | None = None, # noqa: A002 bg: bool = False, timeout: Optional[int] = None, env: Optional[dict] = None, set_sigpipe: bool = True, parse_shebang: bool = False, ignore_environ: bool = True, ) -> None: """Spawn a process. :param cmds: two possibilities: 1) a command line: a tool name and its arguments, passed in a list. e.g. ['ls', '-a', '.'] 2) a list of command lines (as defined in (1)): the different commands will be piped. This means that [['ps', '-a'], ['grep', 'vxsim']] will be equivalent to the system command line 'ps -a | grep vxsim'. :param cwd: directory in which the process should be executed (string or None). If None then current directory is used :param output: can be PIPE (default), a filename string, a fd on an already opened file, a python file object or None (for stdout). :param error: same as output or STDOUT, which indicates that the stderr data from the applications should be captured into the same file handle as for stdout. :param input: same as output :param bg: if True then run in background :param timeout: limit execution time (in seconds), None means unlimited :param env: dictionary for environment variables (e.g. os.environ) :param set_sigpipe: reset SIGPIPE handler to default value :param parse_shebang: take the #! interpreter line into account :param ignore_environ: Applies only when env parameter is not None. When set to True (the default), the only environment variables passed to the program are the ones provided by the env parameter. Otherwise, the environment passed to the program consists of the environment variables currently defined (os.environ) augmented by the ones provided in env. :raise OSError: when trying to execute a non-existent file. If you specify a filename for output or stderr then file content is reseted (equiv. to > in shell). If you prepend the filename with '+' then the file will be opened in append mode (equiv. to >> in shell) If you prepend the input with '|', then the content of input string will be used for process stdin. """ def add_interpreter_command(cmd_line: CmdLine) -> CmdLine: """Add the interpreter defined in the #! line to cmd_line. If the #! line cannot be parsed, just return the cmd_line unchanged On windows, /usr/bin/env will be ignored to avoid a dependency on cygwin and /bin/bash & /bin/sh are replaced by $SHELL if defined. :param cmd_line: command line """ if not parse_shebang: # nothing to do return cmd_line prog = which(cmd_line[0], default=None) if prog is None: # Not found. Do not modify the command line return cmd_line with open(prog) as f: try: header = f.read()[0:2] except UnicodeDecodeError: # unknown header - cannot decode the first two bytes return cmd_line if header != "#!": # Unknown header return cmd_line # Header found, get the interpreter command in the first line f.seek(0) line = f.readline() interpreter_cmds = [ word.strip() for word in line[line.find("!") + 1:].split() ] # Pass the program path to the interpreter if len(cmd_line) > 1: cmd_line = [prog] + list(cmd_line[1:]) else: cmd_line = [prog] if sys.platform == "win32": # unix: no cover if interpreter_cmds[0] == "/usr/bin/env": # On windows be sure that PATH is taken into account by # using which. In some cases involving python # interpreter, the python interpreter used to run this # module has been used rather than the first one on the # path. interpreter_cmds[1] = which( interpreter_cmds[1], default=interpreter_cmds[1]) return interpreter_cmds[1:] + cmd_line elif (interpreter_cmds[0] in ("/bin/bash", "/bin/sh") and "SHELL" in os.environ): return [os.environ["SHELL"]] + cmd_line return interpreter_cmds + cmd_line # First resolve output, error and input self.input_file = File(input, "r") self.output_file = File(output, "w") self.error_file = File(error, "w") self.status: Optional[int] = None self.raw_out = b"" self.raw_err = b"" self.cmds = [] if env is not None: if ignore_environ: if sys.platform == "win32": # On Windows not all environment variables can be # discarded. At least SYSTEMDRIVE, SYSTEMROOT should be # set. In order to be portable propagate their value in # case the user does not pass them in env when # ignore_environ is set to True. tmp = {} for var in ("SYSTEMDRIVE", "SYSTEMROOT"): if var not in env and var in os.environ: tmp[var] = os.environ[var] tmp.update(env) env = tmp else: # ignore_environ is False, so get a copy of the current # environment and update it with the env dictionary. tmp = os.environ.copy() tmp.update(env) env = tmp rlimit_args = [] if timeout is not None: rlimit = get_rlimit() if os.path.exists(rlimit): rlimit_args = [rlimit, "%d" % timeout] else: logger.warning("cannot find rlimit at %s", rlimit) rlimit_args = [] try: self.cmds = [ add_interpreter_command(c) for c in to_cmd_lines(cmds) ] self.cmds[0] = rlimit_args + list(self.cmds[0]) cmdlogger.debug( "Run: cd %s; %s", cwd if cwd is not None else os.getcwd(), self.command_line_image(), ) if len(self.cmds) == 1: popen_args = { "stdin": self.input_file.fd, "stdout": self.output_file.fd, "stderr": self.error_file.fd, "cwd": cwd, "env": env, "universal_newlines": False, } if sys.platform != "win32" and set_sigpipe: # windows: no cover # preexec_fn is no supported on windows popen_args["preexec_fn"] = subprocess_setup # type: ignore if sys.platform == "win32": popen_args[ "creationflags"] = subprocess.CREATE_NEW_PROCESS_GROUP self.internal = Popen(self.cmds[0], **popen_args) else: runs: list[subprocess.Popen] = [] for index, cmd in enumerate(self.cmds): if index == 0: stdin: int | IO[Any] = self.input_file.fd else: previous_stdout = runs[index - 1].stdout assert previous_stdout is not None stdin = previous_stdout # When connecting two processes using a Pipe don't use # universal_newlines mode. Indeed commands transmitting # binary data between them will crash # (e.g. gzip -dc foo.txt | tar -xf -) if index == len(self.cmds) - 1: stdout = self.output_file.fd else: stdout = subprocess.PIPE popen_args = { "stdin": stdin, "stdout": stdout, "stderr": self.error_file.fd, "cwd": cwd, "env": env, "universal_newlines": False, } if sys.platform != "win32" and set_sigpipe: # windows: no cover # preexec_fn is no supported on windows popen_args[ "preexec_fn"] = subprocess_setup # type: ignore if sys.platform == "win32": popen_args[ "creationflags"] = subprocess.CREATE_NEW_PROCESS_GROUP try: runs.append(Popen(cmd, **popen_args)) except OSError: logger.error("error when spawning %s", cmd) # We have an error (e.g. file not found), try to kill # all processes already started. for p in runs: p.terminate() raise self.internal = runs[-1] except Exception as e: # defensive code self.__error(e, self.cmds) raise self.pid = self.internal.pid if not bg: self.wait() @property def out(self) -> str: """Process output as string. Attempt is done to decode as utf-8 the output. If the output is not in utf-8 a string representation will be returned (see e3.text.bytes_as_str). """ return bytes_as_str(self.raw_out) @property def err(self) -> str: """Process error as string. Attempt is done to decode as utf-8 the output. If the output is not in utf-8 a string representation will be returned (see e3.text.bytes_as_str). """ return bytes_as_str(self.raw_err) def command_line_image(self) -> str: """Get shell command line image of the spawned command(s). This just a convenient wrapper around the function of the same name. """ return command_line_image(self.cmds) def close_files(self) -> None: """Close all file descriptors.""" self.output_file.close() self.error_file.close() self.input_file.close() def __error(self, error: Exception, cmds: list[CmdLine]) -> None: """Set pid to -1 and status to 127 before closing files.""" self.close_files() logger.error(error) def not_found(path: str) -> NoReturn: """Raise OSError. :param path: path of the executable """ logger.error("%s not found", path) e3.log.debug("PATH=%s", os.environ["PATH"]) raise OSError(errno.ENOENT, f"No such file or directory, {path} not found") # Try to send an helpful message if one of the executable has not # been found. for cmd in cmds: if which(cmd[0], default=None) is None: not_found(cmd[0]) def wait(self) -> int: """Wait until process ends and return its status. :return: exit code of the process """ if self.status is not None: # Wait has already been called return self.status # If there is no pipe in the loop then just do a wait. Otherwise # in order to avoid blocked processes due to full pipes, use # communicate. if (self.output_file.fd != subprocess.PIPE and self.error_file.fd != subprocess.PIPE and self.input_file.fd != subprocess.PIPE): self.status = self.internal.wait() else: tmp_input: Optional[str | bytes] = None if self.input_file.fd == subprocess.PIPE: tmp_input = self.input_file.get_command() if isinstance(tmp_input, str): tmp_input = tmp_input.encode("utf-8") (self.raw_out, self.raw_err) = self.internal.communicate(tmp_input) self.status = self.internal.returncode self.close_files() return self.status def poll(self) -> Optional[int]: """Check the process status and set self.status if available. This method checks whether the underlying process has exited or not. If it hasn't, then it just returns None immediately. Otherwise, it stores the process' exit code in self.status and then returns it. :return: None if the process is still alive; otherwise, returns the process exit status. """ if self.status is not None: # Process is already terminated and wait been called return self.status result = self.internal.poll() if result is not None: # Process is finished, call wait to finalize it (closing handles, # ...) return self.wait() else: return None def kill(self, recursive: bool = True, timeout: int = 3) -> None: """Kill the process. :param recursive: if True, try to kill the complete process tree :param timeout: wait timeout (in seconds) after sending the kill signal (when recursive=True) """ if recursive: kill_process_tree(self.internal, timeout=timeout) else: self.internal.kill() def interrupt(self) -> None: """Send SIGINT to the process, kill on Windows.""" if sys.platform == "win32": self.kill() # Ctrl-C event is unreliable on Windows else: self.internal.send_signal(signal.SIGINT) def is_running(self) -> bool: """Check whether the process is running.""" if psutil is None: # defensive code # psutil not imported, use our is_running function return is_running(self.pid) else: return self.internal.is_running() def children(self) -> list[Any]: """Return list of child processes (using psutil).""" if psutil is None: # defensive code raise NotImplementedError("Run.children() require psutil") return self.internal.children()
config['general']['random_bind_ip'] = False if not args.use_tor: config['transports']['tor'] = False if not args.animated_background: config['ui']['animated_background'] = False if args.keep_log_on_exit: config['log']['file']['remove_on_exit'] = True else: config['log']['file']['remove_on_exit'] = False config['general']['upload_mixing'] = False if args.use_upload_mixing: config['general']['upload_mixing'] = True config['general']['display_header'] = False config['general']['security_level'] = args.security_level with open(config_file, 'w') as cf: cf.write(ujson.dumps(config, reject_bytes=False)) if args.open_ui: p = Popen([sub_script, 'start'], stdout=DEVNULL) sleep(2) Popen([sub_script, 'openhome'], stdout=DEVNULL) else: p = Popen([sub_script, 'start'], stdout=DEVNULL) p = p.children()[0] if args.show_stats: Thread(target=show_info, args=[p], daemon=True).start() p.wait()