party - 运行一系列命令

party 是一个最小的命令运行器，旨在自动化运行重复的命令序列（通常在开发期间）。

它设计用于按顺序或并行运行一组默认或用户定义的命令。

安装

cargo install --locked party

如何运行

使用默认命令的 party

party run

默认情况下，party run 将按顺序运行以下命令：

1. cargofmt
2. cargoclippy ---Dwarnings
3. cargotest

运行自定义 party

party 将在项目中查找一个 party.toml 文件（或者在运行时通过 -f 指定）。为了简化，下面的命令将在当前目录下创建一个包含默认命令的 party.toml 文件。

party init

这将在本地生成 party.toml

[[tasks]]
command = ["cargo", "fmt"]

[[tasks]]
command = ["cargo", "clippy", "--", "-Dwarnings"]

[[tasks]]
command = ["cargo", "test"]

一旦文件就绪，调用 party run 将运行您的自定义命令序列！要运行单个命令，请使用 party run -i [COMMAND_NUMBER]。

验证命令 party 是否正确

要验证配置文件是否正确或仅检查将运行哪些命令，可以运行以下命令生成摘要：

party info

运行并行 party

有时命令是独立的，可以并行运行以节省一些时间。通过配置中的 parallel 标志，party 允许这样做。

在下面的示例中，第二个和第三个命令是独立的，并将 parallel 标志设置为 true。如果缺少该标志，则认为是 false。

[[tasks]]
command = ["cargo", "fmt"]

[[tasks]]
command = ["cargo", "clippy", "--", "-Dwarnings"]
parallel = true

[[tasks]]
command = ["cargo", "test"]
parallel = true

[[tasks]]
command = ["cat", "results.txt"]

配置中并行化的命令在 party info 中有一个 [P] 标签。

[ ][1/4]: cargo fmt
[P][2/4]: cargo clippy -- -Dwarnings
[P][3/4]: cargo test
[ ][4/4]: cat results.txt

为了简化，party 按以下方式将命令分组到子 party 中：

• 未设置 parallel 标志的命令将在其自己的批次中运行。
• 所有标记为true的连续命令将被合并到一起
• 下一个标记为false的命令将在自己的批次中运行

使用party batch来验证这一点

4 tasks will be run in 3 batches. All tasks in a batch are run in parallel.
Batch [1/3] with 1 commands:
  - cargo fmt
Batch [2/3] with 2 commands:
  - cargo clippy -- -Dwarnings
  - cargo test
Batch [3/3] with 1 commands:
  - cat results.txt

有关更多信息，请运行party help，或party [COMMAND] --help。