nornir 0.4.34

Companion to cargo: dependency tracking, release gating, deploy, benchmarks, and documentation assembly. Project-agnostic.
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122

//! CLI-parity smoke tests for the dependency-graph (`mimir`) and viz-diagram
//! (`diagram`) subcommands added to bring the `nornir` CLI to parity with the
//! server's `Mimir`/`Viz` RPCs and the egui viz's `diagram.rs` renderers.
//!
//! These drive the real `nornir` binary's argument parser (`--help`), so a
//! regression that drops a subcommand or mis-wires clap fails here without
//! needing a warehouse fixture. `clap` also debug-asserts the whole command
//! tree while building `--help`, catching duplicate/ambiguous args.

use std::process::Command;

fn nornir() -> Command {
    Command::new(env!("CARGO_BIN_EXE_nornir"))
}

fn stdout_of(args: &[&str]) -> String {
    let out = nornir().args(args).output().expect("run nornir");
    assert!(
        out.status.success(),
        "`nornir {}` failed: {}",
        args.join(" "),
        String::from_utf8_lossy(&out.stderr)
    );
    String::from_utf8_lossy(&out.stdout).into_owned()
}

#[test]
fn mimir_is_registered_with_every_op() {
    let help = stdout_of(&["mimir", "--help"]);
    for sub in [
        "deps-of",
        "dependents-of",
        "affected",
        "build-order",
        "dep-path",
        "external-users",
        "svg",
        "overview",
        "changed",
    ] {
        assert!(help.contains(sub), "`mimir --help` missing subcommand `{sub}`:\n{help}");
    }
}

#[test]
fn diagram_is_registered_with_every_renderer() {
    let help = stdout_of(&["diagram", "--help"]);
    for sub in [
        "timeline",
        "lane-summary",
        "depgraph",
        "snapshot-edges",
        "gate-matrix",
        "release-versions",
        "bench-history",
        "bench-compare",
    ] {
        assert!(help.contains(sub), "`diagram --help` missing renderer `{sub}`:\n{help}");
    }
}

#[test]
fn top_level_lists_new_commands() {
    let help = stdout_of(&["--help"]);
    assert!(help.contains("mimir"), "top-level help missing `mimir`:\n{help}");
    assert!(help.contains("diagram"), "top-level help missing `diagram`:\n{help}");
}

#[test]
fn mimir_deps_of_accepts_transitive_flag() {
    // Parse-only: `--help` on the leaf op asserts the flag exists.
    let help = stdout_of(&["mimir", "deps-of", "--help"]);
    assert!(help.contains("--transitive"), "deps-of missing --transitive:\n{help}");
}

#[test]
fn server_and_token_are_global_thin_client_flags() {
    // Advertised at the top level...
    let top = stdout_of(&["--help"]);
    assert!(top.contains("--server"), "top-level --help must advertise --server:\n{top}");
    assert!(top.contains("--token"), "top-level --help must advertise --token:\n{top}");
    // ...and reachable on a subcommand (global), so `nornir test run … --server …`
    // routes that command to the server (the thin-client UX).
    let sub = stdout_of(&["test", "run", "--help"]);
    assert!(sub.contains("--server"), "`test run --help` must show the global --server:\n{sub}");
    assert!(sub.contains("--token"), "`test run --help` must show the global --token:\n{sub}");
}

#[test]
fn mirror_to_holger_exposes_renamed_holger_token() {
    // Renamed off `--token` so it no longer collides with the global bearer flag.
    let help = stdout_of(&["release", "mirror-to-holger", "--help"]);
    assert!(help.contains("--holger-token"), "mirror-to-holger must expose --holger-token:\n{help}");
}

#[test]
fn workspace_populate_verb_is_registered() {
    // The `populate` verb (force fetch + republish) must be on `workspace`.
    let help = stdout_of(&["workspace", "--help"]);
    assert!(help.contains("populate"), "`workspace --help` must list `populate`:\n{help}");
    // And it parses with a name (clap debug-asserts the leaf command tree).
    let leaf = stdout_of(&["workspace", "populate", "--help"]);
    assert!(leaf.contains("name") || leaf.contains("NAME"), "`workspace populate` takes a name:\n{leaf}");
}

#[test]
fn workspace_is_a_global_flag_on_subcommands() {
    // Global `--workspace` reaches subcommands (incl. ones that used to own a
    // local `--workspace`), so a thin client can target a workspace by name.
    for cmd in [
        &["test", "run", "--help"][..],
        &["release", "run", "--help"][..],
        &["diagram", "timeline", "--help"][..],
    ] {
        let help = stdout_of(cmd);
        assert!(
            help.contains("--workspace"),
            "`{}` must show the global --workspace:\n{help}",
            cmd.join(" ")
        );
    }
}