ui.rs 83.1%

152 of 183 lines run, 57 of 97 functions · run #325 on main · run missed

//! Terminal presentation: colour, emphasis, and a live spinner while a
//! command works. Everything degrades to plain text when stdout is not a
//! terminal, when `NO_COLOR` is set, or with `--plain`.

use console::{style, StyledObject, Term};
use indicatif::{ProgressBar, ProgressStyle};
use std::sync::atomic::{AtomicBool, Ordering};
use std::time::Duration;

static PLAIN: AtomicBool = AtomicBool::new(false);
static UNICODE: AtomicBool = AtomicBool::new(false);
static INIT: std::sync::Once = std::sync::Once::new();

/// Decide once whether to use colour, glyphs, and animation.
pub fn init(plain_flag: bool) {
    INIT.call_once(|| {
        let no_color = std::env::var_os("NO_COLOR").is_some();
        let tty = Term::stdout().features().is_attended();
        let plain = plain_flag || no_color || !tty;
        PLAIN.store(plain, Ordering::Relaxed);
        console::set_colors_enabled(!plain);
        let utf8 = ["LC_ALL", "LC_CTYPE", "LANG"]
            .iter()
            .filter_map(|k| std::env::var(k).ok())
            .find(|v| !v.is_empty())
            .map(|v| {
                v.to_ascii_uppercase().contains("UTF-8") || v.to_ascii_uppercase().contains("UTF8")
            })
            .unwrap_or(false);
        UNICODE.store(!plain && utf8, Ordering::Relaxed);
    });
}

pub fn plain() -> bool {
    PLAIN.load(Ordering::Relaxed)
}

/// Whether the terminal takes Unicode glyphs (a UTF-8 locale, not `--plain`).
pub fn unicode() -> bool {
    UNICODE.load(Ordering::Relaxed)
}

/// A glyph with an ASCII fallback for plain output and non-UTF-8 locales.
pub fn glyph<'a>(fancy: &'a str, ascii: &'a str) -> &'a str {
    if unicode() {
        fancy
    } else {
        ascii
    }
}

/// A finished action: a tick and the verb in green.
pub fn done<T: std::fmt::Display>(v: T) -> String {
    format!("{} {}", ok(glyph("✔", "*")), ok(v))
}

/// A warning line prefix.
pub fn caution() -> String {
    warn(glyph("⚠", "!"))
}

/// An informational note prefix.
pub fn note() -> String {
    dim(glyph("›", ">"))
}

/// A section title.
pub fn section<T: std::fmt::Display>(v: T) -> String {
    format!("{} {}", s(glyph("▍", "#")).cyan(), s(v).bold())
}

/// `  key   value`, with the key dimmed and padded.
pub fn kv<T: std::fmt::Display>(key: &str, value: T) -> String {
    format!("  {} {value}", dim(format!("{key:<8}")))
}

/// An author name.
pub fn author<T: std::fmt::Display>(v: T) -> String {
    s(v).magenta().to_string()
}

/// A bookmark or reference name.
pub fn bookmark<T: std::fmt::Display>(v: T) -> String {
    s(v).green().bold().to_string()
}

/// The subject line of a message.
pub fn subject<T: std::fmt::Display>(v: T) -> String {
    s(v).bold().to_string()
}

/// A dimmed separator between the parts of a metadata line.
pub fn sep() -> String {
    dim(format!(" {} ", glyph("·", "-")))
}

/// Milliseconds since the epoch as a relative time ("3 minutes ago"), or the
/// date when older than a month.
pub fn ago(ms: u64) -> String {
    let now = std::time::SystemTime::now()
        .duration_since(std::time::UNIX_EPOCH)
        .map(|d| d.as_millis() as u64)
        .unwrap_or(0);
    let secs = now.saturating_sub(ms) / 1000;
    let unit = |n: u64, w: &str| format!("{n} {w}{} ago", if n == 1 { "" } else { "s" });
    match secs {
        0..=44 => "just now".into(),
        45..=89 => "a minute ago".into(),
        90..=2_699 => unit(secs.div_ceil(60), "minute"),
        2_700..=5_399 => "an hour ago".into(),
        5_400..=79_199 => unit(secs.div_ceil(3_600), "hour"),
        79_200..=129_599 => "yesterday".into(),
        129_600..=2_591_999 => unit(secs.div_ceil(86_400), "day"),
        _ => super::format::when(ms)
            .split(' ')
            .next()
            .unwrap_or("")
            .to_string(),
    }
}

