terminalExecute: Execute Command

Description Usage Arguments Value Note Examples

Description

Execute a command, showing results in the terminal pane.

Usage

1
2
terminalExecute(command, workingDir = NULL, env = character(),
  show = TRUE)

Arguments

command

System command to be invoked, as a character string.

workingDir

Working directory for command

env

Vector of name=value strings to set environment variables

show

If FALSE, terminal won't be brought to front

Value

The terminal identifier as a character vector (NULL if unable to create the terminal).

Note

The terminalExecute function was added in version 1.1.350 of RStudio.

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
## Not run: 
termId <- rstudioapi::terminalExecute(
  command = 'echo $HELLO && echo $WORLD',
  workingDir = '/usr/local',
  env = c('HELLO=WORLD', 'WORLD=EARTH'),
  show = FALSE)

while (is.null(rstudioapi::terminalExitCode(termId))) {
  Sys.sleep(0.1)
}

result <- terminalBuffer(termId)
terminalKill(termId)
print(result)

## End(Not run)

rstudio/rstudioapi documentation built on June 7, 2019, 3:43 p.m.