conan: Conan the Librarian

In mrc-ide/conan: Conan the Librarian

Conan the Librarian

Description

High-level conan interface. This function creates a standalone script that can provision a library at any location. The script has no dependencies and can be copied to another system and create a library given an empty R installation.

Usage

conan(
  filename,
  packages,
  repos = NULL,
  policy = "upgrade",
  cran = NULL,
  dryrun = FALSE
)

Arguments

filename	Path to write the install script to. Any directory components will be created as needed.
packages	A character vector of packages to install. These can be names of CRAN packages or GitHub references etc; see pkgdepends::new_pkg_installation_proposal() for more details
repos	A character vector of repositories to use when installing. A suitable CRAN repo will be added if not detected (using the cran argument if provided)
policy	Should be either "lazy" or "upgrade", with a default of "upgrade"
cran	Fallback CRAN repo to use. If not given we will use ⁠https://cloud.r-project.org⁠
dryrun	Logical, indicating if we should try a dryrun with conan_dryrun(); if this passes your requested packages seem satisfiable.

Value

Invisibly, the path to the created script. This can be run via Rscript to create a standalone library. The script will require exactly one argument: the path to the library to create. It will respond to the environment variables CONAN_PATH_BOOTSTRAP and CONAN_PATH_CACHE.

Examples

path <- conan::conan(tempfile(), "cpp11")
writeLines(tail(readLines(path)))

mrc-ide/conan documentation built on Nov. 14, 2023, 6:23 p.m.