mkit-cli 0.3.0

The mkit command-line tool: a content-addressed VCS with native attestation support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

//! Build-time invariant: `cli::CLI_VERSION` MUST equal `CARGO_PKG_VERSION`.
//!
//! We source-grep `src/cli.rs` for the expected literal. The Rust
//! version is authored as `pub const CLI_VERSION: &str = env!("CARGO_PKG_VERSION");`
//! today — which makes the invariant automatic — but if a future
//! refactor ever inlines the version string literally, this gate makes
//! sure the byte-exact Homebrew contract (`mkit <X.Y.Z>\n`) cannot
//! silently desync.

use std::fs;
use std::path::Path;

fn main() {
    let cli_path = Path::new("src").join("cli.rs");
    println!("cargo:rerun-if-changed={}", cli_path.display());
    println!("cargo:rerun-if-changed=Cargo.toml");

    let src = fs::read_to_string(&cli_path).expect("src/cli.rs must exist");
    let version = std::env::var("CARGO_PKG_VERSION").expect("CARGO_PKG_VERSION set by cargo");

    // Two accepted shapes. One keeps the invariant automatic via env!;
    // the other lets a future refactor inline a string literal without
    // breaking the Homebrew contract.
    let env_shape = r#"pub const CLI_VERSION: &str = env!("CARGO_PKG_VERSION");"#;
    let literal_shape = format!(r#"pub const CLI_VERSION: &str = "{version}";"#);

    if src.contains(env_shape) || src.contains(&literal_shape) {
        return;
    }
    panic!(
        "CLI_VERSION in src/cli.rs does not match Cargo.toml package.version ({version}).\n\
         Update src/cli.rs to either:\n\
         - `pub const CLI_VERSION: &str = env!(\"CARGO_PKG_VERSION\");`  (preferred)\n\
         - `pub const CLI_VERSION: &str = \"{version}\";`               (literal)"
    );
}