/// The bullet for a log entry: the working copy, a head, or an ordinary change.
pub fn log_bullet(working_copy: bool, head: bool, conflicted: bool) -> String {
    if working_copy {
        s(glyph("◉", "@")).cyan().bold().to_string()
    } else if conflicted {
        err(glyph("✱", "!"))
    } else if head {
        ok(glyph("●", "*"))
    } else {
        dim(glyph("○", "o"))
    }
}

/// A status glyph and word for a working-copy change.
pub fn status_mark(tag: &str) -> String {
    let (g, a, word) = match tag {
        "A" => ("✚", "+", "added"),
        "M" => ("✎", "~", "modified"),
        "D" => ("✖", "-", "removed"),
        "X" => ("⚙", "x", "mode"),
        "C!" => ("‼", "!", "markers"),
        "R" => ("➜", ">", "renamed"),
        "V" => ("✔", "r", "resolved"),
        _ => ("?", "?", "unknown"),
    };
    let text = format!("{} {word:<9}", glyph(g, a));
    self::tag_style(tag, &text)
}

fn tag_style(t: &str, text: &str) -> String {
    match t {
        "A" | "V" => s(text).green().to_string(),
        "R" => s(text).cyan().to_string(),
        "M" | "X" => s(text).yellow().to_string(),
        "D" | "C!" => s(text).red().to_string(),
        _ => text.to_string(),
    }
}

fn s<T: std::fmt::Display>(v: T) -> StyledObject<T> {
    style(v)
}

/// A ChangeId prefix.
pub fn id<T: std::fmt::Display>(v: T) -> String {
    s(v).cyan().bold().to_string()
}
/// A hash prefix.
pub fn hash<T: std::fmt::Display>(v: T) -> String {
    s(v).dim().to_string()
}
pub fn path<T: std::fmt::Display>(v: T) -> String {
    s(v).bold().to_string()
}
pub fn ok<T: std::fmt::Display>(v: T) -> String {
    s(v).green().to_string()
}
pub fn warn<T: std::fmt::Display>(v: T) -> String {
    s(v).yellow().to_string()
}
pub fn err<T: std::fmt::Display>(v: T) -> String {
    s(v).red().bold().to_string()
}
pub fn dim<T: std::fmt::Display>(v: T) -> String {
    s(v).dim().to_string()
}
pub fn heading<T: std::fmt::Display>(v: T) -> String {
    s(v).bold().underlined().to_string()
}
/// A live spinner with a message, shown only on a terminal. Drop or call
/// `done` to clear it; `done` prints the final line in its place.
pub struct Spinner {
    bar: Option<ProgressBar>,
}

pub fn spinner(msg: &str) -> Spinner {
    if plain() {
        return Spinner { bar: None };
    }
    let bar = ProgressBar::new_spinner();
    bar.set_style(
        ProgressStyle::with_template("{spinner:.cyan} {msg}")
            .unwrap()
            .tick_strings(&["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏", " "]),
    );
    bar.set_message(msg.to_string());
    bar.enable_steady_tick(Duration::from_millis(80));
    Spinner { bar: Some(bar) }
}

