Need help with littler?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

eddelbuettel
253 Stars 47 Forks GNU General Public License v2.0 628 Commits 0 Opened issues

Description

A scripting and command-line front-end for GNU R

Services available

!
?

Need anything else?

Contributors list

# 22,564
R
TeX
rcpp
s3
487 commits
# 212,475
MySQL
R
Perl
Shell
56 commits
# 91,948
R
doi
r-packa...
aws-s3
12 commits
# 123,470
R
travis-...
PureScr...
ggplot2...
8 commits
# 105,353
R
nginx-p...
css-fra...
Bootstr...
3 commits
# 57,856
R
travis-...
text-ex...
pdf-fil...
2 commits
# 171,797
R
cran
Shell
Markdow...
2 commits
# 113,787
R
fedora
excel
Markdow...
2 commits
# 116,721
C++
xxhash
hash-fu...
Visual ...
2 commits
# 82,580
R
Shell
TeX
bookdow...
2 commits
# 162,289
R
TeX
r-packa...
Shell
1 commit
# 263,155
CSS
Zsh
powerli...
Bash
1 commit
# 127,917
TeX
Jupyter...
Haskell
pandoc
1 commit
# 12,345
node
Nim
csv-for...
D
1 commit

littler: A scripting and command-line front-end for GNU R

CI License CRAN Dependencies Downloads Last Commit Documentation

So What Is It For?

#!/usr/bin/env r              ## for use in scripts

other input | r ## for use in pipes

r somefile.R ## for running files

r -e 'expr' ## for evaluating expressions

r --help ## to show a quick synopsis

Examples?

Plenty. See the examples vignette for a full set of introductory examples. Also see the examples/ directory for a full 28 example scripts, as well as maybe the older tests 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 directory
c4c.r                                  ## submits current directory to winbuilder
compAttr.r                             ## run compileAttributes() for a Rcpp package
dratInstert.r 1.2-3.tar.gz -r /srv     ## inserts package into drat repo
install.r abc def                      ## installs packages abc and def
install.r abc_1.2-3.tar.gz             ## installs given tarball
install2.r -l /tmp/lib abc def         ## installs abc and def into /tmp/lib
rcc.r abc_1.2-3.tar.gz                 ## run's R CMD check via Gabor's rcmdcheck
render.r foo.Rmd                       ## calls rmarkdown::render()
roxy.r                                 ## run roxygenize() for a package (only Rd creation)
update.r                               ## updates any currently installed packages

Installation

Version 0.3.0 or later

The package resides on the CRAN network and can be installed via

install.packages("littler")

Previous Versions up to 0.2.3

In general, simply running the script

bootstrap
will configure and build the executable. Running
make install
(possibly as
sudo make install
) will install the resulting binary.

On Linux systems, ensure you have the

autotools-dev
package (or its equivalent on non-Debian/Ubuntu systems). On OS X, you may need to run
brew
install automake autoconf
to get all the tools.

Alternate Naming

On some operating systems such as OS X,

r
is not different from
R
. As this risks confusing the main binary
R
for the R system with our smaller scripting frontend
r
, we suggest to consider running
configure
--program-prefix="l"
which this leads to installation of a binary
lr
instead of
r
.

Alternate R Version

As littler uses autoconf its

AC_PATH_PROG()
macro to find
R
, one can simply adjust the
PATH
when calling
configure
(or, rather,
bootstrap
) to have another version of R used. For example, on a server with R-devel in this 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 the example vignette).

Authors

Jeff Horner (2006 to 2008) and Dirk Eddelbuettel (since 2006)

License

GPL (>= 2)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.