Install packages from GitHub

Usage

installFromGitHub(
  repo,
  tag,
  branch,
  lib = .libPaths()[[1L]],
  reinstall = TRUE,
  ...
)

Arguments

repo: character. Repository address(es) in the format owner/repo.
tag: character or missing. Release version tag. Specific release must match the tag on GitHub (e.g. "v1.0.0"). Required except when branch is declared.
branch: character or missing. Branch name (e.g. "develop"). Can specify this instead of tag.
lib: character. Destination library directory path. Defaults to the first element of .libPaths().
reinstall: logical(1). Force reinstallation of any existing packages.
...: Passthrough arguments to install().

Value

Invisible list. Metadata containing repo, lib, and whether packages were installed.

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 2022-10-20.

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

Examples

## > testlib <- file.path(tempdir(), "testlib")
## > unlink(testlib, recursive = TRUE)
## > out <- installFromGitHub(
## >     repo = paste("acidgenomics", "r-goalie", sep = "/"),
## >     tag = "v0.5.2",
## >     dependencies = FALSE,
## >     lib = testlib,
## >     reinstall = TRUE
## > )
## > print(out)
## > sort(list.dirs(path = testlib, full.names = FALSE, recursive = FALSE))
## > unlink(testlib, recursive = TRUE)