// Copyright 2020 The Jujutsu Authors // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. use std::borrow::BorrowMut; use std::collections::HashMap; use std::io::{Error, Write}; use std::sync::Arc; use std::{fmt, io}; use crossterm::queue; use crossterm::style::{Attribute, Color, SetAttribute, SetBackgroundColor, SetForegroundColor}; use itertools::Itertools; // Lets the caller label strings and translates the labels to colors pub trait Formatter: Write { fn write_bytes(&mut self, data: &[u8]) -> io::Result<()> { self.write_all(data) } fn write_str(&mut self, text: &str) -> io::Result<()> { self.write_all(text.as_bytes()) } fn push_label(&mut self, label: &str) -> io::Result<()>; fn pop_label(&mut self) -> io::Result<()>; } impl dyn Formatter + '_ { pub fn labeled>(&mut self, label: S) -> LabeledWriter<&mut Self, S> { LabeledWriter { formatter: self, label, } } pub fn with_label( &mut self, label: &str, write_inner: impl FnOnce(&mut dyn Formatter) -> io::Result<()>, ) -> io::Result<()> { self.push_label(label)?; // Call `pop_label()` whether or not `write_inner()` fails, but don't let // its error replace the one from `write_inner()`. write_inner(self).and(self.pop_label()) } } /// `Formatter` wrapper to write a labeled message with `write!()` or /// `writeln!()`. pub struct LabeledWriter { formatter: T, label: S, } impl LabeledWriter { pub fn new(formatter: T, label: S) -> Self { LabeledWriter { formatter, label } } } impl<'a, T, S> LabeledWriter where T: BorrowMut, S: AsRef, { pub fn write_fmt(&mut self, args: fmt::Arguments<'_>) -> io::Result<()> { self.formatter .borrow_mut() .with_label(self.label.as_ref(), |formatter| formatter.write_fmt(args)) } } type Rules = Vec<(Vec, Style)>; /// Creates `Formatter` instances with preconfigured parameters. #[derive(Clone, Debug)] pub struct FormatterFactory { kind: FormatterFactoryKind, } #[derive(Clone, Debug)] enum FormatterFactoryKind { PlainText, Color { rules: Arc }, } impl FormatterFactory { pub fn prepare(config: &config::Config, color: bool) -> Self { let kind = if color { let rules = Arc::new(rules_from_config(config)); FormatterFactoryKind::Color { rules } } else { FormatterFactoryKind::PlainText }; FormatterFactory { kind } } pub fn new_formatter<'output, W: Write + 'output>( &self, output: W, ) -> Box { match &self.kind { FormatterFactoryKind::PlainText => Box::new(PlainTextFormatter::new(output)), FormatterFactoryKind::Color { rules } => { Box::new(ColorFormatter::new(output, rules.clone())) } } } } pub struct PlainTextFormatter { output: W, } impl PlainTextFormatter { pub fn new(output: W) -> PlainTextFormatter { Self { output } } } impl Write for PlainTextFormatter { fn write(&mut self, data: &[u8]) -> Result { self.output.write(data) } fn flush(&mut self) -> Result<(), Error> { self.output.flush() } } impl Formatter for PlainTextFormatter { fn push_label(&mut self, _label: &str) -> io::Result<()> { Ok(()) } fn pop_label(&mut self) -> io::Result<()> { Ok(()) } } #[derive(Clone, Debug, Default, PartialEq, Eq)] pub struct Style { pub fg_color: Option, pub bg_color: Option, pub bold: Option, pub underlined: Option, } impl Style { fn merge(&mut self, other: &Style) { self.fg_color = other.fg_color.or(self.fg_color); self.bg_color = other.bg_color.or(self.bg_color); self.bold = other.bold.or(self.bold); self.underlined = other.underlined.or(self.underlined); } } pub struct ColorFormatter { output: W, rules: Arc, /// The stack of currently applied labels. These determine the desired /// style. labels: Vec, cached_styles: HashMap, Style>, /// The style we last wrote to the output. current_style: Style, } impl ColorFormatter { pub fn new(output: W, rules: Arc) -> ColorFormatter { ColorFormatter { output, rules, labels: vec![], cached_styles: HashMap::new(), current_style: Style::default(), } } pub fn for_config(output: W, config: &config::Config) -> ColorFormatter { let rules = rules_from_config(config); Self::new(output, Arc::new(rules)) } fn requested_style(&mut self) -> Style { if let Some(cached) = self.cached_styles.get(&self.labels) { cached.clone() } else { // We use the reverse list of matched indices as a measure of how well the rule // matches the actual labels. For example, for rule "a d" and the actual labels // "a b c d", we'll get [3,0]. We compare them by Rust's default Vec comparison. // That means "a d" will trump both rule "d" (priority [3]) and rule // "a b c" (priority [2,1,0]). let mut matched_styles = vec![]; for (labels, style) in self.rules.as_ref() { let mut labels_iter = self.labels.iter().enumerate(); // The indexes in the current label stack that match the required label. let mut matched_indices = vec![]; for required_label in labels { for (label_index, label) in &mut labels_iter { if label == required_label { matched_indices.push(label_index); break; } } } if matched_indices.len() == labels.len() { matched_indices.reverse(); matched_styles.push((style, matched_indices)); } } matched_styles.sort_by_key(|(_, indices)| indices.clone()); let mut style = Style::default(); for (matched_style, _) in matched_styles { style.merge(matched_style); } self.cached_styles .insert(self.labels.clone(), style.clone()); style } } fn write_new_style(&mut self) -> io::Result<()> { let new_style = self.requested_style(); if new_style != self.current_style { if new_style.bold != self.current_style.bold { if new_style.bold.unwrap_or_default() { queue!(self.output, SetAttribute(Attribute::Bold))?; } else { // NoBold results in double underlining on some terminals, so we use reset // instead. However, that resets other attributes as well, so we reset // our record of the current style so we re-apply the other attributes // below. queue!(self.output, SetAttribute(Attribute::Reset))?; self.current_style = Style::default(); } } if new_style.underlined != self.current_style.underlined { if new_style.underlined.unwrap_or_default() { queue!(self.output, SetAttribute(Attribute::Underlined))?; } else { queue!(self.output, SetAttribute(Attribute::NoUnderline))?; } } if new_style.fg_color != self.current_style.fg_color { queue!( self.output, SetForegroundColor(new_style.fg_color.unwrap_or(Color::Reset)) )?; } if new_style.bg_color != self.current_style.bg_color { queue!( self.output, SetBackgroundColor(new_style.bg_color.unwrap_or(Color::Reset)) )?; } self.current_style = new_style; } Ok(()) } } fn rules_from_config(config: &config::Config) -> Rules { let mut result = vec![]; if let Ok(table) = config.get_table("colors") { for (key, value) in table { let labels = key .split_whitespace() .map(ToString::to_string) .collect_vec(); match value.kind { config::ValueKind::String(color_name) => { let style = Style { fg_color: color_for_name(&color_name), bg_color: None, bold: None, underlined: None, }; result.push((labels, style)); } config::ValueKind::Table(style_table) => { let mut style = Style::default(); if let Some(value) = style_table.get("fg") { if let config::ValueKind::String(color_name) = &value.kind { style.fg_color = color_for_name(color_name); } } if let Some(value) = style_table.get("bg") { if let config::ValueKind::String(color_name) = &value.kind { style.bg_color = color_for_name(color_name); } } if let Some(value) = style_table.get("bold") { if let config::ValueKind::Boolean(value) = &value.kind { style.bold = Some(*value); } } if let Some(value) = style_table.get("underlined") { if let config::ValueKind::Boolean(value) = &value.kind { style.underlined = Some(*value); } } result.push((labels, style)); } _ => {} } } } result } fn color_for_name(color_name: &str) -> Option { match color_name { "black" => Some(Color::Black), "red" => Some(Color::DarkRed), "green" => Some(Color::DarkGreen), "yellow" => Some(Color::DarkYellow), "blue" => Some(Color::DarkBlue), "magenta" => Some(Color::DarkMagenta), "cyan" => Some(Color::DarkCyan), "white" => Some(Color::Grey), "bright black" => Some(Color::DarkGrey), "bright red" => Some(Color::Red), "bright green" => Some(Color::Green), "bright yellow" => Some(Color::Yellow), "bright blue" => Some(Color::Blue), "bright magenta" => Some(Color::Magenta), "bright cyan" => Some(Color::Cyan), "bright white" => Some(Color::White), _ => None, } } impl Write for ColorFormatter { fn write(&mut self, data: &[u8]) -> Result { self.write_new_style()?; self.output.write(data) } fn flush(&mut self) -> Result<(), Error> { self.output.flush() } } impl Formatter for ColorFormatter { fn push_label(&mut self, label: &str) -> io::Result<()> { self.labels.push(label.to_owned()); Ok(()) } fn pop_label(&mut self) -> io::Result<()> { self.labels.pop(); if self.labels.is_empty() { self.write_new_style()? } Ok(()) } } #[cfg(test)] mod tests { use super::*; fn config_from_string(text: &str) -> config::Config { config::Config::builder() .add_source(config::File::from_str(text, config::FileFormat::Toml)) .build() .unwrap() } #[test] fn test_plaintext_formatter() { // Test that PlainTextFormatter ignores labels. let mut output: Vec = vec![]; let mut formatter = PlainTextFormatter::new(&mut output); formatter.push_label("warning").unwrap(); formatter.write_str("hello").unwrap(); formatter.pop_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @"hello"); } #[test] fn test_color_formatter_color_codes() { // Test the color code for each color. let colors = [ "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "bright black", "bright red", "bright green", "bright yellow", "bright blue", "bright magenta", "bright cyan", "bright white", ]; let mut config_builder = config::Config::builder(); for color in colors { // Use the color name as the label. config_builder = config_builder .set_override(format!("colors.{}", color.replace(' ', "-")), color) .unwrap(); } let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config_builder.build().unwrap()); for color in colors { formatter.push_label(&color.replace(' ', "-")).unwrap(); formatter.write_str(&format!(" {color} ")).unwrap(); formatter.pop_label().unwrap(); formatter.write_str("\n").unwrap(); } insta::assert_snapshot!(String::from_utf8(output).unwrap(), @r###"  black   red   green   yellow   blue   magenta   cyan   white   bright black   bright red   bright green   bright yellow   bright blue   bright magenta   bright cyan   bright white  "###); } #[test] fn test_color_formatter_single_label() { // Test that a single label can be colored and that the color is reset // afterwards. let config = config_from_string( r#" colors.inside = "green" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.write_str(" before ").unwrap(); formatter.push_label("inside").unwrap(); formatter.write_str(" inside ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" after ").unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" before  inside  after "); } #[test] fn test_color_formatter_attributes() { // Test that each attribute of the style can be set and that they can be // combined in a single rule or by using multiple rules. let config = config_from_string( r#" colors.red_fg = { fg = "red" } colors.blue_bg = { bg = "blue" } colors.bold_font = { bold = true } colors.underlined_text = { underlined = true } colors.multiple = { fg = "green", bg = "yellow", bold = true, underlined = true } "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("red_fg").unwrap(); formatter.write_str(" fg only ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str("\n").unwrap(); formatter.push_label("blue_bg").unwrap(); formatter.write_str(" bg only ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str("\n").unwrap(); formatter.push_label("bold_font").unwrap(); formatter.write_str(" bold only ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str("\n").unwrap(); formatter.push_label("underlined_text").unwrap(); formatter.write_str(" underlined only ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str("\n").unwrap(); formatter.push_label("multiple").unwrap(); formatter.write_str(" single rule ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str("\n").unwrap(); formatter.push_label("red_fg").unwrap(); formatter.push_label("blue_bg").unwrap(); formatter.write_str(" two rules ").unwrap(); formatter.pop_label().unwrap(); formatter.pop_label().unwrap(); formatter.write_str("\n").unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @r###"  fg only   bg only   bold only   underlined only   single rule   two rules  "###); } #[test] fn test_color_formatter_bold_reset() { // Test that we don't lose other attributes when we reset the bold attribute. let config = config_from_string( r#" colors.not_bold = { fg = "red", bg = "blue", underlined = true } colors.bold_font = { bold = true } "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("not_bold").unwrap(); formatter.write_str(" not bold ").unwrap(); formatter.push_label("bold_font").unwrap(); formatter.write_str(" bold ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" not bold again ").unwrap(); formatter.pop_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" not bold  bold  not bold again "); } #[test] fn test_color_formatter_no_space() { // Test that two different colors can touch. let config = config_from_string( r#" colors.red = "red" colors.green = "green" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.write_str("before").unwrap(); formatter.push_label("red").unwrap(); formatter.write_str("first").unwrap(); formatter.pop_label().unwrap(); formatter.push_label("green").unwrap(); formatter.write_str("second").unwrap(); formatter.pop_label().unwrap(); formatter.write_str("after").unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @"beforefirstsecondafter"); } #[test] fn test_color_formatter_ansi_codes_in_text() { // Test that ANSI codes in the input text are escaped. let config = config_from_string( r#" colors.red = "red" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("red").unwrap(); formatter .write_str("\x1b[1mnot actually bold\x1b[0m") .unwrap(); formatter.pop_label().unwrap(); // TODO: Replace the ANSI escape (\x1b) by something else (🌈?) insta::assert_snapshot!(String::from_utf8(output).unwrap(), @"not actually bold"); } #[test] fn test_color_formatter_nested() { // A color can be associated with a combination of labels. A more specific match // overrides a less specific match. After the inner label is removed, the outer // color is used again (we don't reset). let config = config_from_string( r#" colors.outer = "blue" colors.inner = "red" colors."outer inner" = "green" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.write_str(" before outer ").unwrap(); formatter.push_label("outer").unwrap(); formatter.write_str(" before inner ").unwrap(); formatter.push_label("inner").unwrap(); formatter.write_str(" inside inner ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" after inner ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" after outer ").unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" before outer  before inner  inside inner  after inner  after outer "); } #[test] fn test_color_formatter_partial_match() { // A partial match doesn't count let config = config_from_string( r#" colors."outer inner" = "green" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("outer").unwrap(); formatter.write_str(" not colored ").unwrap(); formatter.push_label("inner").unwrap(); formatter.write_str(" colored ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" not colored ").unwrap(); formatter.pop_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" not colored  colored  not colored "); } #[test] fn test_color_formatter_unrecognized_color() { // An unrecognized color is ignored; it doesn't reset the color. let config = config_from_string( r#" colors."outer" = "red" colors."outer inner" = "bloo" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("outer").unwrap(); formatter.write_str(" red before ").unwrap(); formatter.push_label("inner").unwrap(); formatter.write_str(" still red inside ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" also red afterwards ").unwrap(); formatter.pop_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" red before still red inside also red afterwards "); } #[test] fn test_color_formatter_sibling() { // A partial match on one rule does not eliminate other rules. let config = config_from_string( r#" colors."outer1 inner1" = "red" colors.inner2 = "green" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("outer1").unwrap(); formatter.push_label("inner2").unwrap(); formatter.write_str(" hello ").unwrap(); formatter.pop_label().unwrap(); formatter.pop_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" hello "); } #[test] fn test_color_formatter_reverse_order() { // Rules don't match labels out of order let config = config_from_string( r#" colors."inner outer" = "green" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("outer").unwrap(); formatter.push_label("inner").unwrap(); formatter.write_str(" hello ").unwrap(); formatter.pop_label().unwrap(); formatter.pop_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" hello "); } #[test] fn test_color_formatter_innermost_wins() { // When two labels match, the innermost one wins. let config = config_from_string( r#" colors."a" = "red" colors."b" = "green" colors."a c" = "blue" colors."b c" = "yellow" "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.push_label("a").unwrap(); formatter.write_str(" a1 ").unwrap(); formatter.push_label("b").unwrap(); formatter.write_str(" b1 ").unwrap(); formatter.push_label("c").unwrap(); formatter.write_str(" c ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" b2 ").unwrap(); formatter.pop_label().unwrap(); formatter.write_str(" a2 ").unwrap(); formatter.pop_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" a1  b1  c  b2  a2 "); } }