//! This module contains the logic to style an object that contains some 'content' which can be styled. use super::{color, Color, ObjectStyle}; //use Screen; use crossterm_utils::{Result, TerminalOutput}; use std::fmt::{self, Display, Formatter}; use std::io::Write; use std::result; use std::sync::Arc; use super::Attribute; /// Struct that contains both the style and the content wits can be styled. pub struct StyledObject { pub object_style: ObjectStyle, pub content: D, } impl<'a, D: Display + 'a> StyledObject { /// Set the foreground of the styled object to the passed `Color`. /// /// # Remarks /// /// This methods consumes 'self', and works like a builder. /// By having this functionality you can do: `with().on().attr()` pub fn with(mut self, foreground_color: Color) -> StyledObject { self.object_style = self.object_style.fg(foreground_color); self } /// Set the background of the styled object to the passed `Color`. /// /// # Remarks /// /// This methods consumes 'self', and works like a builder. /// By having this functionality you can do: `with().on().attr()` pub fn on(mut self, background_color: Color) -> StyledObject { self.object_style = self.object_style.bg(background_color); self } /// Set the attribute of an styled object to the passed `Attribute`. /// /// # Remarks /// /// This methods consumes 'self', and works like a builder. /// By having this functionality you can do: `with().on().attr()` pub fn attr(mut self, attr: Attribute) -> StyledObject { self.object_style.add_attr(attr); self } /// Increase the font intensity. #[inline(always)] pub fn bold(self) -> StyledObject { self.attr(Attribute::Bold) } /// Faint (decreased intensity) (Not widely supported). #[cfg(unix)] #[inline(always)] pub fn dim(self) -> StyledObject { self.attr(Attribute::Dim) } /// Make the font italic (Not widely supported; Sometimes treated as inverse). #[cfg(unix)] #[inline(always)] pub fn italic(self) -> StyledObject { self.attr(Attribute::Italic) } /// Underline font. #[inline(always)] pub fn underlined(self) -> StyledObject { self.attr(Attribute::Underlined) } /// Invert colours. #[cfg(windows)] #[inline(always)] pub fn negative(self) -> StyledObject { self.attr(Attribute::Negative) } /// Slow Blink (less than 150 per minute; not widely supported). #[cfg(unix)] #[inline(always)] pub fn slow_blink(self) -> StyledObject { self.attr(Attribute::SlowBlink) } /// Rapid Blink (MS-DOS ANSI.SYS; 150+ per minute; not widely supported). #[cfg(unix)] #[inline(always)] pub fn rapid_blink(self) -> StyledObject { self.attr(Attribute::RapidBlink) } /// Swap foreground and background colors. #[cfg(unix)] #[inline(always)] pub fn reverse(self) -> StyledObject { self.attr(Attribute::Reverse) } /// Hide text (Not widely supported). #[cfg(unix)] #[inline(always)] pub fn hidden(self) -> StyledObject { self.attr(Attribute::Hidden) } /// Characters legible, but marked for deletion. Not widely supported. #[cfg(unix)] #[inline(always)] pub fn crossed_out(self) -> StyledObject { self.attr(Attribute::CrossedOut) } /// This converts an styled object into an `DisplayableObject` witch implements: `Display` and could be used inside the write function of the standard library. /// /// _StyledObject already implements `Display` right?_ /// /// This is true, however there are some complex issues why this won't work on alternate screen. /// That is the reason why this functions exists. /// You could just pass in the 'screen' from your alternate screen to this method and your `StyledObject` will be printed to the alternate screen just fine. /// /// ``` /// let screen = Screen::default(); /* represents the alternate screen */ /// let styled_object = style("test").with(Color::Yellow); /// let display_object = styled_object.into_displayable(&screen); /// println!("Colored text: {}. Default color", display_object); /// ``` pub fn into_displayable(self, stdout: &'a Arc) -> DisplayableObject<'a, D> { DisplayableObject::new(stdout, self) } /// This could be used to paint the styled object onto the given screen. You have to pass a reference to the screen whereon you want to perform the painting. /// /// ``` rust /// style("Some colored text") /// .with(Color::Blue) /// .on(Color::Black) /// .paint(&screen); /// ``` /// /// You should take not that `StyledObject` implements `Display`. You don't need to call paint unless you are on alternate screen. /// Checkout `into_displayable()` for more information about this. pub fn paint(&self, stdout: &Arc) -> Result<()> { let colored_terminal = super::TerminalColor::from_output(stdout); let mut reset = true; if let Some(bg) = self.object_style.bg_color { colored_terminal.set_bg(bg)?; reset = true; } if let Some(fg) = self.object_style.fg_color { colored_terminal.set_fg(fg)?; reset = true; } for attr in self.object_style.attrs.iter() { stdout.write_string(format!(csi!("{}m"), *attr as i16))?; reset = true; } use std::fmt::Write; let mut content = String::new(); write!(content, "{}", self.content)?; stdout.write_string(content)?; stdout.flush()?; if reset { colored_terminal.reset()?; } Ok(()) } } impl Display for StyledObject { fn fmt(&self, f: &mut Formatter) -> result::Result<(), fmt::Error> { let colored_terminal = color(); let mut reset = true; if let Some(bg) = self.object_style.bg_color { colored_terminal.set_bg(bg).unwrap(); reset = true; } if let Some(fg) = self.object_style.fg_color { colored_terminal.set_fg(fg).unwrap(); reset = true; } for attr in self.object_style.attrs.iter() { write!(f, "{}", format!(csi!("{}m"), *attr as i16))?; reset = true; } fmt::Display::fmt(&self.content, f)?; std::io::stdout().flush().unwrap(); if reset { colored_terminal.reset().unwrap(); std::io::stdout().flush().unwrap(); } Ok(()) } } /// This is a wrapper for a styled object on 'alternate screen' so that the styled object could be printed on the 'alternate screen' with the standard write functions in rust. /// /// ``` /// write! ("some normal text, {} <- some colored text", DisplayableObject::new(&screen, styled_object)); /// println! ("some normal text, {} <- some colored text", DisplayableObject::new(&screen, styled_object)); /// ``` pub struct DisplayableObject<'a, D: Display + 'a> { styled_object: StyledObject, output: &'a Arc, } impl<'a, D: Display + 'a> DisplayableObject<'a, D> { pub fn new( screen: &'a Arc, styled_object: StyledObject, ) -> DisplayableObject<'a, D> { DisplayableObject { output: screen, styled_object, } } } impl<'a, D: Display + 'a> Display for DisplayableObject<'a, D> { fn fmt(&self, _f: &mut Formatter) -> result::Result<(), fmt::Error> { self.styled_object.paint(self.output).unwrap(); Ok(()) } }