Cargo 版本控制系统扩展

Cargo-vcs 是一个 Cargo 扩展，它增加了版本控制助手以帮助管理工作区成员。

示例用例

查看工作区成员的当前分支和 MSRV 状态

• cargo vcs status - 简要概述
• cargo vcs status -v - 详细视图

$ cargo vcs status
Workspace is set to profile: new [.../rust/embedded] MSRV: 1.59.0

** Projects with uncommitted changes **

redv: refs/heads/e-h-1.0.0-alpha.7 [.../rust/embedded/apps/redv]
└── [CHANGES]
    └── src/main.rs

e310x-hal: refs/heads/e-h-1.0.0-alpha.7 [.../rust/embedded/e310/e310x-hal]
└── [CHANGES]
    ├── src/spi/bus.rs
    └── src/spi/config.rs

切换到工作区成员的分支或提交

• cargo vcs checkout master - 在所有工作区成员上切换到 master
• cargo vcs checkout master -m member1, member2 - 只在特定成员上切换

$ cargo vcs checkout master
redv set to refs/heads/master
embedded-hal set to refs/heads/master
e310x set to refs/heads/master
e310x-hal set to refs/heads/master
hifive1 set to refs/heads/master
riscv set to refs/heads/master
riscv-rt set to refs/heads/master
mipidsi set to refs/heads/master

使用配置文件

• cargo vcs profile save profile1 - 在名称 profile1 下保存每个工作区成员的当前仓库状态
• cargo vcs profile set profile1 - 将所有工作区成员仓库切换到 profile1 中保存的状态

$ cargo vcs profile set new
redv set to refs/heads/e-h-1.0.0-alpha.7
embedded-hal set to refs/tags/v1.0.0-alpha.7
e310x set to refs/heads/e-h-1.0.0-alpha.7
e310x-hal set to refs/heads/e-h-1.0.0-alpha.7
hifive1 set to refs/heads/v0.11.0-alpha.1
riscv set to refs/heads/e-h-1.0.0-alpha.7
riscv-rt set to refs/heads/e-h-1.0.0-alpha.7
mipidsi set to refs/heads/v0.3.0-alpha.1

导航到特定工作区成员

• $cd$(cargovcs dir member1)

配置文件

配置文件保存在工作区根目录下，名为 Cargo_vcs.toml。可以手动编辑，但使用 cargo vcs profile save <profile_name> 是首选方法，因为它将短名称解析为完整的仓库引用路径。

[vcs.<profile_name>]
<project_name> = "<git_reference>"
...