amiss-wire 0.2.0

Canonical JSON, digest domains, and the machine contracts of Amiss
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

use amiss_wire::human::atom;

#[test]
fn printable_ascii_stays_literal_inside_quotes() {
    assert_eq!(atom("docs/guide.md"), "\"docs/guide.md\"");
    assert_eq!(atom(""), "\"\"");
    assert_eq!(atom("a b~!"), "\"a b~!\"");
}

#[test]
fn quote_and_backslash_escape_and_nothing_else_is_active() {
    assert_eq!(atom("a\"b"), "\"a\\\"b\"");
    assert_eq!(atom("a\\b"), "\"a\\\\b\"");
    assert_eq!(atom("a\nb\tc"), "\"a\\u000ab\\u0009c\"");
    assert_eq!(atom("\u{1b}[31m"), "\"\\u001b[31m\"", "ANSI is inert");
    assert_eq!(atom("\u{202e}"), "\"\\u202e\"", "bidi controls are inert");
}

#[test]
fn non_bmp_scalars_use_surrogate_pairs() {
    assert_eq!(atom("\u{1f600}"), "\"\\ud83d\\ude00\"");
    assert_eq!(atom("nav\u{e9}"), "\"nav\\u00e9\"");
}

#[test]
fn two_hundred_scalars_then_a_literal_ellipsis() {
    let long = "x".repeat(201);
    let rendered = atom(&long);
    assert_eq!(rendered.len(), 200 + 2 + 3);
    assert!(rendered.ends_with("...\""));
    let exact = "x".repeat(200);
    assert!(
        !atom(&exact).contains("..."),
        "exactly two hundred is not truncated"
    );

    let multibyte = "\u{e9}".repeat(201);
    let rendered = atom(&multibyte);
    assert!(rendered.ends_with("...\""));
    assert_eq!(
        rendered.matches("\\u00e9").count(),
        200,
        "the bound counts scalars"
    );
}

/// `human-atom-bytes-v1`: printable ASCII literal, every other byte the
/// two-digit escape of its value, never an invented scalar, truncation at
/// the same bound as text.
#[test]
fn byte_atoms_escape_every_nonprintable_byte_and_invent_nothing() {
    use amiss_wire::human::atom_bytes;
    assert_eq!(atom_bytes(b"docs/guide.md"), "\"docs/guide.md\"");
    assert_eq!(atom_bytes(b"bad-\xff.md"), "\"bad-\\u00ff.md\"");
    assert_eq!(atom_bytes(b"\x1b[31mred"), "\"\\u001b[31mred\"");
    assert_eq!(atom_bytes(b"a\"b\\c"), "\"a\\\"b\\\\c\"");
    let long = vec![0xfe_u8; 205];
    let rendered = atom_bytes(&long);
    assert!(rendered.ends_with("...\""));
    assert_eq!(rendered.matches("\\u00fe").count(), 200);
}