lernie 0.1.60

lernie: the operator seat — the window and wire client for a yog server
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

//! **The one optional field on this surface**, asserted from both sides: the
//! gesture a stated route becomes, and the gesture an unstated one does not.

use serde_json::json;

use super::{ADDRESS, ENROLL, enroll};

/// **Unstated is UNSAID.** A route nobody gave writes no field — not `null`,
/// which the engine would then have to read as a second spelling of absence
/// (yog's codec says so from the other side: *"a null would be a second
/// spelling of the same absence"*). The bare gesture is byte-for-byte the one
/// an operator would have written by hand before the word existed.
#[test]
fn an_enrollment_that_states_no_route_carries_no_address_field() {
    let gesture = enroll(
        "ops".to_owned(),
        "box-1".to_owned(),
        "foot".to_owned(),
        None,
    );
    assert_eq!(
        gesture,
        json!({"op": "enroll", "workspace": "ops", "name": "box-1", "grade": "foot"})
    );
    assert_eq!(gesture.get(ADDRESS), None);
}

/// **A stated route rides as `address`** — REMOTE §8.4's own field name, which
/// is what the engine reads (`opt_str_of(o, "address")`), not the `--at` the
/// operator typed.
#[test]
fn a_stated_route_rides_the_gesture_under_the_wire_s_own_name() {
    let gesture = enroll(
        "ops".to_owned(),
        "box-1".to_owned(),
        "foot".to_owned(),
        Some("host.containers.internal:7773".to_owned()),
    );
    assert_eq!(
        gesture,
        json!({
            "op": "enroll",
            "workspace": "ops",
            "name": "box-1",
            "grade": "foot",
            "address": "host.containers.internal:7773",
        })
    );
}

/// The row is unchanged by the field: `address` is not a parameter, so the
/// three words are still the whole arity and the usage line still says so.
#[test]
fn the_optional_field_is_not_a_fourth_parameter() {
    assert_eq!(ENROLL.params, &["workspace", "name", "grade"]);
    assert_eq!(ENROLL.usage(), "lernie enroll <workspace> <name> <grade>");
}