bobatea 0.0.2

Terminal layout + styling you won't hate.
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

use {
    crate::components::Component,
    futures_signals::signal::Mutable,
    ratatui::{
        prelude::{Buffer, Frame, Rect},
        widgets::{Paragraph, Widget},
    },
    std::time::Instant,
};

/// A simple spinner that cycles through frames based on elapsed time.
struct SpinnerAnim {
    frames: &'static [&'static str],
    interval_ms: u128,
    start: Instant,
}

impl SpinnerAnim {
    fn dots() -> Self {
        Self {
            frames: &["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"], interval_ms: 80, start: Instant::now()
        }
    }

    fn line() -> Self { Self { frames: &["-", "\\", "|", "/"], interval_ms: 120, start: Instant::now() } }

    fn mini() -> Self {
        Self {
            frames: &["⠋", "⠙", "⠚", "⠞", "⠖", "⠦", "⠴", "⠲", "⠐"], interval_ms: 100, start: Instant::now()
        }
    }

    fn frame(&self) -> &'static str {
        let idx = (self.start.elapsed().as_millis() / self.interval_ms) as usize % self.frames.len();
        self.frames[idx]
    }
}

/// A loading spinner component.
///
/// ```rust
/// use bobatea::components::spinner::Spinner;
/// let spinner = Spinner::dots();
/// ```
pub struct Spinner {
    anim: SpinnerAnim,
    label: Mutable<Option<String>>,
}

impl Spinner {
    pub fn dots() -> Self { Self { anim: SpinnerAnim::dots(), label: Mutable::new(None) } }

    pub fn line() -> Self { Self { anim: SpinnerAnim::line(), label: Mutable::new(None) } }

    pub fn mini() -> Self { Self { anim: SpinnerAnim::mini(), label: Mutable::new(None) } }

    pub fn with_label(self, label: impl Into<String>) -> Self {
        self.label.set(Some(label.into()));
        self
    }

    pub fn set_label(&self, label: impl Into<String>) { self.label.set(Some(label.into())); }

    pub fn render_to_buf(&self, area: Rect, buf: &mut Buffer, theme: &crate::theme::Theme) {
        let frame = self.anim.frame();
        let text = match self.label.get_cloned() {
            Some(l) => format!("{} {}", frame, l),
            None => frame.to_string(),
        };

        Paragraph::new(text).style(ratatui::style::Style::default().fg(theme.spinner.fg)).render(area, buf);
    }
}

impl Component for Spinner {
    fn render(&mut self, ctx: &mut Frame<'_>, theme: &crate::theme::Theme) {
        let area = ctx.area();
        self.render_to_buf(area, ctx.buffer_mut(), theme);
    }
}