buup 0.25.5

Core transformation library with zero dependencies
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

use crate::{Transform, TransformError, TransformerCategory};

/// HTML encode transformer
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub struct HtmlEncode;

impl Transform for HtmlEncode {
    fn name(&self) -> &'static str {
        "HTML Encode"
    }

    fn id(&self) -> &'static str {
        "htmlencode"
    }

    fn description(&self) -> &'static str {
        "Encodes special HTML characters into their entity representation (e.g., < to &lt;)."
    }

    fn category(&self) -> TransformerCategory {
        TransformerCategory::Encoder
    }

    fn default_test_input(&self) -> &'static str {
        "<p>Hello & Welcome!</p>"
    }

    fn transform(&self, input: &str) -> Result<String, TransformError> {
        let mut result = String::with_capacity(input.len() * 2);

        for c in input.chars() {
            match c {
                '&' => result.push_str("&amp;"),
                '<' => result.push_str("&lt;"),
                '>' => result.push_str("&gt;"),
                '"' => result.push_str("&quot;"),
                '\'' => result.push_str("&#39;"),
                '/' => result.push_str("&#47;"),
                '`' => result.push_str("&#96;"),
                '=' => result.push_str("&#61;"),
                _ => result.push(c),
            }
        }

        Ok(result)
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_html_encode() {
        let encoder = HtmlEncode;
        assert_eq!(
            encoder.transform(encoder.default_test_input()).unwrap(),
            "&lt;p&gt;Hello &amp; Welcome!&lt;&#47;p&gt;"
        );
        assert_eq!(
            encoder.transform("No special chars").unwrap(),
            "No special chars"
        );
        assert_eq!(encoder.transform("").unwrap(), "");
    }
}