use ansi_term::ANSIStrings; use rayon::prelude::*; use std::collections::BTreeSet; use std::fmt::{self, Debug, Write as FmtWrite}; use std::io::{self, Write}; use std::time::Duration; use terminal_size::terminal_size; use unicode_segmentation::UnicodeSegmentation; use unicode_width::UnicodeWidthChar; use crate::configs::PROMPT_ORDER; use crate::context::{Context, Properties, Shell, Target}; use crate::formatter::{StringFormatter, VariableHolder}; use crate::module::Module; use crate::module::ALL_MODULES; use crate::modules; use crate::segment::Segment; pub struct Grapheme<'a>(pub &'a str); impl<'a> Grapheme<'a> { pub fn width(&self) -> usize { self.0 .chars() .filter_map(UnicodeWidthChar::width) .max() .unwrap_or(0) } } pub trait UnicodeWidthGraphemes { fn width_graphemes(&self) -> usize; } impl UnicodeWidthGraphemes for T where T: AsRef, { fn width_graphemes(&self) -> usize { self.as_ref() .graphemes(true) .map(Grapheme) .map(|g| g.width()) .sum() } } #[test] fn test_grapheme_aware_width() { // UnicodeWidthStr::width would return 8 assert_eq!(2, "👩‍👩‍👦‍👦".width_graphemes()); assert_eq!(1, "Ü".width_graphemes()); assert_eq!(11, "normal text".width_graphemes()); } pub fn prompt(args: Properties, target: Target) { let context = Context::new(args, target); let stdout = io::stdout(); let mut handle = stdout.lock(); write!(handle, "{}", get_prompt(context)).unwrap(); } pub fn get_prompt(context: Context) -> String { let config = &context.root_config; let mut buf = String::new(); match std::env::var_os("TERM") { Some(term) if term == "dumb" => { log::error!("Under a 'dumb' terminal (TERM=dumb)."); buf.push_str("Starship disabled due to TERM=dumb > "); return buf; } _ => {} } // A workaround for a fish bug (see #739,#279). Applying it to all shells // breaks things (see #808,#824,#834). Should only be printed in fish. if Shell::Fish == context.shell && context.target == Target::Main { buf.push_str("\x1b[J"); // An ASCII control code to clear screen } let (formatter, modules) = load_formatter_and_modules(&context); let formatter = formatter.map_variables_to_segments(|module| { // Make $all display all modules not explicitly referenced if module == "all" { Some(Ok(all_modules_uniq(&modules) .par_iter() .flat_map(|module| { handle_module(module, &context, &modules) .into_iter() .flat_map(|module| module.segments) .collect::>() }) .collect::>())) } else if context.is_module_disabled_in_config(module) { None } else { // Get segments from module Some(Ok(handle_module(module, &context, &modules) .into_iter() .flat_map(|module| module.segments) .collect::>())) } }); // Creates a root module and prints it. let mut root_module = Module::new("Starship Root", "The root module", None); root_module.set_segments( formatter .parse(None, Some(&context)) .expect("Unexpected error returned in root format variables"), ); let module_strings = root_module.ansi_strings_for_shell(context.shell, Some(context.width)); if config.add_newline && context.target != Target::Continuation { // continuation prompts normally do not include newlines, but they can writeln!(buf).unwrap(); } write!(buf, "{}", ANSIStrings(&module_strings)).unwrap(); if context.target == Target::Right { // right prompts generally do not allow newlines buf = buf.replace('\n', ""); } // escape \n and ! characters for tcsh if let Shell::Tcsh = context.shell { buf = buf.replace('!', "\\!"); // space is required before newline buf = buf.replace('\n', " \\n"); } buf } pub fn module(module_name: &str, args: Properties) { let context = Context::new(args, Target::Main); let module = get_module(module_name, context).unwrap_or_default(); print!("{}", module); } pub fn get_module(module_name: &str, context: Context) -> Option { modules::handle(module_name, &context).map(|m| m.to_string()) } pub fn timings(args: Properties) { let context = Context::new(args, Target::Main); struct ModuleTiming { name: String, name_len: usize, value: String, duration: Duration, duration_len: usize, } let mut modules = compute_modules(&context) .iter() .filter(|module| !module.is_empty() || module.duration.as_millis() > 0) .map(|module| ModuleTiming { name: String::from(module.get_name().as_str()), name_len: module.get_name().width_graphemes(), value: ansi_term::ANSIStrings(&module.ansi_strings()) .to_string() .replace('\n', "\\n"), duration: module.duration, duration_len: format_duration(&module.duration).width_graphemes(), }) .collect::>(); modules.sort_by(|a, b| b.duration.cmp(&a.duration)); let max_name_width = modules.iter().map(|i| i.name_len).max().unwrap_or(0); let max_duration_width = modules.iter().map(|i| i.duration_len).max().unwrap_or(0); println!("\n Here are the timings of modules in your prompt (>=1ms or output):"); // for now we do not expect a wrap around at the end... famous last words // Overall a line looks like this: " {module name} - {duration} - "{module value}"". for timing in &modules { println!( " {}{} - {}{} - \"{}\"", timing.name, " ".repeat(max_name_width - (timing.name_len)), " ".repeat(max_duration_width - (timing.duration_len)), format_duration(&timing.duration), timing.value ); } } pub fn explain(args: Properties) { let context = Context::new(args, Target::Main); struct ModuleInfo { value: String, value_len: usize, desc: String, duration: String, } static DONT_PRINT: &[&str] = &["line_break"]; let modules = compute_modules(&context) .into_iter() .filter(|module| !DONT_PRINT.contains(&module.get_name().as_str())) // this contains empty modules which should not print .filter(|module| !module.is_empty()) .map(|module| { let value = module.get_segments().join(""); ModuleInfo { value: ansi_term::ANSIStrings(&module.ansi_strings()).to_string(), value_len: value.width_graphemes() + format_duration(&module.duration).width_graphemes(), desc: module.get_description().clone(), duration: format_duration(&module.duration), } }) .collect::>(); let max_module_width = modules.iter().map(|i| i.value_len).max().unwrap_or(0); // In addition to the module width itself there are also 11 padding characters in each line. // Overall a line looks like this: " "{module value}" ({xxxms}) - {description}". const PADDING_WIDTH: usize = 11; let desc_width = terminal_size() .map(|(w, _)| w.0 as usize) // Add padding length to module length to avoid text overflow. This line also assures desc_width >= 0. .map(|width| width - std::cmp::min(width, max_module_width + PADDING_WIDTH)); println!("\n Here's a breakdown of your prompt:"); for info in modules { if let Some(desc_width) = desc_width { // Custom Textwrapping! let mut current_pos = 0; let mut escaping = false; // Print info print!( " \"{}\" ({}){} - ", info.value, info.duration, " ".repeat(max_module_width - (info.value_len)) ); for g in info.desc.graphemes(true) { // Handle ANSI escape sequnces if g == "\x1B" { escaping = true; } if escaping { print!("{}", g); escaping = !(("a"..="z").contains(&g) || ("A"..="Z").contains(&g)); continue; } // Handle normal wrapping current_pos += Grapheme(g).width(); // Wrap when hitting max width or newline if g == "\n" || current_pos > desc_width { // trim spaces on linebreak if g == " " && desc_width > 1 { continue; } print!("\n{}", " ".repeat(max_module_width + PADDING_WIDTH)); if g == "\n" { current_pos = 0; continue; } current_pos = 1; } print!("{}", g); } println!(); } else { println!( " {}{} - {}", info.value, " ".repeat(max_module_width - info.value_len), info.desc, ); }; } } fn compute_modules<'a>(context: &'a Context) -> Vec> { let mut prompt_order: Vec> = Vec::new(); let (_formatter, modules) = load_formatter_and_modules(context); for module in &modules { // Manually add all modules if `$all` is encountered if module == "all" { for module in all_modules_uniq(&modules) { let modules = handle_module(&module, context, &modules); prompt_order.extend(modules); } } else { let modules = handle_module(module, context, &modules); prompt_order.extend(modules); } } prompt_order } fn handle_module<'a>( module: &str, context: &'a Context, module_list: &BTreeSet, ) -> Vec> { struct DebugCustomModules<'tmp>(&'tmp toml::value::Table); impl Debug for DebugCustomModules<'_> { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { f.debug_list().entries(self.0.keys()).finish() } } let mut modules: Vec = Vec::new(); if ALL_MODULES.contains(&module) { // Write out a module if it isn't disabled if !context.is_module_disabled_in_config(module) { modules.extend(modules::handle(module, context)); } } else if module == "custom" { // Write out all custom modules, except for those that are explicitly set if let Some(custom_modules) = context.config.get_custom_modules() { let custom_modules = custom_modules.iter().filter_map(|(custom_module, config)| { if should_add_implicit_custom_module(custom_module, config, module_list) { modules::custom::module(custom_module, context) } else { None } }); modules.extend(custom_modules); } } else if let Some(module) = module.strip_prefix("custom.") { // Write out a custom module if it isn't disabled (and it exists...) match context.is_custom_module_disabled_in_config(module) { Some(true) => (), // Module is disabled, we don't add it to the prompt Some(false) => modules.extend(modules::custom::module(module, context)), None => match context.config.get_custom_modules() { Some(modules) => log::debug!( "top level format contains custom module \"{}\", but no configuration was provided. Configuration for the following modules were provided: {:?}", module, DebugCustomModules(modules), ), None => log::debug!( "top level format contains custom module \"{}\", but no configuration was provided.", module, ), }, } } else { log::debug!( "Expected top level format to contain value from {:?}. Instead received {}", ALL_MODULES, module, ); } modules } fn should_add_implicit_custom_module( custom_module: &str, config: &toml::Value, module_list: &BTreeSet, ) -> bool { let explicit_module_name = format!("custom.{}", custom_module); let is_explicitly_specified = module_list.contains(&explicit_module_name); if is_explicitly_specified { // The module is already specified explicitly, so we skip it return false; } let false_value = toml::Value::Boolean(false); !config .get("disabled") .unwrap_or(&false_value) .as_bool() .unwrap_or(false) } pub fn format_duration(duration: &Duration) -> String { let milis = duration.as_millis(); if milis == 0 { "<1ms".to_string() } else { format!("{:?}ms", &milis) } } /// Return the modules from $all that are not already in the list fn all_modules_uniq(module_list: &BTreeSet) -> Vec { let mut prompt_order: Vec = Vec::new(); for module in PROMPT_ORDER.iter() { if !module_list.contains(*module) { prompt_order.push(String::from(*module)) } } prompt_order } /// Load the correct formatter for the context (ie left prompt or right prompt) /// and the list of all modules used in a format string fn load_formatter_and_modules<'a>(context: &'a Context) -> (StringFormatter<'a>, BTreeSet) { let config = &context.root_config; let lformatter = StringFormatter::new(&config.format); let rformatter = StringFormatter::new(&config.right_format); let cformatter = StringFormatter::new(&config.continuation_prompt); if lformatter.is_err() { log::error!("Error parsing `format`") } if rformatter.is_err() { log::error!("Error parsing `right_format`") } if cformatter.is_err() { log::error!("Error parsing `continuation_prompt`") } match (lformatter, rformatter, cformatter) { (Ok(lf), Ok(rf), Ok(cf)) => { let mut modules: BTreeSet = BTreeSet::new(); if context.target != Target::Continuation { modules.extend(lf.get_variables()); modules.extend(rf.get_variables()); } match context.target { Target::Main => (lf, modules), Target::Right => (rf, modules), Target::Continuation => (cf, modules), } } _ => (StringFormatter::raw(">"), BTreeSet::new()), } } #[cfg(test)] mod test { use super::*; use crate::config::StarshipConfig; use crate::test::default_context; #[test] fn right_prompt() { let mut context = default_context(); context.config = StarshipConfig { config: Some(toml::toml! { right_format="$character" [character] format=">\n>" }), }; context.root_config.right_format = "$character".to_string(); context.target = Target::Right; let expected = String::from(">>"); // should strip new lines let actual = get_prompt(context); assert_eq!(expected, actual); } #[test] fn continuation_prompt() { let mut context = default_context(); context.config = StarshipConfig { config: Some(toml::toml! { continuation_prompt="><>" }), }; context.root_config.continuation_prompt = "><>".to_string(); context.target = Target::Continuation; let expected = String::from("><>"); let actual = get_prompt(context); assert_eq!(expected, actual); } }