anscape 0.2.2

Anscape provides a simple way to customize your terminal window with some styles and colors and manipulate with a cursor position using ANSI Escape Sequences.
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
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

//! # Background and Foreground Colors

/// # Color Types
/// Fg (foreground) changes a color of a text, and Bg (background) changes an area behind the text.
pub enum Type {
    Fg,
    Bg,
}

/// # Macros for building basic color constants
/// It generates 4 constants per provided color.
///
/// For example, `pub BLACK:"0"` will generate:
///
/// `pub const BLACK:&str = "\x1b[30m";`
///
/// `pub const BLACK_BG:&str = "\x1b[40m"`
///
/// `pub const BR_BLACK:&str = "\x1b[90m"`
///
/// `pub const BR_BLACK_BG:&str = "\x1b[100m"`
///
/// **BR_** - bright colors prefix
///
/// **_BG** - backround colors suffix
///
/// ### Usage example:
/// ```
/// use anscape::colors;
/// colors! {
///     pub BLACK:"0"
///     pub RED:"1"
///     pub GREEN:"2"
///     pub YELLOW:"3"
///     pub BLUE:"4"
///     pub MAGENTA:"5"
///     pub CYAN:"6"
///     pub WHITE:"7"
///     pub DEFAULT:"9"
/// }
/// ```
#[macro_export]
macro_rules! colors {
    ($($vis:vis $cname:ident:$cval:literal)*) => {
            use paste::paste;
            paste!{
                $(
                    #[doc="Set " $cname " foreground color"]
                    $vis const $cname:&str = concat!("\x1b[", "3",$cval,"m");
                    #[doc="Set " $cname " background color"]
                    $vis const [<$cname _BG>]:&str = concat!("\x1b[", "4",$cval,"m");
                    #[doc="Set bright " $cname " foreground color"]
                    $vis const [<BR_ $cname>]:&str = concat!("\x1b[","9",$cval,"m");
                    #[doc="Set bright " $cname " background color"]
                    $vis const [<BR_ $cname _BG>]:&str = concat!("\x1b[","10",$cval,"m");
                )*
            }
        };
}

colors! {
    pub BLACK:"0"
    pub RED:"1"
    pub GREEN:"2"
    pub YELLOW:"3"
    pub BLUE:"4"
    pub MAGENTA:"5"
    pub CYAN:"6"
    pub WHITE:"7"
    pub DEFAULT:"9"
}

/// RGB colors builder
///
/// **Example:**
/// ```
/// use anscape::sequences::colors::Type;
/// use anscape::sequences::colors::rgb;
/// use anscape::sequences::base::ESC;
/// println!("{}{} Hello!",ESC,rgb(255, 255, 255, Type::Fg));
/// ```
pub fn rgb(r: u8, g: u8, b: u8, t: Type) -> String {
    let st;
    match t {
        Type::Fg => {
            st = "3";
        }
        Type::Bg => {
            st = "4";
        }
    }
    format!("\x1b[{}8;2;{};{};{}m", st, r, g, b)
}
/// Foreground RGB colors builder
///
/// **Example:**
/// ```
/// use anscape::sequences::colors::rgb_fg;
/// println!("{}Hello!",rgb_fg(255, 255, 255));
/// ```
pub fn rgb_fg(r: u8, g: u8, b: u8) -> String {
    return rgb(r, g, b, Type::Fg);
}
/// Background RGB colors builder
///
/// **Example:**
/// ```
/// use anscape::sequences::colors::rgb_bg;
/// println!("{}Hello!",rgb_bg(255, 255, 255));
/// ```
pub fn rgb_bg(r: u8, g: u8, b: u8) -> String {
    return rgb(r, g, b, Type::Bg);
}