sgmlish 0.2.0

Simple parsing and deserialization of SGML
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

use std::borrow::Cow;

/// A `Cow` string builder that consumes its inputs, avoiding cloning or
/// reallocating when there's just one source.
#[derive(Debug)]
pub(crate) struct CowBuffer<'a>(Cow<'a, str>);

impl<'a> CowBuffer<'a> {
    pub(crate) fn new() -> Self {
        CowBuffer(Cow::from(""))
    }

    pub(crate) fn push_cow(&mut self, cow: Cow<'a, str>) {
        if cow.is_empty() {
            return;
        }
        if self.0.is_empty() {
            self.0 = cow;
        } else {
            self.0.to_mut().push_str(&cow);
        }
    }

    pub(crate) fn as_str(&self) -> &str {
        &self.0
    }

    pub(crate) fn into_cow(self) -> Cow<'a, str> {
        self.0
    }
}

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

    #[test]
    fn test_cow_buffer() {
        let mut buf = CowBuffer::new();
        assert!(buf.0.is_empty());

        buf.push_cow("Hello".into());
        assert!(matches!(buf, CowBuffer(Cow::Borrowed("Hello"))));

        buf.push_cow(" World".into());
        assert_eq!(buf.0, "Hello World");
    }
}