gix_config/parse/
comment.rs

1use std::{borrow::Cow, fmt::Display};
2
3use bstr::BString;
4
5use crate::parse::Comment;
6
7impl Comment<'_> {
8    /// Turn this instance into a fully owned one with `'static` lifetime.
9    #[must_use]
10    pub fn to_owned(&self) -> Comment<'static> {
11        Comment {
12            tag: self.tag,
13            text: Cow::Owned(self.text.as_ref().into()),
14        }
15    }
16
17    /// Serialize this type into a `BString` for convenience.
18    ///
19    /// Note that `to_string()` can also be used, but might not be lossless.
20    #[must_use]
21    pub fn to_bstring(&self) -> BString {
22        let mut buf = Vec::new();
23        self.write_to(&mut buf).expect("io error impossible");
24        buf.into()
25    }
26
27    /// Stream ourselves to the given `out`, in order to reproduce this comment losslessly.
28    pub fn write_to(&self, mut out: impl std::io::Write) -> std::io::Result<()> {
29        out.write_all(&[self.tag])?;
30        out.write_all(self.text.as_ref())
31    }
32}
33
34impl Display for Comment<'_> {
35    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
36        Display::fmt(&self.to_bstring(), f)
37    }
38}
39
40impl From<Comment<'_>> for BString {
41    fn from(c: Comment<'_>) -> Self {
42        c.to_bstring()
43    }
44}
45
46impl From<&Comment<'_>> for BString {
47    fn from(c: &Comment<'_>) -> Self {
48        c.to_bstring()
49    }
50}
gix_config/parse/comment.rs

gix_config/parse/
comment.rs
