checkout {renv} | R Documentation |
Checkout a repository
Description
renv::checkout()
can be used to retrieve the latest-availabe packages from
a (set of) package repositories.
Usage
checkout(
repos = NULL,
...,
packages = NULL,
date = NULL,
clean = FALSE,
actions = "restore",
project = NULL
)
Arguments
repos |
The R package repositories to use. |
... |
Unused arguments, reserved for future expansion. If any arguments
are matched to |
packages |
The packages to be installed. When |
date |
The snapshot date to use. When set, the associated snapshot as
available from the Posit's public
Package Manager instance will be
used. Ignored if |
clean |
Boolean; remove packages not recorded in the lockfile from
the target library? Use |
actions |
The action(s) to perform with the requested repositories.
This can either be "snapshot", in which |
project |
The project directory. If |
Details
renv::checkout()
is most useful with services like the Posit's
Package Manager, as it
can be used to switch between different repository snapshots within an
renv project. In this way, you can upgrade (or downgrade) all of the
packages used in a particular renv project to the package versions
provided by a particular snapshot.
If your library contains packages installed from other remote sources (e.g. GitHub), but a version of a package of the same name is provided by the repositories being checked out, then please be aware that the package will be replaced with the version provided by the requested repositories. This could be a concern if your project uses R packages from GitHub whose name matches that of an existing CRAN package, but is otherwise unrelated to the package on CRAN.
Examples
## Not run:
# check out packages from PPM using the date '2023-01-02'
renv::checkout(date = "2023-01-02")
# alternatively, supply the full repository path
renv::checkout(repos = "https://packagemanager.rstudio.com/cran/2023-01-02")
# only check out some subset of packages (and their recursive dependencies)
renv::checkout(packages = "dplyr", date = "2023-01-02")
## End(Not run)