rv plan

rv plan will show you what sync would do, without syncing anything. This is useful to see how the changes to the configuration file will impact your project before performing any action.

Usage

rv plan [OPTIONS]

Options

• --r-version - Specify an R version different than the one in the config. This allows you to see what would occur if the project was changed to a different R version. The R version does not need to be on the system
• --upgrade - The same as rv upgrade --dry-run
• --locked - Fail instead of reporting a plan that would update the lockfile. Conflicts with --upgrade. Intended for the same CI/reproducibility use case as rv sync --locked. Introduced in rv v0.22.0

Example

In this example, we start out with tibble installed and want to install the dev version of dplyr from GitHub.

rproject.toml

[project]
name = "example"
r_version = "4.4"

repositories = [
    { alias = "PPM", url = "https://packagemanager.posit.co/cran/latest" },
]

dependencies = [
    "tibble",
    { name = "dplyr", git = "https://github.com/tidyverse/dplyr", branch = "main" },
]

The plan will then show us how the project library would change:

% rv plan
+ dplyr (1.1.4.9000, source from https://github.com/tidyverse/dplyr (branch: main))
+ generics (0.1.4, binary from https://packagemanager.posit.co/cran/latest)
+ R6 (2.6.1, binary from https://packagemanager.posit.co/cran/latest)
+ tidyselect (1.2.1, binary from https://packagemanager.posit.co/cran/latest)
+ withr (3.0.2, binary from https://packagemanager.posit.co/cran/latest)