keelrun-cli 0.3.0

The `keel` binary: run | init | doctor | status | explain. The product's face — every command has a byte-deterministic `--json` twin and stable exit codes (dx-spec §1–2, §5–6).
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
37
38

//! Guards the crate-local vendored contract copy against drift.
//!
//! The single source of truth stays `contracts/` at the repo root;
//! `src/explain.rs` / `src/init.rs` embed the crate-local copies in `contract/` so the crate is
//! self-contained when packaged (`cargo package` cannot ship files outside the
//! crate directory). In a workspace checkout both files exist and every build
//! asserts they are byte-identical; in a packaged crate the repo copy is
//! absent and the check is skipped. Refresh with `scripts/sync-vendored.sh`.

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

const VENDORED: &[(&str, &str)] = &[
    (
        "../../contracts/error-codes.json",
        "contract/error-codes.json",
    ),
    ("../../contracts/defaults.toml", "contract/defaults.toml"),
];

fn main() {
    for &(source, vendored) in VENDORED {
        println!("cargo::rerun-if-changed={vendored}");
        println!("cargo::rerun-if-changed={source}");
        let source = Path::new(source);
        if !source.exists() {
            continue; // packaged crate: no repo checkout around us
        }
        let want = fs::read(source).expect("read repo contract file");
        let got = fs::read(vendored).expect("read vendored contract copy");
        assert!(
            want == got,
            "vendored contract copy {vendored} is stale against {}; \
             run scripts/sync-vendored.sh to refresh it",
            source.display()
        );
    }
}