hotmeal 2.0.2

HTML toolkit with arena-based DOM, html5ever parsing, and serialization
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
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165

//! Stem - compact string type for DOM content.

use compact_str::CompactString;
use facet::Facet;
use std::borrow::Borrow;
use std::fmt;
use std::hash::{Hash, Hasher};
use std::ops::Deref;
use tendril::StrTendril;

/// Compact string type used for text content, comments, and attribute values.
///
/// Can be either borrowed (zero-copy from input) or owned (after mutation).
#[derive(Clone, Facet)]
#[facet(cow)]
#[repr(u8)]
pub enum Stem<'a> {
    Borrowed(&'a str),
    Owned(CompactString),
}

impl<'a> Stem<'a> {
    pub fn new() -> Self {
        Self::Owned(CompactString::default())
    }

    pub fn as_str(&self) -> &str {
        match self {
            Self::Borrowed(s) => s,
            Self::Owned(s) => s.as_str(),
        }
    }

    pub fn is_empty(&self) -> bool {
        self.as_str().is_empty()
    }

    pub fn len(&self) -> usize {
        self.as_str().len()
    }

    pub fn push_str(&mut self, s: &str) {
        match self {
            Self::Owned(existing) => {
                existing.push_str(s);
            }
            Self::Borrowed(borrowed) => {
                *self = Self::Owned(compact_str::format_compact!("{}{}", borrowed, s));
            }
        }
    }

    pub fn push_tendril(&mut self, t: &StrTendril) {
        self.push_str(t.as_ref());
    }

    /// Convert to an owned version with 'static lifetime.
    pub fn into_owned(self) -> Stem<'static> {
        match self {
            Self::Borrowed(s) => Stem::Owned(CompactString::new(s)),
            Self::Owned(s) => Stem::Owned(s),
        }
    }
}

impl Default for Stem<'_> {
    fn default() -> Self {
        Self::new()
    }
}

impl Deref for Stem<'_> {
    type Target = str;

    fn deref(&self) -> &Self::Target {
        self.as_str()
    }
}

impl AsRef<str> for Stem<'_> {
    fn as_ref(&self) -> &str {
        self.as_str()
    }
}

impl Borrow<str> for Stem<'_> {
    fn borrow(&self) -> &str {
        self.as_str()
    }
}

impl PartialEq for Stem<'_> {
    fn eq(&self, other: &Self) -> bool {
        self.as_str() == other.as_str()
    }
}

impl Eq for Stem<'_> {}

impl PartialEq<str> for Stem<'_> {
    fn eq(&self, other: &str) -> bool {
        self.as_str() == other
    }
}

impl PartialEq<&str> for Stem<'_> {
    fn eq(&self, other: &&str) -> bool {
        self.as_str() == *other
    }
}

impl Hash for Stem<'_> {
    fn hash<H: Hasher>(&self, state: &mut H) {
        self.as_str().hash(state);
    }
}

impl fmt::Debug for Stem<'_> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt::Debug::fmt(self.as_str(), f)
    }
}

impl fmt::Display for Stem<'_> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt::Display::fmt(self.as_str(), f)
    }
}

impl<'a> From<&'a str> for Stem<'a> {
    fn from(s: &'a str) -> Self {
        Self::Borrowed(s)
    }
}

impl From<String> for Stem<'_> {
    fn from(s: String) -> Self {
        Self::Owned(CompactString::from(s))
    }
}

impl From<CompactString> for Stem<'_> {
    fn from(s: CompactString) -> Self {
        Self::Owned(s)
    }
}

impl From<StrTendril> for Stem<'_> {
    fn from(t: StrTendril) -> Self {
        Self::Owned(CompactString::new(t.as_ref()))
    }
}

impl From<&StrTendril> for Stem<'_> {
    fn from(t: &StrTendril) -> Self {
        Self::Owned(CompactString::new(t.as_ref()))
    }
}

const _: () = {
    const fn assert_send<T: Send>() {}
    const fn assert_sync<T: Sync>() {}
    assert_send::<Stem<'static>>();
    assert_sync::<Stem<'static>>();
};