audiorouter 0.1.3

Cross-platform command-line audio router with a terminal UI
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

//! UI helpers: colored, structured output for a modern CLI feel.
//!
//! All user-facing formatting lives here so that `main.rs` and `devices.rs`
//! stay focused on logic. Colors auto-disable when stderr/stdout is not a TTY
//! or when `NO_COLOR` is set (handled by the `colored` crate).

use colored::*;

/// Print an error message with a red `✗` prefix.
pub fn error(msg: impl AsRef<str>) {
    eprintln!("{} {}", "✗".red().bold(), msg.as_ref());
}

/// Print a warning message with a yellow `⚠` prefix.
pub fn warning(msg: impl AsRef<str>) {
    eprintln!("{} {}", "⚠".yellow().bold(), msg.as_ref());
}

/// Print a success/ok message with a green `✓` prefix.
pub fn success(msg: impl AsRef<str>) {
    println!("{} {}", "✓".green().bold(), msg.as_ref());
}

/// Print a section header in bold cyan.
pub fn header(text: impl AsRef<str>) {
    println!("{}", text.as_ref().cyan().bold());
}

/// Print a blank line separator.
pub fn separator() {
    println!();
}

/// Print a list item with a right-aligned detail field.
pub fn item_with_detail(name: impl AsRef<str>, detail: impl AsRef<str>) {
    println!("  {} {}", name.as_ref().bold(), detail.as_ref().dimmed());
}

/// Print a device list entry with input/output channel counts and optional sample rates.
/// Shows a marker (e.g. "(default)") in green after the entry.
pub fn device_entry(
    name: &str,
    in_channels: Option<u16>,
    out_channels: Option<u16>,
    rates: Option<&[String]>,
    marker: Option<&str>,
) {
    let ch_str = match (in_channels, out_channels) {
        (Some(i), Some(o)) => format!("{}in {}out", i, o),
        (Some(i), None) => format!("{}in", i),
        (None, Some(o)) => format!("{}out", o),
        (None, None) => String::new(),
    };
    let mut line = format!("  {} {}", name.bold(), ch_str.magenta());
    if let Some(rates) = rates
        && !rates.is_empty()
    {
        line.push_str(&format!(" {}", rates.join(", ").dimmed()));
    }
    if let Some(m) = marker {
        line.push_str(&format!(" {}", format!("({m})").green().bold()));
    }
    println!("{line}");
}

/// Print a device entry when supported configs are unavailable.
pub fn device_entry_unavailable(name: &str, marker: Option<&str>, err: &str) {
    let mut line = format!("  {} {}", name.bold(), "(configs unavailable)".dimmed());
    if let Some(m) = marker {
        line.push_str(&format!("  {}", m.green().bold()));
    }
    line.push_str(&format!("\n    {}", err.red()));
    println!("{line}");
}