rig run

Run R, an R script or an R project, using the selected R version.

All of these examples allow an --r-version argument, to use a specific R version.

rig run                    # start R
rig run -f <script-file>   # run an R script
rig run -e <expression>    # evaluate an R expression
rig run <pkg>::<script>    # run a script from a package's exec directory
rig run <path-to-app>      # run an R app

Currently supported apps are:

• Plumber APIs,
• Shiny apps,
• Quarto documents embedding Shiny apps,
• Quarto documents,
• Rmd documents,
• Rmd documents embedding Shiny apps,
• Static web sites.

Usage

rig run [OPTIONS] [command]...

Arguments

[command]...

R script or project to run, with parameters

Options

--admin

Run in admin mode (overrides RIG_MODE and config)

-t, --app-type <app-type>

Explicitly specify app type to run [possible values: api, shiny, quarto-shiny, rmd-shiny, quarto-static, rmd-static, static]

--dry-run

Show the command, but do not run it

--echo

Print input to R

-e, --eval <eval>

R expression to evaluate

-h, --help

Print help (see a summary with ‘-h’)

--no-echo

Do not print input to R

--no-startup

Do not print R startup message

-r, --r-version <r-version>

R version to use

-f, --script <script>

R script file to run

--startup

Print R startup message

--user

Run in user mode (overrides RIG_MODE and config)