packrat (version 0.4.7)

init: Initialize Packrat on a new or existing Rproject

Description

Given a project directory, makes a new packrat project in the directory.

Usage

init(project = ".", options = NULL, enter = TRUE, restart = enter)

Arguments

project

The directory that contains the Rproject.

options

An Rlist of options, as specified in packrat-options.

enter

Boolean, enter packrat mode for this project after finishing a init?

restart

If TRUE, restart the R session after init.

Details

init works as follows:

1. Application dependencies are computed by examining theRcode throughout the project forlibraryandrequirecalls.
2. A snapshot is taken of the version of each package currently used by the project as described insnapshot, and each package's sources are downloaded.
3. A private library is created in the directory.
4. The snapshot is applied to the directory as described inrestore.

When init is finished, all the packages on which the project depends are installed in a new, private library located inside the project directory.

You must restart your Rsession in the given project directory after running init in order for the changes to take effect!

When Ris started in the directory, it will use the new, private library. Calls to require and library will load packages from the private library (except for 'base' or 'recommended' Rpackages, which are found in the system library), and functions such as install.packages will modify that private library. You can sync this private library with packrat using snapshot and restore.

See Also

packrat for a description of the files created by init.

Examples

## initialize a project using a local repository of packages
packrat::init(options = list(local.repos = "~/projects/R"))