gix_config/parse/
event.rs

1use std::{borrow::Cow, fmt::Display};
2
3use bstr::{BStr, BString};
4
5use crate::parse::Event;
6
7impl Event<'_> {
8    /// Serialize this type into a `BString` for convenience.
9    ///
10    /// Note that `to_string()` can also be used, but might not be lossless.
11    #[must_use]
12    pub fn to_bstring(&self) -> BString {
13        let mut buf = Vec::new();
14        self.write_to(&mut buf).expect("io error impossible");
15        buf.into()
16    }
17
18    /// Turn ourselves into the text we represent, lossy.
19    ///
20    /// Note that this will be partial in case of `ValueNotDone` which doesn't include the backslash, and `SectionHeader` will only
21    /// provide their name, lacking the sub-section name.
22    pub fn to_bstr_lossy(&self) -> &BStr {
23        match self {
24            Self::ValueNotDone(e) | Self::Whitespace(e) | Self::Newline(e) | Self::Value(e) | Self::ValueDone(e) => {
25                e.as_ref()
26            }
27            Self::KeyValueSeparator => "=".into(),
28            Self::SectionValueName(k) => k.0.as_ref(),
29            Self::SectionHeader(h) => h.name.0.as_ref(),
30            Self::Comment(c) => c.text.as_ref(),
31        }
32    }
33
34    /// Stream ourselves to the given `out`, in order to reproduce this event mostly losslessly
35    /// as it was parsed.
36    pub fn write_to(&self, out: &mut dyn std::io::Write) -> std::io::Result<()> {
37        match self {
38            Self::ValueNotDone(e) => {
39                out.write_all(e.as_ref())?;
40                out.write_all(br"\")
41            }
42            Self::Whitespace(e) | Self::Newline(e) | Self::Value(e) | Self::ValueDone(e) => out.write_all(e.as_ref()),
43            Self::KeyValueSeparator => out.write_all(b"="),
44            Self::SectionValueName(k) => out.write_all(k.0.as_ref()),
45            Self::SectionHeader(h) => h.write_to(out),
46            Self::Comment(c) => c.write_to(out),
47        }
48    }
49
50    /// Turn this instance into a fully owned one with `'static` lifetime.
51    #[must_use]
52    pub fn to_owned(&self) -> Event<'static> {
53        match self {
54            Event::Comment(e) => Event::Comment(e.to_owned()),
55            Event::SectionHeader(e) => Event::SectionHeader(e.to_owned()),
56            Event::SectionValueName(e) => Event::SectionValueName(e.to_owned()),
57            Event::Value(e) => Event::Value(Cow::Owned(e.clone().into_owned())),
58            Event::ValueNotDone(e) => Event::ValueNotDone(Cow::Owned(e.clone().into_owned())),
59            Event::ValueDone(e) => Event::ValueDone(Cow::Owned(e.clone().into_owned())),
60            Event::Newline(e) => Event::Newline(Cow::Owned(e.clone().into_owned())),
61            Event::Whitespace(e) => Event::Whitespace(Cow::Owned(e.clone().into_owned())),
62            Event::KeyValueSeparator => Event::KeyValueSeparator,
63        }
64    }
65}
66
67impl Display for Event<'_> {
68    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
69        Display::fmt(&self.to_bstring(), f)
70    }
71}
72
73impl From<Event<'_>> for BString {
74    fn from(event: Event<'_>) -> Self {
75        event.to_bstring()
76    }
77}
78
79impl From<&Event<'_>> for BString {
80    fn from(event: &Event<'_>) -> Self {
81        event.to_bstring()
82    }
83}
gix_config/parse/event.rs

gix_config/parse/
event.rs
