opendev-tui 0.1.4

Ratatui-based terminal UI for OpenDev
Documentation 
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

//! Shared tool line construction for TUI widgets.
//!
//! Eliminates duplicated `Span` vector assembly across spinner, nested_tool,
//! tool_display, and tool_format modules.

use ratatui::{
    style::{Modifier, Style},
    text::{Line, Span},
};

use super::style_tokens;
use crate::widgets::spinner::{COMPLETED_CHAR, FAILURE_CHAR};

/// Controls verb/arg/elapsed coloring.
pub enum ToolLineStyle {
    /// Top-level tool: PRIMARY+BOLD verb, SUBTLE arg, GREY elapsed.
    Primary,
    /// Nested/subagent tool: SUBTLE verb, GREY arg, SUBTLE elapsed.
    Nested,
}

/// Format elapsed seconds consistently: `"0s"`, `"5s"`, `"1m 5s"`.
pub fn format_elapsed(secs: u64) -> String {
    if secs >= 60 {
        format!("{}m {}s", secs / 60, secs % 60)
    } else {
        format!("{secs}s")
    }
}

/// Build a `Line` for an **active** (spinning) tool.
///
/// Layout: `{prefix_spans}{spinner} {verb} {arg} {elapsed}`
pub fn tool_line_active(
    prefix_spans: Vec<Span<'static>>,
    spinner_char: char,
    verb: String,
    arg: String,
    elapsed: Option<String>,
    style: ToolLineStyle,
) -> Line<'static> {
    let mut spans = prefix_spans;

    spans.push(Span::styled(
        format!("{spinner_char} "),
        Style::default().fg(style_tokens::BLUE_BRIGHT),
    ));

    let (verb_style, arg_style, elapsed_style) = match style {
        ToolLineStyle::Primary => (
            Style::default()
                .fg(style_tokens::PRIMARY)
                .add_modifier(Modifier::BOLD),
            Style::default().fg(style_tokens::SUBTLE),
            Style::default().fg(style_tokens::GREY),
        ),
        ToolLineStyle::Nested => (
            Style::default().fg(style_tokens::SUBTLE),
            Style::default().fg(style_tokens::GREY),
            Style::default().fg(style_tokens::SUBTLE),
        ),
    };

    spans.push(Span::styled(verb, verb_style));
    spans.push(Span::styled(format!(" {arg}"), arg_style));

    if let Some(el) = elapsed {
        spans.push(Span::styled(format!(" {el}"), elapsed_style));
    }

    Line::from(spans)
}

/// Build a `Line` for a **completed** tool.
///
/// Layout: `{prefix_spans}{icon} {verb} {arg} {elapsed}`
pub fn tool_line_completed(
    prefix_spans: Vec<Span<'static>>,
    success: bool,
    verb: String,
    arg: String,
    elapsed: Option<String>,
    style: ToolLineStyle,
) -> Line<'static> {
    let mut spans = prefix_spans;

    let (icon, icon_color) = if success {
        (COMPLETED_CHAR, style_tokens::GREEN_BRIGHT)
    } else {
        (FAILURE_CHAR, style_tokens::ERROR)
    };

    spans.push(Span::styled(
        format!("{icon} "),
        Style::default().fg(icon_color),
    ));

    let (verb_style, arg_style, elapsed_style) = match style {
        ToolLineStyle::Primary => (
            Style::default()
                .fg(style_tokens::PRIMARY)
                .add_modifier(Modifier::BOLD),
            Style::default().fg(style_tokens::SUBTLE),
            Style::default().fg(style_tokens::GREY),
        ),
        ToolLineStyle::Nested => (
            Style::default().fg(style_tokens::SUBTLE),
            Style::default().fg(style_tokens::GREY),
            Style::default().fg(style_tokens::SUBTLE),
        ),
    };

    spans.push(Span::styled(verb, verb_style));
    spans.push(Span::styled(format!(" {arg}"), arg_style));

    if let Some(el) = elapsed {
        spans.push(Span::styled(format!(" {el}"), elapsed_style));
    }

    Line::from(spans)
}

#[cfg(test)]
#[path = "tool_line_tests.rs"]
mod tests;