standout 7.6.3

Styled CLI template rendering with automatic terminal detection
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

use clap::Command;
use insta::{assert_json_snapshot, assert_snapshot};
use serde_json::json;
use standout::cli::{App, Output};
use standout::OutputMode;

#[test]
fn test_snapshots_term_output() {
    let app = App::builder()
        .command(
            "list",
            |_m, _ctx| {
                Ok(Output::Render(json!({
                    "items": ["apple", "banana", "cherry"],
                    "count": 3
                })))
            },
            "Items: {{ items }}\nCount: {{ count }}",
        )
        .unwrap()
        .build()
        .unwrap();

    let cmd = Command::new("app").subcommand(Command::new("list"));
    let matches = cmd.try_get_matches_from(["app", "list"]).unwrap();

    let result = app.dispatch(matches, OutputMode::Term);
    let output = result.output().unwrap();

    assert_snapshot!("term_list_output", output);
}

#[test]
fn test_snapshots_json_output() {
    let app = App::builder()
        .command(
            "list",
            |_m, _ctx| {
                Ok(Output::Render(json!({
                    "items": ["apple", "banana", "cherry"],
                    "count": 3
                })))
            },
            "Items: {{ items }}\nCount: {{ count }}",
        )
        .unwrap()
        .build()
        .unwrap();

    let cmd = Command::new("app").subcommand(Command::new("list"));
    let matches = cmd.try_get_matches_from(["app", "list"]).unwrap();

    let result = app.dispatch(matches, OutputMode::Json);
    let output = result.output().unwrap();

    // Use assert_json_snapshot for semantic comparison
    // This normalizes key ordering, preventing spurious failures across platforms
    let json_value: serde_json::Value = serde_json::from_str(output).unwrap();
    assert_json_snapshot!("json_list_output", json_value);
}

#[test]
fn test_snapshots_error_handling() {
    let app = App::builder()
        .command(
            "fail",
            |_m, _ctx| -> standout::cli::HandlerResult<()> {
                Err(anyhow::anyhow!("Critical failure in operation"))
            },
            "",
        )
        .unwrap()
        .build()
        .unwrap();

    let cmd = Command::new("app").subcommand(Command::new("fail"));
    let matches = cmd.try_get_matches_from(["app", "fail"]).unwrap();

    let result = app.dispatch(matches, OutputMode::Term);

    // Handler errors surface as RunResult::Error("Error: {message}").
    // Consumers should write this to stderr and exit non-zero.
    assert!(
        result.is_error(),
        "expected RunResult::Error, got {:?}",
        result
    );
    let output = result.error().unwrap();
    assert_snapshot!("error_output", output);
}