okansi 0.3.0

An ok library for creating ANSI terminal styles
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

/// Used to specify the color in `AnsiColor::Palette`
///
/// <https://en.wikipedia.org/wiki/ANSI_escape_code#3-bit_and_4-bit>
#[derive(Clone, Copy)]
pub enum PaletteColor {
	/// Color #0, may display as the terminal's default background color.
	Black,
	/// Color #1
	Red,
	/// Color #2
	Green,
	/// Color #3
	Yellow,
	/// Color #4
	Blue,
	/// Color #5
	Magenta,
	/// Color #6
	Cyan,
	/// Color #7
	White,

	/// Color #8, Gray
	BrightBlack,
	/// Color #9
	BrightRed,
	/// Color #10
	BrightGreen,
	/// Color #11
	BrightYellow,
	/// Color #12
	BrightBlue,
	/// Color #13
	BrightMagenta,
	/// Color #14
	BrightCyan,
	/// Color #15
	BrightWhite,
}
impl PaletteColor {
	fn get_code(&self) -> u8 {
		match self {
			PaletteColor::Black => 30,
			PaletteColor::Red => 31,
			PaletteColor::Green => 32,
			PaletteColor::Yellow => 33,
			PaletteColor::Blue => 34,
			PaletteColor::Magenta => 35,
			PaletteColor::Cyan => 36,
			PaletteColor::White => 37,

			PaletteColor::BrightBlack => 90,
			PaletteColor::BrightRed => 91,
			PaletteColor::BrightGreen => 92,
			PaletteColor::BrightYellow => 93,
			PaletteColor::BrightBlue => 94,
			PaletteColor::BrightMagenta => 95,
			PaletteColor::BrightCyan => 96,
			PaletteColor::BrightWhite => 97,
		}
	}
}

/// Used for specifying the color to set the background or foreground of an `AnsiStyle`
#[derive(Clone, Copy)]
pub enum AnsiColor {
	/// One of the predefined colors in the `PaletteColor` enum.
	///
	/// These are identical to the colors from `Fixed8bit(0-15)`, but instead are formatted as `XX` instead of `#8;5;XX` (color may vary depending on terminal!)
	Palette(PaletteColor),

	/// A color from a predefined 256 color table
	///
	/// - 0-7: standard palette colors `Black` through `White`
	/// - 8-15: brighter palette colors `BrightBlack` through `BrightWhite`
	/// - 16-231: colors inside a 6x6x6 cube `16 + (36 * red) + (6 * green) + blue`
	/// - 232-255: grayscale from black to white in 24 steps
	Fixed8bit(u8),

	/// A 24-bit RGB color
	Rgb24bit(u8, u8, u8),
}
impl AnsiColor {
	pub(crate) fn gen_sequence(&self, is_bg: bool) -> String {
		match self {
			AnsiColor::Palette(palette) => {
				let mut code = palette.get_code();

				if is_bg {
					code += 10;
				}

				code.to_string()
			}
			AnsiColor::Fixed8bit(code) => {
				format!("{};5;{}", if is_bg { "48" } else { "38" }, code)
			}
			AnsiColor::Rgb24bit(r, g, b) => {
				format!("{};2;{};{};{}", if is_bg { "48" } else { "38" }, r, g, b)
			}
		}
	}
}