fatui 0.1.0

a silly little framework for terminal user interfaces
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

use std::fmt;

use crossterm::{Command, style};
use owo_colors::{Style, Styled};

/// a single character which has been styled
///
/// this is nearly identical to a [`owo_colors::Styled<char>`],
/// but that type is missing some common sense derives for no reason
/// so we make do.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct StyledChar {
	/// the [`Style`] which is to be applied to this character
	pub style: Style,
	/// the character being styled
	pub char: char,
}

impl StyledChar {
	/// a blank character -- that is, a single space with no styling at all
	pub const BLANK: Self = Self { style: Style::new(), char: ' ' };

	/// create a new [`StyledChar`] with the given character and style
	pub const fn new(c: char, s: Style) -> Self {
		Self { style: s, char: c }
	}

	/// create a new [`StyledChar`] with no styling
	pub const fn plain(c: char) -> Self {
		Self { style: Style::new(), char: c }
	}

	/// convert an [`owo_colors::Styled<char>`] to a [`StyledChar`]
	pub const fn from_owo(o: Styled<char>) -> Self {
		Self { style: o.style, char: *o.inner() }
	}
}

impl Default for StyledChar {
	fn default() -> Self {
		Self::BLANK
	}
}

impl From<Styled<char>> for StyledChar {
	fn from(value: Styled<char>) -> Self {
		Self::from_owo(value)
	}
}

impl fmt::Display for StyledChar {
	fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
		if self.style.is_plain() {
			style::ResetColor.write_ansi(f)?;
			write!(f, "{}", self.char)
		} else {
			write!(f, "{}{}", self.style.prefix_formatter(), self.char)
		}
	}
}