// 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, 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 add_label(&mut self, label: &str) -> io::Result<()>; fn remove_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.add_label(label)?; // Call `remove_label()` whether or not `write_inner()` fails, but don't let // its error replace the one from `write_inner()`. write_inner(self).and(self.remove_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)) } } /// Creates `Formatter` instances with preconfigured parameters. #[derive(Clone, Debug)] pub struct FormatterFactory { kind: FormatterFactoryKind, } #[derive(Clone, Debug)] enum FormatterFactoryKind { PlainText, Color { rules: Arc, Style>>, }, } 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 add_label(&mut self, _label: &str) -> io::Result<()> { Ok(()) } fn remove_label(&mut self) -> io::Result<()> { Ok(()) } } #[derive(Clone, Debug, Default, PartialEq, Eq)] pub struct Style { pub fg_color: Option, } impl Style { fn merge(&mut self, other: &Style) { self.fg_color = other.fg_color.or(self.fg_color); } } pub struct ColorFormatter { output: W, rules: Arc, Style>>, labels: Vec, cached_styles: HashMap, Style>, current_style: Style, } impl ColorFormatter { pub fn new(output: W, rules: Arc, Style>>) -> 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 current_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.current_style(); if new_style != self.current_style { // For now, make bright colors imply bold font. That better matches our // behavior from when we used ANSI codes 30-37 plus an optional 1 for // bold/bright (we now use code 38 for setting foreground color). // TODO: Make boldness configurable separately from color if !is_bright(&self.current_style.fg_color) && is_bright(&new_style.fg_color) { queue!(self.output, SetAttribute(Attribute::Bold))?; } else if !is_bright(&new_style.fg_color) && is_bright(&self.current_style.fg_color) { queue!(self.output, SetAttribute(Attribute::Reset))?; } queue!( self.output, SetForegroundColor(new_style.fg_color.unwrap_or(Color::Reset)) )?; self.current_style = new_style; } Ok(()) } } fn is_bright(color: &Option) -> bool { matches!( color.unwrap_or(Color::Reset), Color::DarkGrey | Color::Red | Color::Green | Color::Yellow | Color::Blue | Color::Magenta | Color::Cyan | Color::White ) } fn rules_from_config(config: &config::Config) -> HashMap, Style> { let mut result = HashMap::new(); 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), }; result.insert(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); } } result.insert(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.output.write(data) } fn flush(&mut self) -> Result<(), Error> { self.output.flush() } } impl Formatter for ColorFormatter { fn add_label(&mut self, label: &str) -> io::Result<()> { self.labels.push(label.to_owned()); self.write_new_style() } fn remove_label(&mut self) -> io::Result<()> { self.labels.pop(); self.write_new_style() } } #[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.add_label("warning").unwrap(); formatter.write_str("hello").unwrap(); formatter.remove_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.add_label(&color.replace(' ', "-")).unwrap(); formatter.write_str(&format!(" {color} ")).unwrap(); formatter.remove_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.add_label("inside").unwrap(); formatter.write_str(" inside ").unwrap(); formatter.remove_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. let config = config_from_string( r#" colors.red_fg = { fg = "red" } "#, ); let mut output: Vec = vec![]; let mut formatter = ColorFormatter::for_config(&mut output, &config); formatter.add_label("red_fg").unwrap(); formatter.write_str(" fg only ").unwrap(); formatter.remove_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" fg only "); } #[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.add_label("red").unwrap(); formatter.write_str("first").unwrap(); formatter.remove_label().unwrap(); formatter.add_label("green").unwrap(); formatter.write_str("second").unwrap(); formatter.remove_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.add_label("red").unwrap(); formatter .write_str("\x1b[1mnot actually bold\x1b[0m") .unwrap(); formatter.remove_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.add_label("outer").unwrap(); formatter.write_str(" before inner ").unwrap(); formatter.add_label("inner").unwrap(); formatter.write_str(" inside inner ").unwrap(); formatter.remove_label().unwrap(); formatter.write_str(" after inner ").unwrap(); formatter.remove_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.add_label("outer").unwrap(); formatter.write_str(" not colored ").unwrap(); formatter.add_label("inner").unwrap(); formatter.write_str(" colored ").unwrap(); formatter.remove_label().unwrap(); formatter.write_str(" not colored ").unwrap(); formatter.remove_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.add_label("outer").unwrap(); formatter.write_str(" red before ").unwrap(); formatter.add_label("inner").unwrap(); formatter.write_str(" still red inside ").unwrap(); formatter.remove_label().unwrap(); formatter.write_str(" also red afterwards ").unwrap(); formatter.remove_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.add_label("outer1").unwrap(); formatter.add_label("inner2").unwrap(); formatter.write_str(" hello ").unwrap(); formatter.remove_label().unwrap(); formatter.remove_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.add_label("outer").unwrap(); formatter.add_label("inner").unwrap(); formatter.write_str(" hello ").unwrap(); formatter.remove_label().unwrap(); formatter.remove_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.add_label("a").unwrap(); formatter.write_str(" a1 ").unwrap(); formatter.add_label("b").unwrap(); formatter.write_str(" b1 ").unwrap(); formatter.add_label("c").unwrap(); formatter.write_str(" c ").unwrap(); formatter.remove_label().unwrap(); formatter.write_str(" b2 ").unwrap(); formatter.remove_label().unwrap(); formatter.write_str(" a2 ").unwrap(); formatter.remove_label().unwrap(); insta::assert_snapshot!(String::from_utf8(output).unwrap(), @" a1  b1  c  b2  a2 "); } }