rv rv is a new way to manage and install your R packages in a reproducible, fast, and declarative way. Documentation Site Documentation sit…
rv rv is a new way to manage and install your R packages in a reproducible, fast, and declarative way. Documentation Site Documentation sit…
rv is a new way to manage and install your R packages in a reproducible, fast, and declarative way.
Documentation site with examples, cookbooks, and more detailed instructions available at: https://a2-ai.github.io/rv-docs/
curl -sSL https://raw.githubusercontent.com/A2-ai/rv/refs/heads/main/scripts/install.sh | bash
rv --versionrv 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 fileThe 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 documentation site for installation instructions.
See the documentation site for usage guides and configuration reference.
To get started with the development of rv, you'll need:
After installing Rust, you can build the project by running:
just run
// or
cargo run --features=cli --release -- ...e.g. just run sync or just run add --dry-run.
If you'd like to install the current version of the project as a binary, you can run:
just install
// or
cargo install --path . --features cliRun the unit tests with:
just test
// or
cargo test --features=cliSnapshots require R version 4.5 (see .github/workflows/ci.yaml for current CI version).
No open issues yet, or sync has not completed.