Install packages from GitHub

installGitHub(repo, release = "latest", reinstall = TRUE)

Arguments

repo

character. Repository address(es) in the format owner/repo.

release

character. Release version tag. Defaults to latest version available. Specific release must match the tag on GitHub (e.g. "v1.0.0").

reinstall

logical(1). Force reinstallation of any existing packages.

Value

Invisible character. Repository address defined in repo argument.

Details

This variant doesn't require GITHUB_PAT. If you have a GITHUB_PAT defined, can use install() directly instead. Intended for use inside container images, where a PAT may not be used.

Note

Updated 2020-10-06.

GitHub API

  • All releases JSON: https://api.github.com/repos/:owner/:repo/releases

  • Latest release JSON: https://api.github.com/repos/:owner/:repo/releases/latest

  • Specific release JSON (requires numeric release ID, not tag name): https://api.github.com/repos/:owner/:repo/releases/:release_id

  • Specific tagged release tarball: https://github.com/:owner/:repo/archive/:tag.tar.gz

See also

Examples

## Install latest release, if necessary. ## > installGitHub( ## > repo = c( ## > "acidgenomics/goalie", ## > "acidgenomics/syntactic" ## > ), ## > release = "latest", ## > reinstall = FALSE ## > ) ## Force reinstallation of specific versions. ## > installGitHub( ## > repo = c( ## > "acidgenomics/goalie", ## > "acidgenomics/syntactic" ## > ), ## > release = c( ## > "v0.4.8", ## > "v0.4.2" ## > ), ## > reinstall = TRUE ## > )