Skip to content
rv docs

rv remove

Introduced in rv v0.18.0

Used to quickly remove packages from the config file, then sync.

rv remove matches packages in the dependencies field by name, regardless of whether they were declared as a simple dependency or with a more advanced table entry (git, path, url, etc.), and removes the matching entries from the config file.

Usage

Section titled “Usage”
Terminal window
rv remove [packages]... [OPTIONS]

Arguments

Section titled “Arguments”
  • packages - A list of package names to remove from the project, given as separate arguments (e.g. rv remove dplyr tidyr)

Options

Section titled “Options”
  • --dry-run - No changes made to the config or the package library, only reports what would happen if the command was run.
  • --no-sync - Packages are removed from the config file, but not synced.
  • --r-bin <PATH> - Use the R at that path instead of the one rv finds for the project. Its version has to match the project’s r_version, see overriding the R version Introduced in rv v0.23.0

Example

Section titled “Example”
Terminal window
% rv remove tibble
Removed 1 package from rproject.toml:
  - tibble

If none of the packages given are found in the config file, rv remove reports that nothing happened rather than erroring:

Terminal window
% rv remove not-a-dependency
No matching packages in rproject.toml. Nothing to remove.