Run a command line program and wait until it terminates.

Run a command line program and wait until it terminates.

run(
  command,
  ...,
  input = NULL,
  error_on_status = TRUE,
  stderr_to_stdout = FALSE,
  wd = NULL,
  timeout = Inf,
  env = NULL
)

Arguments

command	the command to run
...	the arguments pass to the program, supports the big bang operator !!!
input	text pass to stdin
error_on_status	raise an error if return code is not 0.
stderr_to_stdout	whether stderr should be forwarded to stdout.
wd	working directory
timeout	throw an error after this amount of time in second
env	additional environment variables

Value

The stdout of the program in a scalar character. It may contain a trailing newline. Use trimws() to ensure the trailing newline is trimmed.

Examples

if (FALSE) {
git <- function(...) cliff::run("git", ...)
git("log", git("rev-parse", "--abbrev-ref", "HEAD"), "-n1")
}