Specs

await_exit(pid(), timeout()) :: {:ok, integer()} | :timeout

Waits for the program to terminate.

If the program terminates before timeout, it returns {:ok, exit_status} else returns :timeout

Returns a specification to start this module under a supervisor.

See Supervisor.

Specs

close_stdin(pid()) :: :ok | {:error, any()}

Closes input stream. Which signal EOF to the program

Specs

os_pid(pid()) :: integer()

Returns os pid of the command

Returns port_info

Specs

read(pid(), non_neg_integer() | :infinity) ::
  {:ok, iodata()} | :eof | {:error, String.t()} | :closed

Return bytes written by the program to output stream.

This blocks until the programs write and flush the output

Specs

start_link([String.t(), ...],
  cd: String.t(),
  env: [{String.t(), String.t()}],
  log: boolean()
) ::
  {:ok, pid()} | {:error, any()}

Starts a process using cmd_with_args and with options opts

cmd_with_args must be a list containing command with arguments. example: ["cat", "file.txt"].

options

Options

• cd - the directory to run the command in
• env - a list of tuples containing environment key-value. These can be accessed in the external program
• log - When set to true odu logs and command stderr output are logged. Defaults to false

Specs

status(pid()) :: :started | {:done, integer()}

Returns status of the process. It will be either of :started, {:done, exit_status}

Kills the program

Specs

write(pid(), iodata(), non_neg_integer() | :infinity) ::
  :ok | {:error, String.t()} | :closed

Writes iodata data to programs input streams

This blocks when the pipe is full