So What Is It For?
#!/usr/bin/env r ## for use in scriptsother input| r## for use in pipesr somefile.R## for running filesr-e'expr'## for evaluating expressionsr--help## to show a quick synopsisExamples?
Plenty. See theexamplesvignette for a full set of introductory examples. Also see theexamples/directory for a full 28 example scripts, as well as maybe theoldertests directory both of which are installed with the package.
Some scripts I use daily or near daily (in alphabetical order):
build.r ## builds from the current directoryc4c.r ## submits current directory to winbuildercompAttr.r ## run compileAttributes() for a Rcpp packagedratInstert.r 1.2-3.tar.gz -r /srv ## inserts package into drat repoinstall.r abc def ## installs packages abc and definstall.r abc_1.2-3.tar.gz ## installs given tarballinstall2.r -l /tmp/lib abc def ## installs abc and def into /tmp/librcc.r abc_1.2-3.tar.gz ## run's R CMD check via Gabor's rcmdcheckrender.r foo.Rmd ## calls rmarkdown::render()roxy.r ## run roxygenize() for a package (only Rd creation)update.r ## updates any currently installed packagesInstallation
Version 0.3.0 or later
The package resides on the CRAN network and can be installed via
install.packages("littler")Previous Versions up to0.2.3
In general, simply running the scriptbootstrap willconfigure and build the executable. Runningmake install(possibly assudo make install) will install the resultingbinary.
On Linux systems, ensure you have theautotools-devpackage (or its equivalent on non-Debian/Ubuntu systems). On OS X, youmay need to runbrew install automake autoconf to get allthe tools.
Alternate Naming
On some operating systems such as OS X,r is notdifferent fromR. As this risks confusing the main binaryR for the R system with our smaller scripting frontendr, we suggest to consider runningconfigure --program-prefix="l" which this leads toinstallation of a binarylr instead ofr.
Alternate R Version
As littler uses autoconf itsAC_PATH_PROG() macro tofindR, one can simply adjust thePATH whencallingconfigure (or, rather,bootstrap) tohave another version of R used. For example, on a server with R-devel inthis location, the following builds littler using this R-devel version:PATH="/usr/local/lib/R-devel/bin/:$PATH" ./bootstrap.
More Information
For more information about littler, please see
(but note that the latter now overlaps with theexamplevignette).
Authors
Jeff Horner (2006 to 2008) and Dirk Eddelbuettel (since 2006)
License
GPL (>= 2)
Initially created: Sun Sep 25 14:16:18 CDT 2006
Last modified: Sun May 26 10:02:49 CDT 2024