stylish-stringlike 0.3.0

API for string-like objects that have styles applied.
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

//! Provides the primary text object, [`Spans`], which is a sequence
//! of styled spans, as well as traits providing support for string-like
//! methods on structs.

mod expandable;
mod joinable;
mod paintable;
mod pushable;
mod replaceable;
mod sliceable;
mod spans;
mod splitable;
mod tag;
mod width;
mod width_sliceable;
pub use expandable::Expandable;
pub use joinable::Joinable;
pub use paintable::Paintable;
pub use pushable::Pushable;
pub use replaceable::*;
pub use sliceable::*;
pub use spans::*;
pub use splitable::*;
pub use tag::*;
pub use width::*;
pub use width_sliceable::*;

/// Support for converting a text object into a raw, unstyled string
pub trait RawText {
    /// Return an owned copy of the raw contents of the text object.
    ///
    /// # Example
    /// ```
    /// use stylish_stringlike::text::RawText;
    /// let foo = String::from("foobar");
    /// assert_eq!(foo.raw(), foo);
    /// ````
    fn raw(&self) -> String;
    /// Return a reference ot the raw contents of the text object.
    ///
    /// # Example
    /// ```
    /// use stylish_stringlike::text::RawText;
    /// let foo = String::from("foobar");
    /// assert_eq!(foo.raw_ref(), &foo);
    /// ```
    fn raw_ref(&self) -> &str;
}

impl RawText for String {
    fn raw(&self) -> String {
        self.clone()
    }
    fn raw_ref(&self) -> &str {
        self.as_str()
    }
}

impl RawText for &str {
    fn raw(&self) -> String {
        self.to_string()
    }
    fn raw_ref(&self) -> &str {
        *self
    }
}