Usage
run(command = NULL, args = character(), commandline = NULL,
error_on_status = TRUE, echo = FALSE, spinner = FALSE, timeout = Inf,
stdout_callback = NULL, stderr_callback = NULL, check_interval = 0.01)
Arguments
command
Character scalar, the command to run. It will be
escaped via base::shQuote. args
Character vector, arguments to the command. They will be
escaped via base::shQuote. commandline
A character scalar, a full command line.
No escaping will be performed on it.
error_on_status
Whether to throw an error if the command returns
with a non-zero status, or it is interrupted. The error clases are
system_command_status_error
and system_command_timeout_error
,
respectively, and both errors have class system_command_error
as
well.
echo
Whether to print the command, the standard output and error
to the screen. Note that the order of the standard output and error
lines are not necessarily correct, as standard output is typically
buffered.
spinner
Whether to a reassusing spinner while the process
is running.
timeout
Timeout for the process, in seconds, or as a difftime
object. If it is not finished before this, it will be killed.
stdout_callback
NULL
, or a function to call for every line
of the standard output. See more below.
stderr_callback
NULL
, or a function to call for every line
of the standard error. See more below.
check_interval
How often to check on the process for output.
This is only used if the process had no output at the last check.
If a process continuously produces output, then run
does not
wait at all.