cnf 0.6.1

Distribution-agnostic 'command not found'-handler
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

// SPDX-License-Identifier: GPL-3.0-or-later
// SPDX-FileCopyrightText: (C) 2023 Andreas Hartmann <hartan@7x.de>
// This file is part of cnf, available at <https://gitlab.com/hartang/rust/cnf>

//! # Simple spinner for use with [`ratatui`]
use ratatui::style::{Modifier, Style};
use ratatui::text::{Span, Spans};
use ratatui::widgets::Paragraph;
use std::time::Instant;

/// A CLI spinner.
///
/// Built for use with [`ratatui`], updates the spinning values when printed repeatedly.
#[derive(Debug)]
pub(crate) struct Spinner {
    /// [`Instant`] when this spinner was instantiated.
    start: Instant,
}

impl Spinner {
    /// Create a new instance.
    pub(crate) fn new() -> Self {
        Spinner {
            start: Instant::now(),
        }
    }

    /// Turn spinner into a [`Paragraph`].
    ///
    /// The displayed text is customized for use with `cnf`.
    pub(crate) fn display<'a>(&'a self) -> Paragraph<'a> {
        let spinner = match self.start.elapsed().as_millis() % 1000 {
            0..=249 => "-",
            250..=499 => "/",
            500..=749 => "|",
            750..=999 => "\\",
            _ => unreachable!(),
        };
        let text = Spans::from(vec![
            Span::styled(spinner, Style::default().add_modifier(Modifier::DIM)),
            Span::raw(" "),
            Span::styled(
                "waiting for remaining results...",
                Style::default().add_modifier(Modifier::DIM | Modifier::ITALIC),
            ),
            Span::raw(" "),
            Span::styled(spinner, Style::default().add_modifier(Modifier::DIM)),
        ]);
        Paragraph::new(text)
            .alignment(ratatui::layout::Alignment::Center)
            .wrap(ratatui::widgets::Wrap { trim: true })
    }
}