如何将版本信息从Vergen传递到StructOpt？

Question

我正在尝试设置一个简单的命令行界面程序在生锈，但我希望它显示的版本信息的基础上的git describe，而不是它是什么，它是Cargo.toml文件。

我设置了一些基本的依赖项：

[dependencies]
structopt = "0.3.13"

[build-dependencies]
vergen = "3.1.0"

build.rs文件使用vergen执行提升：

extern crate vergen;

use vergen::{ConstantsFlags, generate_cargo_keys};

fn main() {
    // Setup the flags, toggling off the 'SEMVER_FROM_CARGO_PKG' flag
    let mut flags = ConstantsFlags::all();
    flags.toggle(ConstantsFlags::SEMVER_FROM_CARGO_PKG);

    // Generate the 'cargo:' key output
    generate_cargo_keys(flags).expect("Unable to generate the cargo keys!");
}

结果是可以从我的main.rs中使用的一组环境变量：

fn main() {
    println!("Build SHA: {}", env!("VERGEN_SHA_SHORT"));
}

这将打印我从中构建的正确的git SHA。问题是我不知道如何让StruckOpt使用生成的版本。我本以为这样的东西会起作用：

use structopt::StructOpt;

/// A thing
#[derive(StructOpt)]
struct Cli {
    version: [ version = env!("VERGEN_SEMVER") ],
}

fn main() {
    let args = Cli::from_args();
    println!("Build SHA: {}", env!("VERGEN_SHA_SHORT"));
}

但是，天哪！尽管有这种语法being documented，但它在尝试构建时会抛出一个解析错误：

error: expected one of `!`, `(`, `+`, `::`, `;`, `<`, or `]`, found `=`
 --> src/main.rs:6:24
  |
6 |     version: [ version = env!("VERGEN_SEMVER") ],
  |                        ^ expected one of 7 possible tokens

怎么回事？如何使用StructOpt设置我的命令行界面，以便--version将报告vergen检测到的版本？

Answer 1

手册中的[version = "version"]符号意味着我们需要编写#[structopt(version = "version")]来指定版本号的字符串：

$ cat src/main.rs
use structopt::StructOpt;

#[derive(StructOpt)]
#[structopt(version = env!("VERGEN_SEMVER"))]
struct Cli {}

fn main() {
    let _cli = Cli::from_args();
}

$ env VERGEN_SEMVER=v1.2.3 cargo build
...

$ cargo run -- --version
    Finished dev [unoptimized + debuginfo] target(s) in 0.02s
     Running `target/debug/foo --version`
foo v1.2.3