rstudioapi (version 0.10)

build-tools: Build Tools

Description

Check, install, and use build tools as required.

Usage

buildToolsCheck()
buildToolsInstall(action)
buildToolsExec(expr)

Arguments

action

The action (as a string) being taken that will require installation of build tools.

expr

An R expression (unquoted) to be executed with build tools available and on the PATH.

Details

These functions are intended to be used together -- one should first check whether build tools are available, and when not, prompt for installation. For example:

compile_model <- function(...) {
if (rstudioapi::isAvailable()) {
if (!rstudioapi::buildToolsCheck())
      rstudioapi::buildToolsInstall("Model compilation")
rstudioapi::buildToolsExec({
      # code requiring build tools here
    })
}
}

The action parameter is used to communicate (with a prompt) the operation being performed that requires build tool installation. Setting it to NULL or the empty string will suppress that prompt.