Movatterモバイル変換

The goal of scribe is to provide a detailed argument parser forRscript. This package contains no dependencies outside ofbase andmethods. The core functions utilizeReferenceClasses under the hood.

library(scribe)

install.packages("scribe")

You can enter command arguments as a vector to test out the behavior.Arguments can be added to thescribeCommandArgs class (hereasca). Default behavior tries to parse objects butadditional control can be taken.

ca<-command_args(c("-a","1","-b","2"))ca$add_argument("-a")ca$add_argument("-b")args<- ca$parse()str(args$a+ args$b)#>  int 3

# don't convert numbersca<-command_args(c("-a","1","-b","1.0"))ca$add_argument("-a",convert = as.character)ca$add_argument("-b",convert = as.character)ca$parse()#> $a#> [1] "1"#>#> $b#> [1] "1.0"# convert numbers to integersca<-command_args(c("verbose","1","1.5","1.9"))ca$add_argument("verbose",action ="flag")ca$add_argument("...",convert = as.integer)ca$parse()#> $verbose#> [1] TRUE#>#> $...#> integer(0)# use functions for more controlca<-command_args(c("verbose","12-9-2022","12-10-2022"))ca$add_argument("verbose",action ="flag")ca$add_argument("...",convert =function(i)as.Date(i,"%m-%d-%Y"))ca$parse()#> $verbose#> [1] TRUE#>#> $...#> Date of length 0

You’ll probably use{scribe} within small scripts thatcan be called from your favorite terminal. The example below uses afunction to call this file, but if it is added to yourPATHyou’d be able to call it directly:

lines<-"#! /usr/bin/env -S Rscript --vanillalibrary(scribe)ca <- scribe::command_args()ca$add_argument('-a', default = 1)ca$add_argument('-b', default = 2)args <- ca$parse()foo <- function(a, b, ...) {  a + b}do.call(foo, args)"file<-tempfile()writeLines(lines, file)rscript<-function(x,args =character()) {  args<-c("--vanilla", x, args)  res<-system2("Rscript", args,stdout =TRUE)writeLines(res)}rscript(file)#> [1] 3rscript(file,"-a 0")#> [1] 2rscript(file,"-a 0 -b 10")#> [1] 10

Examples

I’ve been using{scribe} for some personal scripts.Below is a short list of some examples (mostly in myjmb repo):

Other packages

This isn’t the first package. Most contain other dependencies, someeven in different languages (e.g.,python).