ghit v0.2.18

0

Monthly downloads

0th

Percentile

Lightweight GitHub Package Installer

A lightweight, vectorized drop-in replacement for 'devtools::install_github()' that uses native git and R methods to clone and install a package from GitHub. From v0.2.15, also includes an analogue for 'install_bitbucket()'.

Readme

ghit: Lightweight GitHub Package Installer

ghit provides a lightweight alternative to devtools::install_github() that uses git2r and the native R package management functionality to install R packages hosted on GitHub. At present, devtools::install_github() provides the most convenient way to install development versions of R packages, but devtools has 16 direct package dependencies and is therefore a quite heavy duty package to load simply to install packages.

ghit is therefore a simpler alternative to perform the single task of installing GitHub packages without the rest of devtools. It achieves this by using git2r to pull GitHub packages (including those requiring authentication), and relying on native R tools for building packages, storing those packages in a local and disposable CRAN-like repository, and installing them (and their dependencies) with install.packages(). From v0.2.15, an install_bitbucket() installer is also provided.

Package Functionality

Like devtools::install_github(), ghit::install_github() is a vectorized package installer that is extremely flexible:

library("ghit")
tmp <- file.path(tempdir(), "tmplib")
dir.create(tmp)
on.exit(unlink(tmp))

# single package
install_github("hadley/devtools", lib = tmp)

# multiple packages
install_github(c("hadley/devtools", "cloudyr/travisci"), lib = tmp)

# package in subdirectory
install_github("pablobarbera/twitter_ideology/pkg/tweetscores", lib = tmp)

# package in misnamed repository
install_github("klutometis/roxygen", lib = tmp)

# package at a given commit
install_github("leeper/rio@a8d0fca27", lib = tmp)

# package from a pull request
install_github("cloudyr/ghit#13", lib = tmp)

# package from a branch
install_github("kbenoit/quanteda[dev]", lib = tmp)

Note that branch names, commits, and subdirectories can be placed in essentially any order as long as the proper notation is followed.

Profiling

ghit is similarly efficient to devtools::install_github(), but is much less verbose by default:

> system.time(ghit::install_github("cloudyr/ghit"))
   user  system elapsed 
   0.92    0.29    4.64

> system.time(devtools::install_github("cloudyr/ghit"))
Downloading GitHub repo cloudyr/ghit@master
Installing ghit
"C:/PROGRA~1/R/R-32~1.3/bin/x64/R" --no-site-file --no-environ --no-save --no-restore CMD INSTALL  \
  "C:/Users/Thomas/AppData/Local/Temp/RtmpGGraeG/devtools1b6459fa28a1/cloudyr-ghit-45ac056" --library="C:/Program Files/R/R-3.2.3/library"  \
  --install-tests 

* installing *source* package 'ghit' ...
** R
** inst
** tests
** preparing package for lazy loading
** help
*** installing help indices
** building package indices
** testing if installed package can be loaded
*** arch - i386
*** arch - x64
* DONE (ghit)
   user  system elapsed 
   1.16    0.12    4.36

Package Installation

CRAN Version Downloads Travis-CI Build Status Appveyor Build status codecov.io

The package is available on CRAN and can be installed directly in R using:

install.packages("ghit")

The latest development version on GitHub can be installed using itself:

ghit::install_github("cloudyr/ghit")

Functions in ghit

Name Description
ghit Lightweight GitHub Package Installer
install_bitbucket Install R package from Bitbucket
install_github Install R package from GitHub
No Results!

Last month downloads

Details

Type Package
Date 2017-06-25
License MIT + file LICENSE
URL https://github.com/cloudyr/ghit
BugReports https://github.com/cloudyr/ghit/issues
RoxygenNote 6.0.1
NeedsCompilation no
Packaged 2017-06-27 14:55:54 UTC; THOMAS
Repository CRAN
Date/Publication 2017-06-27 15:50:08 UTC

Include our badge in your README

[![Rdoc](http://www.rdocumentation.org/badges/version/ghit)](http://www.rdocumentation.org/packages/ghit)