[rv` 是以一种可重现、快速且声明式的方式管理和安装 R 包的新方法。

警告 rv 仍在开发中,可能没有完整的文档。 如需其他信息、问题或功能请求,请创建 issue 或直接联系我们。

工作原理

rv 有几个顶层命令,旨在为用户提供尽可能大的灵活性。 两个主要命令是:

rv plan # 详细说明如果运行 sync 会发生什么
rv sync # 同步 library、config 文件和 lock 文件

这些命令的后续操作由配置文件控制,该文件通过指定 R 版本、repositories 和项目使用的 dependencies 来指定所需的项目状态。 此外,还可以指定特定的 package 和 repository 级别的自定义设置。

例如,一个简单的配置文件:

[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}
]

运行 rv sync 将通过安装 dplyrggplot2、这些 package 需要的任何 dependencies 以及 ggplot2 的 suggested packages 来同步 library、lock 文件和配置文件。 运行 rv plan 将为您提供 rv sync 将要执行的操作的预览。

更多包含配置的示例项目可以在本仓库的 example_projects 目录中找到。

安装

有关如何安装 rv 的信息,请参阅 installation documentation

用法

有关如何使用 rv 以及如何使用 rproject.toml 文件 configure 它的信息,请参阅 usage documentation

贡献

开始使用

要开始开发 rv,您需要:

安装 Rust 后,您可以通过运行以下命令来构建项目:

just run <args>
// or
cargo run --features=cli --release -- ...

例如 just run syncjust run add --dry-run

如果您想将当前版本的项目作为二进制文件安装,您可以运行:

just install
// or
cargo install --path . --features cli

单元测试

使用以下命令运行单元测试:

just test
// or
cargo test --features=cli

快照测试

快照需要 R 版本 4.4.x。

关于

未提供描述、网站或主题。

资源

Readme

License

MIT license Activity Custom properties

Stars

37 stars

Watchers

3 watching

Forks

2 forks Report repository

Releases 15

v0.6.2 最新版 May 16, 2025 + 14 releases

Packages 0

未发布任何 package

Contributors 4

语言