rig run

Author: gaborcsardi

Cargo.lock

@@ -40,6 +40,7 @@ semver = "1.0.4"
 serde = { version = "1.0", features = ["derive"] }
 serde_derive = "1.0"
 serde_json = "1.0"
+serde_yaml = "0.9"
 sha2 = "0.9.8"
 shellexpand = "2.1.0"
 simple-error = "0.2.3"

Cargo.toml

@@ -190,12 +190,14 @@ Run `rig` to see all commands and examples.
 
 ```
 rig add        -- install a new R version [alias: install]
+rig available  -- List R versions available to install.
 rig default    -- print or set default R version [alias: switch]
 rig library    -- manage package libraries [alias: lib] (experimental)
 rig list       -- list installed R versions [alias: ls]
 rig resolve    -- resolve a symbolic R version
 rig rm         -- remove R versions [aliases: del, delete, remove]
 rig rstudio    -- start RStudio with the specified R version
+rig run        -- Run R, an R script or an R project
 rig sysreqs    -- manage R-related system libraries and tools (experimental) (macOS)
 rig system     -- manage current installations
 ```

README.Rmd

@@ -181,12 +181,14 @@ Run `rig` to see all commands and examples.
 ### Command list:
 
     rig add        -- install a new R version [alias: install]
+    rig available  -- List R versions available to install.
     rig default    -- print or set default R version [alias: switch]
     rig library    -- manage package libraries [alias: lib] (experimental)
     rig list       -- list installed R versions [alias: ls]
     rig resolve    -- resolve a symbolic R version
     rig rm         -- remove R versions [aliases: del, delete, remove]
     rig rstudio    -- start RStudio with the specified R version
+    rig run        -- Run R, an R script or an R project
     rig sysreqs    -- manage R-related system libraries and tools (experimental) (macOS)
     rig system     -- manage current installations
 

README.md

@@ -24,6 +24,15 @@ pub fn rig_app() -> Command {
     let _arch_x86_64: &'static str = "x86_64";
     let _arch_arm64: &'static str = "arm64";
     let mut _default_arch: &'static str = "";
+    let app_types = [
+        "api",
+        "shiny",
+        "quarto-shiny",
+        "rmd-shiny",
+        "quarto-static",
+        "rmd-static",
+        "static"
+    ];
 
     #[cfg(target_os = "macos")]
     {
@@ -560,28 +569,79 @@ pub fn rig_app() -> Command {
         .arg(
             Arg::new("r-version")
                 .help("R version to use")
+                .short('r')
                 .long("r-version")
                 .required(false)
         )
+        .arg(
+            Arg::new("app-type")
+                .help("Explicitly specify app type to run")
+                .short('t')
+                .long("app-type")
+                .required(false)
+                .value_parser(app_types)
+                .conflicts_with("eval")
+                .conflicts_with("script")
+        )
+        .arg(
+            Arg::new("dry-run")
+                .help("Show the command, but do not run it")
+                .long("dry-run")
+                .required(false)
+                .action(clap::ArgAction::SetTrue)
+        )
+        .arg(
+            Arg::new("startup")
+                .help("Print R startup message")
+                .long("startup")
+                .action(clap::ArgAction::SetTrue)
+                .required(false)
+        )
+        .arg(
+            Arg::new("no-startup")
+                .help("Do not print R startup message")
+                .long("no-startup")
+                .action(clap::ArgAction::SetTrue)
+                .required(false)
+                .conflicts_with("startup")
+        )
+        .arg(
+            Arg::new("echo")
+                .help("Print input to R")
+                .long("echo")
+                .action(clap::ArgAction::SetTrue)
+                .required(false)
+        )
+        .arg(
+            Arg::new("no-echo")
+                .help("Do not print input to R")
+                .long("no-echo")
+                .action(clap::ArgAction::SetTrue)
+                .required(false)
+                .conflicts_with("echo")
+        )
         .arg(
             Arg::new("eval")
                 .help("R expression to evaluate")
+                .short('e')
                 .long("eval")
                 .num_args(1)
                 .required(false)
         )
         .arg(
             Arg::new("script")
                 .help("R script file to run")
+                .short('f')
                 .long("script")
                 .num_args(1)
                 .required(false)
+                .conflicts_with("eval")
         )
         .arg(
             Arg::new("command")
                 .help("R script or project to run, with parameters")
                 .required(false)
-                .action(clap::ArgAction::Append),
+                .action(clap::ArgAction::Append)
         );
 
     rig = rig.arg(

src/args.rs

@@ -72,4 +72,25 @@ const HELP_RUN: &str = "
 \x1b[4m\x1b[1mDescription:\x1b[22m\x1b[24m
   Run R, an R script or an R project, using the selected R version.
 
-  TODO";
+  All of these examples allow an `--r-version` argument, to use a specific
+  R version.
+
+  Start R:
+    rig run
+  Run an R script:
+    rig run -f <script-file>
+  Evaluate an R expression:
+    rig run -e <expression>
+  Run a script from a package (from its `exec` directory):
+    rig run <pkg>::<script>
+  Run an R app:
+    rig run <path-to-app>
+
+  Currently supported apps are:
+  - Plumber APIs,
+  - Shiny apps,
+  - Quarto dcouments embedding Shiny apps,
+  - Quarto documents,
+  - Rmd documents,
+  - Rmd documents embedding Shiny apps,
+  - Static web sites.";