hypo 0.1.0

tiny crate that renders html through macros
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

/// what can be rendered to html
pub trait Render {
    fn render(&self, to: &mut String);
}

impl Render for char {
    fn render(&self, to: &mut String) {
        crate::escape::char(*self, to);
    }
}

impl Render for &str {
    fn render(&self, to: &mut String) {
        crate::escape::str(self, to);
    }
}

impl Render for String {
    fn render(&self, to: &mut String) {
        crate::escape::str(self, to);
    }
}

macro_rules! impl_for_numbers {
    ($($number:ty)+) => {$(
        impl Render for $number {
            fn render(&self, to: &mut String) {
                #[cfg(feature = "perf")]
                itoap::write_to_string(to, *self);
                #[cfg(not(feature = "perf"))]
                to.push_str(&self.to_string());
            }
        }
    )*};
}

impl_for_numbers!(u8 i8 u16 i16 u32 i32 u64 i64 u128 i128 usize isize);

impl<R: Render> Render for Option<R> {
    fn render(&self, to: &mut String) {
        if let Some(r) = self {
            r.render(to);
        }
    }
}

impl<R1: Render, R2: Render> Render for Result<R1, R2> {
    fn render(&self, to: &mut String) {
        match self {
            Ok(r) => r.render(to),
            Err(r) => r.render(to),
        }
    }
}

impl<R: Render> Render for &[R] {
    fn render(&self, to: &mut String) {
        for r in *self {
            r.render(to);
        }
    }
}

impl<const N: usize, R: Render> Render for [R; N] {
    fn render(&self, to: &mut String) {
        for r in self {
            r.render(to);
        }
    }
}

impl<R: Render> Render for Vec<R> {
    fn render(&self, to: &mut String) {
        for r in self {
            r.render(to);
        }
    }
}

macro_rules! impl_for_tuples {
    ($head:ident) => {
        impl Render for () {
            fn render(&self, _: &mut String) {}
        }
    };
    ($head:ident $($tail:ident)+) => {
        impl <$($tail: Render),*> Render for ($($tail),*,) {
            fn render(&self, to: &mut String) {
                #[allow(non_snake_case, reason = "macro")]
                let ($($tail),*,) = self;
                ($($tail.render(to)),*);
            }
        }

        impl_for_tuples!($($tail)*);
    };
}

impl_for_tuples!(I H G F E D C B A);

/// renders directly without any escaping
pub struct Raw<T>(pub T);
impl<T: AsRef<str>> Render for Raw<T> {
    fn render(&self, to: &mut String) {
        to.push_str(self.0.as_ref());
    }
}

/// renders lazily delegating to a function
pub struct Fn<F>(pub F);
impl<F: std::ops::Fn(&mut String)> Render for Fn<F> {
    fn render(&self, to: &mut String) {
        self.0(to);
    }
}