rv is a new way to manage and install your R packages in a reproducible, fast, and declaritive way.
Warning
rv is still in development and may not be fully documented. For additional information, issues, or feature requests, please create an issue or contact us directly.
rv has several top level commands to provide the user with as much flexibility as possible. The two primary commands are:
rv plan # detail what will occur if sync is run
rv sync # synchronize the library, config file, and lock file
The subsequent actions of these commands are controlled by a configuration file that specifies a desired project state by specifying the R version, repositories, and dependencies the project uses. Additionally, specific package and repository level customizations can be specified.
For example, a simple configuration file:
[project]
name = "my first rv project"
r_version = "4.4"
# any repositories, order matters
repositories = [
{ alias = "PPM", url = "https://packagemanager.posit.co/cran/latest" },
]
# top level packages to install
dependencies = [
"dplyr",
{ name = "ggplot2", install_suggestions = true}
]Running rv sync will synchronize the library, lock file, and configuration file by installing dplyr, ggplot2, any dependencies those packages require, and the suggested packages for ggplot2. Running rv plan will give you a preview of what rv sync will do.
Additional example projects with more configurations can be found in the `example_projects' directory of this repository
See the installation documentation for information on how to install rv.
To upgrade packages to be the latest versions available from the sources listed, use rv upgrade. If you'd like to see what will occur when you were to upgrade, run rv upgrade --dry-run or rv plan --upgrade.
Snapshots require R version 4.4.x.
See the usage documentation for information on how to use rv.