metop 0.4.0

Linux memory analysis TUI: RSS/PSS/USS per process, VMA drill-down
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
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

//! CLI surface: version, help, and rejection of unknown arguments.

use std::process::Command;

fn run(args: &[&str]) -> std::process::Output {
    Command::new(env!("CARGO_BIN_EXE_metop"))
        .args(args)
        .output()
        .expect("spawn metop")
}

#[test]
fn version_reports_the_package_version() {
    let out = run(&["--version"]);
    assert!(out.status.success());
    let text = String::from_utf8_lossy(&out.stdout);
    assert!(
        text.contains(env!("CARGO_PKG_VERSION")),
        "version mismatch: {text}"
    );
    assert!(text.starts_with("metop "), "unexpected format: {text}");

    // -V is the conventional short form.
    let short = run(&["-V"]);
    assert!(short.status.success());
    assert_eq!(short.stdout, out.stdout);
}

#[test]
fn help_lists_the_interfaces_we_actually_have() {
    let out = run(&["--help"]);
    assert!(out.status.success());
    let text = String::from_utf8_lossy(&out.stdout);
    for needle in [
        "--json",
        "--diff",
        "--min-delta",
        "--pid",
        "--theme",
        "gruvbox-dark, kanagawa-wave, light, ansi16",
        "--color",
        "auto, truecolor, 256, 16",
        "--lang",
        "auto, en, zh",
        "USAGE",
    ] {
        assert!(text.contains(needle), "help missing {needle}:\n{text}");
    }
}

#[test]
fn unknown_theme_is_a_usage_error() {
    let out = run(&["--theme", "solarized"]);
    assert_eq!(out.status.code(), Some(2));
    let err = String::from_utf8_lossy(&out.stderr);
    assert!(err.contains("unknown theme"), "stderr: {err}");
    assert!(err.contains("ansi16"), "stderr should list themes: {err}");

    let missing = run(&["--theme"]);
    assert_eq!(missing.status.code(), Some(2));
}

#[test]
fn unknown_language_is_a_usage_error() {
    let out = run(&["--lang", "fr"]);
    assert_eq!(out.status.code(), Some(2));
    let err = String::from_utf8_lossy(&out.stderr);
    assert!(err.contains("auto, en, zh"), "stderr: {err}");

    let ok = run(&["--lang", "zh", "--version"]);
    assert!(ok.status.success());
}

#[test]
fn unknown_colour_mode_is_a_usage_error() {
    let out = run(&["--color", "512"]);
    assert_eq!(out.status.code(), Some(2));
    let err = String::from_utf8_lossy(&out.stderr);
    assert!(err.contains("auto, truecolor, 256, 16"), "stderr: {err}");

    // Valid modes parse even when no TUI is started.
    let ok = run(&["--color", "256", "--version"]);
    assert!(ok.status.success());
}

#[test]
fn unknown_arguments_exit_with_usage_error() {
    let out = run(&["--nope"]);
    assert_eq!(out.status.code(), Some(2));
    assert!(String::from_utf8_lossy(&out.stderr).contains("unknown argument"));
}