hen 0.20.2

Run protocol-aware API request collections from the command line or through MCP.
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
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

use serde_json::Value;

use crate::{helpers::spawn_http_server, support::TestWorkspace};

#[test]
fn run_outputs_ndjson_report() {
    let server_url = spawn_http_server(
        200,
        "OK",
        "application/json",
        r#"{"ok":true,"service":"hen"}"#,
    );
    let workspace = TestWorkspace::new();
    workspace.write_file(
        "collection.hen",
        &format!(
            r#"NDJSON Fixture

Exercises streaming machine-readable output.

---

Fetch fixture

GET {server_url}

^ & body.ok == true
[ true == false ] ^ & body.service == 'hen'
"#
        ),
    );

    let output = workspace.run_hen(["run", "collection.hen", "--output", "ndjson"]);

    assert_eq!(output.status_code, 0, "stderr: {}", output.stderr);
    assert!(output.stderr.is_empty(), "stderr: {}", output.stderr);

    let lines = output
        .stdout
        .lines()
        .map(|line| serde_json::from_str::<Value>(line).expect("line should be valid json"))
        .collect::<Vec<_>>();

    assert_eq!(lines.len(), 4);
    assert_eq!(lines[0]["type"], "run");
    assert_eq!(lines[0]["interrupted"], false);
    assert_eq!(lines[0]["interruptSignal"], Value::Null);
    assert_eq!(lines[0]["traceCount"], 2);
    assert_eq!(lines[1]["type"], "record");
    assert_eq!(lines[1]["status"], 200);
    assert_eq!(lines[1]["assertions"][0]["status"], "passed");
    assert_eq!(lines[1]["assertions"][1]["status"], "skipped");
    assert_eq!(lines[2]["type"], "trace");
    assert_eq!(lines[2]["kind"], "started");
    assert_eq!(lines[3]["type"], "trace");
    assert_eq!(lines[3]["kind"], "completed");
}

#[test]
fn run_outputs_ndjson_report_for_schema_failures() {
    let server_url = spawn_http_server(
        200,
        "OK",
        "application/json",
        r#"[{"id":"550e8400-e29b-41d4-a716-446655440000"},{"id":"not-a-uuid"}]"#,
    );
    let workspace = TestWorkspace::new();
    workspace.write_file(
        "collection.hen",
        &format!(
            r#"schema User {{
  id: UUID
}}

schema Users = User[]

---

Schema NDJSON Failure Fixture

GET {server_url}

^ & body === Users
"#
        ),
    );

    let output = workspace.run_hen(["run", "collection.hen", "--output", "ndjson"]);

    assert_eq!(output.status_code, 1, "stderr: {}", output.stderr);
    assert!(output.stderr.is_empty(), "stderr: {}", output.stderr);

    let lines = output
        .stdout
        .lines()
        .map(|line| serde_json::from_str::<Value>(line).expect("line should be valid json"))
        .collect::<Vec<_>>();

    assert_eq!(lines.len(), 4);
    assert_eq!(lines[0]["type"], "run");
    assert_eq!(lines[0]["traceCount"], 2);
    assert_eq!(lines[1]["type"], "failure");
    assert_eq!(lines[2]["type"], "trace");
    assert_eq!(lines[2]["kind"], "started");
    assert_eq!(lines[3]["type"], "trace");
    assert_eq!(lines[3]["kind"], "failed");

    let mismatch = &lines[1]["assertions"][0]["mismatch"];

    assert_eq!(mismatch["kind"], "schema");
    assert_eq!(mismatch["reason"], "array_item_mismatch");
    assert_eq!(mismatch["target"], "Users");
    assert_eq!(mismatch["path"], "body[1].id");
    assert_eq!(mismatch["actualPath"], "body");
    assert_eq!(mismatch["operator"], "===");
    assert_eq!(mismatch["actual"]["type"], "string");
    assert_eq!(mismatch["actual"]["value"], "not-a-uuid");
    assert_eq!(mismatch["expected"]["type"], "format");
    assert_eq!(mismatch["expected"]["value"], "UUID");
}