use indicatif::{ProgressBar, ProgressStyle};
use std::env;
use std::future::Future;
use std::io::IsTerminal;
use std::sync::atomic::{AtomicBool, Ordering};
use std::sync::LazyLock;
use std::time::Duration;
static QUIET: AtomicBool = AtomicBool::new(false);
static VERBOSE: AtomicBool = AtomicBool::new(false);
static STDERR_IS_TERMINAL: LazyLock<bool> = LazyLock::new(|| std::io::stderr().is_terminal());
static USE_COLOR: LazyLock<bool> = LazyLock::new(|| {
if env::var_os("CLICOLOR_FORCE")
.map(|v| v != "0")
.unwrap_or(false)
{
return true;
}
if env::var_os("NO_COLOR").is_some() {
return false;
}
if let Some(val) = env::var_os("CLICOLOR")
&& val == "0"
{
return false;
}
*STDERR_IS_TERMINAL
});
static SPINNER_STYLE: LazyLock<ProgressStyle> = LazyLock::new(|| {
ProgressStyle::default_spinner()
.tick_chars("⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏")
.template("{spinner:.green} {msg}")
.expect("Valid spinner template")
});
pub struct Ui;
impl Ui {
pub fn set_quiet(quiet: bool) {
QUIET.store(quiet, Ordering::Relaxed);
}
pub fn is_quiet() -> bool {
QUIET.load(Ordering::Relaxed)
}
pub fn set_verbose(verbose: bool) {
VERBOSE.store(verbose, Ordering::Relaxed);
}
pub fn is_verbose() -> bool {
VERBOSE.load(Ordering::Relaxed)
}
pub fn use_color() -> bool {
*USE_COLOR
}
pub fn spinner(message: impl Into<std::borrow::Cow<'static, str>>) -> ProgressBar {
if Self::is_quiet() || !*STDERR_IS_TERMINAL {
return ProgressBar::hidden();
}
let pb = ProgressBar::new_spinner();
pb.set_style(SPINNER_STYLE.clone());
pb.set_message(message);
pb.enable_steady_tick(Duration::from_millis(80));
pb
}
pub fn finish_spinner(pb: &ProgressBar, message: &str) {
pb.finish_and_clear();
Self::success(message);
}
pub async fn with_spinner<T, E, F>(
start_message: &'static str,
done_message: &str,
fut: F,
) -> Result<T, E>
where
F: Future<Output = Result<T, E>>,
{
let pb = Self::spinner(start_message);
match fut.await {
Ok(val) => {
Self::finish_spinner(&pb, done_message);
Ok(val)
}
Err(err) => {
pb.finish_and_clear();
Err(err)
}
}
}
pub fn header(title: &str) {
if Self::is_quiet() {
return;
}
let safe_title = sanitize_title(title);
if Self::use_color() {
eprintln!("\n\x1b[1;36m=== {} ===\x1b[0m\n", safe_title);
} else {
eprintln!("\n=== {} ===\n", safe_title);
}
}
pub fn info(message: &str) {
if !Self::is_quiet() {
Self::print_styled("ℹ", "1;34", message);
}
}
pub fn success(message: &str) {
if !Self::is_quiet() {
Self::print_styled("✔", "1;32", message);
}
}
pub fn warn(message: &str) {
if !Self::is_quiet() {
Self::print_styled("⚠", "1;33", message);
}
}
pub fn error(message: &str) {
Self::print_styled("✖", "1;31", message);
}
pub fn verbose(message: &str) {
if Self::is_verbose() {
Self::print_styled("[debug]", "1;35", message);
}
}
fn print_styled(symbol: &str, color_code: &str, message: &str) {
let safe_msg = sanitize_terminal_text(message);
if Self::use_color() {
eprintln!("\x1b[{color_code}m{symbol}\x1b[0m {safe_msg}");
} else {
eprintln!("{symbol} {safe_msg}");
}
}
}
#[inline]
fn is_bidi_control(c: char) -> bool {
matches!(
c,
'\u{202A}'..='\u{202E}' | '\u{2066}'..='\u{2069}' | '\u{200E}' | '\u{200F}' | '\u{061C}'
)
}
pub fn sanitize_terminal_text(input: &str) -> String {
let has_suspicious = input.chars().any(|c| {
c == '\x1b'
|| (c.is_control() && c != '\n' && c != '\t')
|| is_bidi_control(c)
|| matches!(
c,
'\u{0090}' | '\u{0098}' | '\u{009B}' | '\u{009D}' | '\u{009E}' | '\u{009F}'
)
});
if !has_suspicious {
return input.to_string();
}
let mut clean = String::with_capacity(input.len());
let mut chars = input.chars().peekable();
while let Some(ch) = chars.next() {
if ch == '\x1b' {
match chars.peek() {
Some('[') => {
chars.next(); for c in chars.by_ref() {
if ('@'..='~').contains(&c) {
break;
}
}
}
Some(']' | 'P' | 'X' | '^' | '_') => {
chars.next(); let mut prev = '\0';
for c in chars.by_ref() {
if c == '\x07' || c == '\u{009C}' || (prev == '\x1b' && c == '\\') {
break;
}
prev = c;
}
}
Some(_) => {
chars.next();
}
None => {}
}
continue;
}
if ch == '\u{009B}' {
for c in chars.by_ref() {
if ('@'..='~').contains(&c) {
break;
}
}
continue;
}
if matches!(
ch,
'\u{0090}' | '\u{0098}' | '\u{009D}' | '\u{009E}' | '\u{009F}'
) {
let mut prev = '\0';
for c in chars.by_ref() {
if c == '\x07' || c == '\u{009C}' || (prev == '\x1b' && c == '\\') {
break;
}
prev = c;
}
continue;
}
if (ch.is_control() && ch != '\n' && ch != '\t') || is_bidi_control(ch) {
continue;
}
clean.push(ch);
}
clean
}
pub fn sanitize_title(title: &str) -> String {
let sanitized = sanitize_terminal_text(title);
if !sanitized.contains('\n')
&& !sanitized.contains('\r')
&& !sanitized.contains('\t')
&& !sanitized.contains(" ")
&& !sanitized.starts_with(' ')
&& !sanitized.ends_with(' ')
{
return sanitized;
}
let mut out = String::with_capacity(sanitized.len());
for word in sanitized.split_whitespace() {
if !out.is_empty() {
out.push(' ');
}
out.push_str(word);
}
out
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_sanitize_terminal_text_strips_ansi_and_osc() {
let csi_injected = "Hello \x1b[31;1mRed Alert\x1b[0m World";
assert_eq!(sanitize_terminal_text(csi_injected), "Hello Red Alert World");
let osc_injected = "Normal \x1b]0;Evil Title\x07Text";
assert_eq!(sanitize_terminal_text(osc_injected), "Normal Text");
let control_chars = "Line\x00with\x08bell\x07and\x1bsome chars";
assert_eq!(sanitize_terminal_text(control_chars), "Linewithbellandome chars");
}
#[test]
fn test_sanitize_terminal_text_strips_c1_bidi_and_string_controls() {
let c1_csi = "Hello \u{009B}31mC1 CSI\u{009B}0m World";
assert_eq!(sanitize_terminal_text(c1_csi), "Hello C1 CSI World");
let c1_osc = "Start \u{009D}0;Evil Title\u{009C} End";
assert_eq!(sanitize_terminal_text(c1_osc), "Start End");
let dcs_seq = "DCS \x1bP123;cmd\x1b\\Payload";
assert_eq!(sanitize_terminal_text(dcs_seq), "DCS Payload");
let apc_seq = "APC \x1b_secret\x07Data";
assert_eq!(sanitize_terminal_text(apc_seq), "APC Data");
let bidi_text = "Benign \u{202E}gnineB\u{202C} Text \u{2067}RLI\u{2069}";
assert_eq!(sanitize_terminal_text(bidi_text), "Benign gnineB Text RLI");
}
#[test]
fn test_sanitize_title_collapses_newlines() {
let raw_title = "\x1b[1mImportant\x1b[0m\nDocument\r\nTitle";
assert_eq!(sanitize_title(raw_title), "Important Document Title");
let bidi_title = "Title \u{202E}with \n \t BiDi\u{202C}";
assert_eq!(sanitize_title(bidi_title), "Title with BiDi");
}
}