compris 0.0.11

Composite Primitive Schema (CPS) for Rust
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

use super::{super::annotate::*, macros::*};

use {
    depiction::*,
    kutil::std::immutable::*,
    std::{borrow::*, fmt, io},
};

//
// Text
//

impl_normal! {
    /// Normal text variant.
    ///
    /// [Annotations], if present, are *ignored* for the purposes of comparison and hashing.
    ///
    /// Note that the value is a [ByteString] in order to support zero-copy cloning.
    ///
    /// We didn't call this struct "String" in order to avoid ambiguity with the built-in [String].
    Text(ByteString)
}

impl_normal_basic!(Text);

impl<AnnotatedT> Text<AnnotatedT> {
    /// As string.
    pub fn as_str(&self) -> &str {
        self.inner.as_ref()
    }
}

impl<AnnotatedT> Depict for Text<AnnotatedT> {
    fn depict<WriteT>(&self, writer: &mut WriteT, context: &DepictionContext) -> io::Result<()>
    where
        WriteT: io::Write,
    {
        context.separate(writer)?;
        write!(writer, "{}", context.theme.string(format!("{:?}", self.inner)))
    }
}

impl<AnnotatedT> fmt::Display for Text<AnnotatedT> {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        fmt::Display::fmt(&self.inner, formatter)
    }
}

// Conversions

impl<AnnotatedT> AsRef<str> for Text<AnnotatedT> {
    fn as_ref(&self) -> &str {
        &self.inner
    }
}

impl<AnnotatedT> From<&'static str> for Text<AnnotatedT>
where
    AnnotatedT: Default,
{
    fn from(string: &'static str) -> Self {
        Self::from(ByteString::from_static(string))
    }
}

impl<AnnotatedT> From<String> for Text<AnnotatedT>
where
    AnnotatedT: Default,
{
    fn from(string: String) -> Self {
        Self::from(ByteString::from(string))
    }
}

impl<AnnotatedT> From<Cow<'_, str>> for Text<AnnotatedT>
where
    AnnotatedT: Default,
{
    fn from(string: Cow<'_, str>) -> Self {
        match string {
            Cow::Borrowed(string) => ByteString::from(string).into(),
            Cow::Owned(string) => string.into(),
        }
    }
}

impl<AnnotatedT> From<Text<AnnotatedT>> for String {
    fn from(text: Text<AnnotatedT>) -> Self {
        text.inner.into()
    }
}

impl<'own, AnnotatedT> From<&'own Text<AnnotatedT>> for &'own str {
    fn from(text: &'own Text<AnnotatedT>) -> Self {
        &text.inner
    }
}