API Documentation

soldier.run(command, background=False, std_id='', sudo=None, timeout=0, kill_on_timeout=False, stream=False, suppress_std_err=False, shell=False)

The main run command which executes the system process

Parameters:
  • background (bool) – Set this true if you want to run the command asynchronously
  • std_in (string) – The standard input to be given to the process
  • sudo (string) – If you want to execute the command as root, this argument should be your password
  • cwd (string) – Working directory of the command being executed
  • env (dict(str, str)) – Environment variables that would be available when the command is being executed
  • stream (bool) – When set to true, the output of your command will be streamed. (It does not work with piped commands)
  • suppress_std_err (bool) – When set to true, the output from stderr would not be printed.
  • timeout (int) – The timeout for the process in seconds
  • kill_on_timeout (bool) – If set to true, your process will killed when the time is up, and if it is False, it will throw a soldier.ProcessTimeoutError
  • shell (bool) – Set this to true if you want to execute the process in the /bin/sh environment
Returns:

A soldier.Soldier object

Return type:

soldier.Soldier

Warning

Passing shell=True can be a security hazard if combined with untrusted input.

class soldier.Soldier

The class object which is returned with the soldier.run() method.

Methods

kill()

This function is used to kill the current process

Return type:None
is_alive()

This function checks whether process is active or not

Returns:A bool specifying whether the process is running or not
Return type:bool

Properties

  • pid - Returns the pid of the process
  • exit_code - Returns the exit code of the process
  • status_code - Returns the exit code of the process (To be deprecated, prefer exit_code)
  • output - Returns the stdout (standard output) of the process
  • error - Returns the stderr (standard error) of the process
  • start_ts - Returns the start time (datetime.datetime object) of the process
  • end_ts - Returns the end time (datetime.datetime object) of the process
  • duration - Returns the total duration(datetime.timedelta object) of the process