Package 'provisionr'

Something to coerce into an R version. Valid values are NULL (the current session's R version), a character string of the form x.y.z, a character string oldrel or release or a numeric_version object.

Character vector of packages to download

Destination

Target R version

Target platform (use "ALL" for all platforms)

Include suggested packages too?

A provisionr::package_sources object

Is a missing PACKAGES index an error? Set this to FALSE when downloading from incomplete repositories (e.g., a drat repo that contains only source files if you are trying to download binaries)

Control progress bar printing

A character vector of urls

A single existing directory to download files into

Currently ignored

A character vector of labels to use to describe the files being downloaded when printing (defaults to basename(urls))

Overwrite files that exist already? If FALSE (the default) then existing files are skipped.

Logical, indicating if a count of progress across the urls should be included.

If the files should be renamed as they are downloaded, include a vector of filenames here the same length as urls. Directory components will be created, within dest_dir.

Logical, indicating if file:/// urls should be copied into dest_dir

Print a progress bar?

Print a summary?

Named character vector of HTTP headers (optional)

A single URL for the CRAN repo to use. If NULL, then this will use the rstudio mirror.

A character vector of additional repositories to use. Repositories of the form drat://username will be translated to a drat repository hosted on github (e.g., https://username.github.io/drat)

A vector of github package specifications (e.g., username/password). The full syntax as implemented in parse_github_repo_spec is supported (packages in subdirectories, or referencing a particular branch, commit or tag).

A character vector of local files to include. Can be directories or built packages (source or binary)

Optional period, in days, to expire the local copy of the package. If specified, then if a package was downloaded more thanexpire days ago when the local copy is checked, a new version will be downloaded. Can be a fractional value (e.g., expire = 0.04 for an expiry of around an hour).

Optional location to cache downloaded packages, when github or local packages are used. If not given, this can be set at any time by setting the local_drat element of the returned element. If not given by the time that the packages need to be downloaded then a session-specific temporary directory will be used.

An object of class package_sources_list, created by running the as_list() method of a package_sources object. This is useful for serialisation without saving references to provisionr.

Raw entries of the form <type>::<user>/<repo>...

Library to provision

Path to the DESCRIPTION file

Additional arguments to provision_library

An optional description of additional packages, using package_sources.

Logical, indicating if the .travis.yml should be read (if present). If TRUE then packages listed within r_github_packages will be used in provisioning.

Should the bootstrap script install provisionr within the local library too?

A character vector of packages to include

A path to the library; if it does not exist, it will be created. If given as a vector of libraries (i.e., with more than one element) then packages will be installed into the first library, but subsequent libraries will be checked to make sure that dependencies are satisfied.

The platform to create the library for. If NULL then we build for the current platform (using install_packages if version is NULL or compatible with our current version). Otherwise this can be one of "windows", "macosx", "macosx/mavericks" or "linux", correspinding to the different directories that binaries live in (in the case of "linux" there are no binaries and things are a little more complicated).

The version of R to install packages for. By default, we use the same version (major.minor) as the current running R version. Otherwise provide the desired version number as a string or numeric_version object.

An optional description of additional packages, using package_sources. It will only be rebuilt (fetching packages) if it has never been built, or of packages listed in the spec element are not found in the repository.

Logical, indicating if dependencies of packges should be checked. If TRUE, then any missing dependencies (packages in Depends, Imports or LinkingTo of the requested packages) will be installed.

The behaviour when some packages are already installed. Options are "replace" (will re-install the package and, for cross-installation, its dependencies), "upgrade_all" (upgrade all packages that lag behind the versions in repositories), "upgrade" (upgrade packages listed in "packages" only, but not their dependencies) and "skip" (do not install or upgrade any package that is already installed).

For cross-installation (via cross_install when platform is non-NULL), allow packages to be missing that need to be compiled? The interface here is going to change a bunch, so watch out...

Logical indicating if the cache of packages pointed to by src should be refreshed. The other way of forcing this would be to pass expire = 0 through to the package_sources argument but this is likely to be tidier.

Passed through to to install.packages, indicating if package installation should be done quietly. With this as FALSE (the default) rather a lot of output can be generated.

Passed through to the package downloading to control printing of the progress bar.