rama-http 0.3.0-rc1

rama http layers, services and other utilities
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

//! `escape` / `escape_into` are public helpers — exercise them so that
//! the publicly documented surface keeps working.

use std::borrow::Cow;

use crate::protocols::html::{IntoHtml, decode_entities, end, escape, escape_into, marker, start};

#[test]
fn decode_entities_named_and_numeric() {
    assert_eq!(
        decode_entities("tom & jerry — © ©"),
        "tom & jerry — © ©"
    );
}

#[test]
fn decode_entities_borrows_and_leaves_unknown() {
    assert!(matches!(decode_entities("no entities"), Cow::Borrowed(_)));
    // Unknown names and out-of-range numerics stay verbatim.
    assert_eq!(
        decode_entities("a &bogus; b � c"),
        "a &bogus; b � c"
    );
}

#[test]
fn escape_returns_owned_when_needed() {
    assert_eq!(escape("a<b&c"), "a&lt;b&amp;c");
    assert!(matches!(escape("a<b&c"), Cow::Owned(_)));
}

#[test]
fn escape_borrows_when_no_escape_needed() {
    let input = "alphanumeric-and_safe.0";
    let out = escape(input);
    assert_eq!(out, input);
    // Borrowed Cow points at the same buffer — verify with pointer identity.
    match out {
        Cow::Borrowed(s) => assert_eq!(s.as_ptr(), input.as_ptr()),
        Cow::Owned(_) => panic!("escape allocated for already-safe input"),
    }
}

#[test]
fn escape_into_appends_to_existing_buffer() {
    let mut buf = String::from("[");
    escape_into(&mut buf, "a<b");
    buf.push(']');
    assert_eq!(buf, "[a&lt;b]");
}

#[test]
fn escape_single_quote_for_attribute_context() {
    // Defends single-quoted attribute interpolation, e.g. <input value='…'>.
    assert_eq!(escape("a'b"), "a&#x27;b");
    assert_eq!(
        escape("' onmouseover='alert(1)"),
        "&#x27; onmouseover=&#x27;alert(1)"
    );
}

#[test]
fn escape_all_html_specials() {
    assert_eq!(escape("&<>\"'"), "&amp;&lt;&gt;&quot;&#x27;");
}

#[test]
fn marker_emits_processing_instruction() {
    assert_eq!(marker("cart").into_string(), r#"<?marker name="cart">"#);
    assert_eq!(
        marker("herd_42-a").into_string(),
        r#"<?marker name="herd_42-a">"#
    );
}

#[test]
fn marker_escapes_unsafe_chars() {
    assert_eq!(
        marker(r#"a"<&>b"#).into_string(),
        r#"<?marker name="a&quot;&lt;&amp;&gt;b">"#
    );
    assert_eq!(
        marker(String::from(" with space ")).into_string(),
        r#"<?marker name=" with space ">"#
    );
}

#[test]
fn start_end_emit_processing_instructions() {
    assert_eq!(start("cart").into_string(), r#"<?start name="cart">"#);
    assert_eq!(end().into_string(), r#"<?end>"#);
}

#[test]
fn start_escapes_unsafe_chars() {
    assert_eq!(
        start(r#"a"<&>b"#).into_string(),
        r#"<?start name="a&quot;&lt;&amp;&gt;b">"#
    );
}