cliclack 0.4.0

Beautiful, minimal, opinionated CLI prompts inspired by the Clack NPM package.
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

use std::fmt::Display;
use std::io;

use console::Key;

use crate::{
    prompt::interaction::{Event, PromptInteraction, State},
    theme::THEME,
};

/// A prompt that asks for a yes or no confirmation.
///
/// * Move arrows to change the selection.
/// * `Enter` to confirm.
/// * `Y/y` for immediate "yes" answer.
/// * `N/n` for immediate "no" answer.
#[derive(Default)]
pub struct Confirm {
    prompt: String,
    input: bool,
    initial_value: bool,
}

impl Confirm {
    /// Creates a new confirmation prompt.
    pub fn new(prompt: impl Display) -> Self {
        Self {
            prompt: prompt.to_string(),
            ..Default::default()
        }
    }

    /// Sets the initially selected value (yes or no).
    pub fn initial_value(mut self, initial_value: bool) -> Self {
        self.initial_value = initial_value;
        self
    }

    /// Starts the prompt interaction.
    pub fn interact(&mut self) -> io::Result<bool> {
        self.input = self.initial_value;
        <Self as PromptInteraction<bool>>::interact(self)
    }
}

impl PromptInteraction<bool> for Confirm {
    fn on(&mut self, event: &Event) -> State<bool> {
        let Event::Key(key) = event;

        match key {
            Key::ArrowDown
            | Key::ArrowRight
            | Key::ArrowUp
            | Key::ArrowLeft
            | Key::Char('h')
            | Key::Char('k')
            | Key::Char('j')
            | Key::Char('l') => {
                self.input = !self.input;
            }
            Key::Char('y') | Key::Char('Y') => {
                self.input = true;
                return State::Submit(self.input);
            }
            Key::Char('n') | Key::Char('N') => {
                self.input = false;
                return State::Submit(self.input);
            }
            Key::Enter => return State::Submit(self.input),
            _ => {}
        }

        State::Active
    }

    fn render(&mut self, state: &State<bool>) -> String {
        let theme = THEME.read().unwrap();
        let line1 = theme.format_header(&state.into(), &self.prompt);
        let line2 = theme.format_confirm(&state.into(), self.input);
        let line3 = theme.format_footer(&state.into());

        line1 + &line2 + &line3
    }
}