convey 0.2.0

A Rust create for outputting information and log messages for humans and machines
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

use failure;
use structopt;
#[macro_use]
extern crate serde_derive;
#[macro_use]
extern crate convey;

use convey::{
    components::{newline, text},
    human, json,
};
use structopt::StructOpt;

/// Demo stuff
#[derive(StructOpt)]
struct Cli {
    /// Output JSON instead of human readable messages
    #[structopt(long = "json")]
    json: bool,
}

fn main() -> Result<(), failure::Error> {
    let args = Cli::from_args();
    let out = if args.json {
        convey::new().add_target(json::stdout()?)?
    } else {
        convey::new().add_target(human::stdout()?)?
    };

    let x = 42;

    out.print(text(x.to_string()))?;
    out.print(span!([
        span!(fg = "blue", bg = "yellow", ["colorful text",]),
        newline(),
        span!(bold = true, ["bold text",]),
        newline(),
        span!(underline = true, ["underlined text",]),
        newline(),
        span!(intense = true, ["intense text",]),
    ]))?;

    #[derive(Serialize)]
    struct ErrorMessage {
        code: i32,
        name: String,
        message: String,
    }

    impl convey::Render for ErrorMessage {
        render_for_humans!(self -> [
            span!(fg = "white", bg = "black", [text(self.code.to_string()), text(" "),]),
            span!(fg = "red", bg = "black", [text(&self.name),]),
            newline(),
            text("> "),
            text(&self.message),
        ]);

        render_json!();
    }

    out.print(&ErrorMessage {
        code: 42,
        name: String::from("error"),
        message: String::from("Oh god no"),
    })?;

    Ok(())
}