impl Spinner {
    /// Replace the spinner with a final line (or print it plainly). The
    /// line is printed as given: callers start it with their own mark.
    pub fn done(self, msg: &str) {
        if let Some(b) = &self.bar {
            b.finish_and_clear();
        }
        println!("{msg}");
    }
    /// Say what is happening now: the spinner's message, or, with no
    /// terminal, a line on stderr, so a long command is never silent.
    pub fn set(&self, msg: &str) {
        match &self.bar {
            Some(b) => b.set_message(msg.to_string()),
            None => eprintln!("{} {msg}", dim(glyph("›", ">"))),
        }
    }
    /// Clear the spinner without printing.
    pub fn clear(self) {
        if let Some(b) = &self.bar {
            b.finish_and_clear();
        }
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn relative_times() {
        let now = std::time::SystemTime::now()
            .duration_since(std::time::UNIX_EPOCH)
            .unwrap()
            .as_millis() as u64;
        assert_eq!(ago(now), "just now");
        assert_eq!(ago(now - 60_000), "a minute ago");
        assert_eq!(ago(now - 5 * 60_000), "5 minutes ago");
        assert_eq!(ago(now - 3 * 3_600_000), "3 hours ago");
        assert_eq!(ago(now - 25 * 3_600_000), "yesterday");
        assert_eq!(ago(now - 4 * 86_400_000), "4 days ago");
        assert_eq!(ago(0), "1970-01-01");
        assert_eq!(glyph("✔", "*"), if unicode() { "✔" } else { "*" });
    }
}

`/`	Search
`g` `c`	Code
`g` `h`	History
`g` `b`	Bookmarks
`g` `t`	Trust
`y`	Permalink to this state (files and trees)
`?`	This sheet

1		//! Terminal presentation: colour, emphasis, and a live spinner while a
2		//! command works. Everything degrades to plain text when stdout is not a
3		//! terminal, when `NO_COLOR` is set, or with `--plain`.
4
5		use console::{style, StyledObject, Term};
6		use indicatif::{ProgressBar, ProgressStyle};
7		use std::sync::atomic::{AtomicBool, Ordering};
8		use std::time::Duration;
9
10		static PLAIN: AtomicBool = AtomicBool::new(false);
11		static UNICODE: AtomicBool = AtomicBool::new(false);
12		static INIT: std::sync::Once = std::sync::Once::new();
13
14		/// Decide once whether to use colour, glyphs, and animation.
15	157×	pub fn init(plain_flag: bool) {
16	157×	INIT.call_once(\|\| {
17	149×	let no_color = std::env::var_os("NO_COLOR").is_some();
18	149×	let tty = Term::stdout().features().is_attended();
19	149×	let plain = plain_flag \|\| no_color \|\| !tty;
20	149×	PLAIN.store(plain, Ordering::Relaxed);
21	149×	console::set_colors_enabled(!plain);
22	149×	let utf8 = ["LC_ALL", "LC_CTYPE", "LANG"]
23	149×	.iter()
24	447×	.filter_map(\|k\| std::env::var(k).ok())
25	149×	.find(\|v\| !v.is_empty())
26	149×	.map(\|v\| {
27	0×	v.to_ascii_uppercase().contains("UTF-8") \|\| v.to_ascii_uppercase().contains("UTF8")
28	0×	})
29	149×	.unwrap_or(false);
30	149×	UNICODE.store(!plain && utf8, Ordering::Relaxed);
31	149×	});
32	157×	}
33
34	59×	pub fn plain() -> bool {
35	59×	PLAIN.load(Ordering::Relaxed)
36	59×	}
37
38		/// Whether the terminal takes Unicode glyphs (a UTF-8 locale, not `--plain`).
39	191×	pub fn unicode() -> bool {
40	191×	UNICODE.load(Ordering::Relaxed)
41	191×	}
42
43		/// A glyph with an ASCII fallback for plain output and non-UTF-8 locales.
44	190×	pub fn glyph<'a>(fancy: &'a str, ascii: &'a str) -> &'a str {
45	190×	if unicode() {
46	0×	fancy
47		} else {
48	190×	ascii
49		}
50	190×	}
51
52		/// A finished action: a tick and the verb in green.
53	88×	pub fn done<T: std::fmt::Display>(v: T) -> String {
54	88×	format!("{} {}", ok(glyph("✔", "*")), ok(v))
55	88×	}
56
57		/// A warning line prefix.
58	3×	pub fn caution() -> String {
59	3×	warn(glyph("⚠", "!"))
60	3×	}
61
62		/// An informational note prefix.
63	17×	pub fn note() -> String {
64	17×	dim(glyph("›", ">"))
65	17×	}
66
67		/// A section title.
68	3×	pub fn section<T: std::fmt::Display>(v: T) -> String {
69	3×	format!("{} {}", s(glyph("▍", "#")).cyan(), s(v).bold())
70	3×	}
71
72		/// ` key value`, with the key dimmed and padded.
73	42×	pub fn kv<T: std::fmt::Display>(key: &str, value: T) -> String {
74	42×	format!(" {} {value}", dim(format!("{key:<8}")))
75	42×	}
76
77		/// An author name.
78	23×	pub fn author<T: std::fmt::Display>(v: T) -> String {
79	23×	s(v).magenta().to_string()
80	23×	}
81
82		/// A bookmark or reference name.
83	78×	pub fn bookmark<T: std::fmt::Display>(v: T) -> String {
84	78×	s(v).green().bold().to_string()
85	78×	}
86
87		/// The subject line of a message.
88	28×	pub fn subject<T: std::fmt::Display>(v: T) -> String {
89	28×	s(v).bold().to_string()
90	28×	}
91
92		/// A dimmed separator between the parts of a metadata line.
93	20×	pub fn sep() -> String {
94	20×	dim(format!(" {} ", glyph("·", "-")))
95	20×	}
96
97		/// Milliseconds since the epoch as a relative time ("3 minutes ago"), or the
98		/// date when older than a month.
99	13×	pub fn ago(ms: u64) -> String {
100	13×	let now = std::time::SystemTime::now()
101	13×	.duration_since(std::time::UNIX_EPOCH)
102	13×	.map(\|d\| d.as_millis() as u64)
103	13×	.unwrap_or(0);
104	13×	let secs = now.saturating_sub(ms) / 1000;
105	13×	let unit = \|n: u64, w: &str\| format!("{n} {w}{} ago", if n == 1 { "" } else { "s" });
106	13×	match secs {
107	13×	0..=44 => "just now".into(),
108	6×	45..=89 => "a minute ago".into(),
109	5×	90..=2_699 => unit(secs.div_ceil(60), "minute"),
110	4×	2_700..=5_399 => "an hour ago".into(),
111	4×	5_400..=79_199 => unit(secs.div_ceil(3_600), "hour"),
112	3×	79_200..=129_599 => "yesterday".into(),
113	2×	129_600..=2_591_999 => unit(secs.div_ceil(86_400), "day"),
114	1×	_ => super::format::when(ms)
115	1×	.split(' ')
116	1×	.next()
117	1×	.unwrap_or("")
118	1×	.to_string(),
119		}
120	13×	}
121
122		/// The bullet for a log entry: the working copy, a head, or an ordinary change.
123	4×	pub fn log_bullet(working_copy: bool, head: bool, conflicted: bool) -> String {
124	4×	if working_copy {
125	1×	s(glyph("◉", "@")).cyan().bold().to_string()
126	3×	} else if conflicted {
127	0×	err(glyph("✱", "!"))
128	3×	} else if head {
129	2×	ok(glyph("●", "*"))
130		} else {
131	1×	dim(glyph("○", "o"))
132		}
133	4×	}
134
135		/// A status glyph and word for a working-copy change.
136	2×	pub fn status_mark(tag: &str) -> String {
137	2×	let (g, a, word) = match tag {
138	2×	"A" => ("✚", "+", "added"),
139	1×	"M" => ("✎", "~", "modified"),
140	1×	"D" => ("✖", "-", "removed"),
141	1×	"X" => ("⚙", "x", "mode"),
142	0×	"C!" => ("‼", "!", "markers"),
143	0×	"R" => ("➜", ">", "renamed"),
144	0×	"V" => ("✔", "r", "resolved"),
145	0×	_ => ("?", "?", "unknown"),
146		};
147	2×	let text = format!("{} {word:<9}", glyph(g, a));
148	2×	self::tag_style(tag, &text)
149	2×	}
150
151	2×	fn tag_style(t: &str, text: &str) -> String {
152	2×	match t {
153	2×	"A" \| "V" => s(text).green().to_string(),
154	1×	"R" => s(text).cyan().to_string(),
155	1×	"M" \| "X" => s(text).yellow().to_string(),
156	0×	"D" \| "C!" => s(text).red().to_string(),
157	0×	_ => text.to_string(),
158		}
159	2×	}
160
161	776×	fn s<T: std::fmt::Display>(v: T) -> StyledObject<T> {
162	776×	style(v)
163	776×	}
164
165		/// A ChangeId prefix.
166	103×	pub fn id<T: std::fmt::Display>(v: T) -> String {
167	103×	s(v).cyan().bold().to_string()
168	103×	}
169		/// A hash prefix.
170	40×	pub fn hash<T: std::fmt::Display>(v: T) -> String {
171	40×	s(v).dim().to_string()
172	40×	}
173	28×	pub fn path<T: std::fmt::Display>(v: T) -> String {
174	28×	s(v).bold().to_string()
175	28×	}
176	207×	pub fn ok<T: std::fmt::Display>(v: T) -> String {
177	207×	s(v).green().to_string()
178	207×	}
179	6×	pub fn warn<T: std::fmt::Display>(v: T) -> String {
180	6×	s(v).yellow().to_string()
181	6×	}
182	10×	pub fn err<T: std::fmt::Display>(v: T) -> String {
183	10×	s(v).red().bold().to_string()
184	10×	}
185	244×	pub fn dim<T: std::fmt::Display>(v: T) -> String {
186	244×	s(v).dim().to_string()
187	244×	}
188	0×	pub fn heading<T: std::fmt::Display>(v: T) -> String {
189	0×	s(v).bold().underlined().to_string()
190	0×	}
191		/// A live spinner with a message, shown only on a terminal. Drop or call
192		/// `done` to clear it; `done` prints the final line in its place.
193		pub struct Spinner {
194		bar: Option<ProgressBar>,
195		}
196
197	59×	pub fn spinner(msg: &str) -> Spinner {
198	59×	if plain() {
199	59×	return Spinner { bar: None };
200	0×	}
201	0×	let bar = ProgressBar::new_spinner();
202	0×	bar.set_style(
203	0×	ProgressStyle::with_template("{spinner:.cyan} {msg}")
204	0×	.unwrap()
205	0×	.tick_strings(&["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏", " "]),
206		);
207	0×	bar.set_message(msg.to_string());
208	0×	bar.enable_steady_tick(Duration::from_millis(80));
209	0×	Spinner { bar: Some(bar) }
210	59×	}
211
212		impl Spinner {
213		/// Replace the spinner with a final line (or print it plainly). The
214		/// line is printed as given: callers start it with their own mark.
215	40×	pub fn done(self, msg: &str) {
216	40×	if let Some(b) = &self.bar {
217	0×	b.finish_and_clear();
218	40×	}
219	40×	println!("{msg}");
220	40×	}
221		/// Say what is happening now: the spinner's message, or, with no
222		/// terminal, a line on stderr, so a long command is never silent.
223	0×	pub fn set(&self, msg: &str) {
224	0×	match &self.bar {
225	0×	Some(b) => b.set_message(msg.to_string()),
226	0×	None => eprintln!("{} {msg}", dim(glyph("›", ">"))),
227		}
228	0×	}
229		/// Clear the spinner without printing.
230	17×	pub fn clear(self) {
231	17×	if let Some(b) = &self.bar {
232	0×	b.finish_and_clear();
233	17×	}
234	17×	}
235		}
236
237		#[cfg(test)]
238		mod tests {
239		use super::*;
240
241		#[test]
242	1×	fn relative_times() {
243	1×	let now = std::time::SystemTime::now()
244	1×	.duration_since(std::time::UNIX_EPOCH)
245	1×	.unwrap()
246	1×	.as_millis() as u64;
247	1×	assert_eq!(ago(now), "just now");
248	1×	assert_eq!(ago(now - 60_000), "a minute ago");
249	1×	assert_eq!(ago(now - 5 * 60_000), "5 minutes ago");
250	1×	assert_eq!(ago(now - 3 * 3_600_000), "3 hours ago");
251	1×	assert_eq!(ago(now - 25 * 3_600_000), "yesterday");
252	1×	assert_eq!(ago(now - 4 * 86_400_000), "4 days ago");
253	1×	assert_eq!(ago(0), "1970-01-01");
254	1×	assert_eq!(glyph("✔", ""), if unicode() { "✔" } else { "" });
255	1×	}
256		}

Coverage / src/cli/ui.rs 83.1%

Keyboard