pavex_cli_shell 0.2.10

An internal crate to share a global shel instance between Pavex's CLIs and their library dependencies.
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

use cargo_like_utils::shell::Shell;
use std::{
    fmt::Display,
    sync::{Arc, Mutex, OnceLock},
};

/// A global shell instance used by Pavex CLIs to print messages to the user.
pub static SHELL: OnceLock<Arc<Mutex<Shell>>> = OnceLock::new();

/// Customize how messages are shown in the shell.
pub mod style {
    pub use cargo_like_utils::shell::style::*;
}

/// Initialize the global shell instance, if it hasn't been initialized yet.
pub fn try_init_shell(shell: Shell) {
    SHELL.get_or_init(|| Arc::new(Mutex::new(shell)));
}

pub trait ShellExt {
    fn status<T, U>(&self, status: T, message: U)
    where
        T: Display,
        U: Display;
    fn status_with_color<T, U>(&self, status: T, message: U, color: &style::Style)
    where
        T: Display,
        U: Display;
    fn note<T: Display>(&self, message: T);
    fn warn<T: Display>(&self, message: T);
    fn error<T: Display>(&self, message: T);
}

impl ShellExt for OnceLock<Arc<Mutex<Shell>>> {
    fn status<T, U>(&self, status: T, message: U)
    where
        T: Display,
        U: Display,
    {
        if let Some(s) = self.get() {
            let _ = s.lock().unwrap().status(status, message);
        }
    }

    fn status_with_color<T, U>(&self, status: T, message: U, color: &style::Style)
    where
        T: Display,
        U: Display,
    {
        if let Some(s) = self.get() {
            let _ = s.lock().unwrap().status_with_color(status, message, color);
        }
    }

    fn note<T: Display>(&self, message: T) {
        if let Some(s) = self.get() {
            let _ = s.lock().unwrap().note(message);
        }
    }

    fn warn<T: Display>(&self, message: T) {
        if let Some(s) = self.get() {
            let _ = s.lock().unwrap().warn(message);
        }
    }

    fn error<T: Display>(&self, message: T) {
        if let Some(s) = self.get() {
            let _ = s.lock().unwrap().error(message);
        }
    }
}