grabcli 0.2.1

Command-line client for Grab services (GrabFood first)
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

//! Output context: human-readable lines vs. a single `--json` document, and a
//! uniform way to emit structured errors.

use std::io::{self, Write};

use grabcli_core::error::Error;

#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum Format {
    Human,
    Json,
}

#[derive(Debug, Clone, Copy)]
pub struct Output {
    pub format: Format,
}

impl Output {
    pub fn new(json: bool) -> Self {
        Self {
            format: if json { Format::Json } else { Format::Human },
        }
    }

    pub fn is_json(&self) -> bool {
        self.format == Format::Json
    }

    /// Print a value as pretty JSON (only in JSON mode).
    pub fn json(&self, value: &serde_json::Value) {
        if self.is_json()
            && let Ok(s) = serde_json::to_string_pretty(value)
        {
            println!("{s}");
        }
    }

    /// Print a human line (only in human mode).
    pub fn line(&self, text: impl AsRef<str>) {
        if !self.is_json() {
            println!("{}", text.as_ref());
        }
    }

    /// A warning on stderr (both modes, so it never corrupts `--json` stdout).
    pub fn warn(&self, text: impl AsRef<str>) {
        let _ = writeln!(io::stderr(), "{}", text.as_ref());
    }

    /// Emit an error to stderr in the active format and return its exit code.
    pub fn emit_error(&self, err: &Error) -> i32 {
        match self.format {
            Format::Json => {
                if let Ok(s) = serde_json::to_string_pretty(&err.to_json()) {
                    let _ = writeln!(io::stderr(), "{s}");
                }
            }
            Format::Human => {
                let _ = writeln!(
                    io::stderr(),
                    "error ({}): {}",
                    err.kind.as_str(),
                    err.message
                );
            }
        }
        err.exit_code()
    }
}