yall 0.6.1

A simple lightweight backend for the log crate.
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

// Copyright (c) 2020 Allen Wild
// SPDX-License-Identifier: MIT OR Apache-2.0

//! Demo of using yall::Logger with a basic `clap` app

use clap::{value_parser, Arg, ArgAction};
use yall::log_macros::*;
use yall::Logger;

fn main() {
    let args = clap::command!("yall example")
        .arg(
            Arg::new("verbose")
                .short('v')
                .long("verbose")
                .action(ArgAction::Count)
                .help("be more verbose"),
        )
        .arg(
            Arg::new("quiet")
                .short('q')
                .long("quiet")
                .action(ArgAction::Count)
                .conflicts_with("verbose")
                .help("be more quiet"),
        )
        .arg(
            Arg::new("level")
                .short('l')
                .long("level")
                .value_parser(value_parser!(u8))
                .conflicts_with_all(["verbose", "quiet"])
                .help("set the numberic level, from 0=off to 5=trace"),
        )
        .arg(
            Arg::new("filename")
                .short('F')
                .long("full-filename")
                .action(ArgAction::SetTrue)
                .help("Show the full non-abbreviated filename in debug/trace logs"),
        )
        .get_matches();

    // create and register the logger. Most applications wouldn't have all three arguments used in
    // this example. Here, clap is set up so that verbose, level, and quiet are all
    // mutually-exclusive.
    let mut logger = if let Some(level) = args.get_one::<u8>("level") {
        Logger::with_verbosity(*level)
    } else {
        // can easily chain verbose and quiet adjustments
        Logger::new().verbose(args.get_count("verbose")).quiet(args.get_count("quiet"))
    };

    // Logger's builder methods pass by value instead of &mut, requiring the need to re-assign
    logger = logger.full_filename(args.get_flag("filename"));
    logger.init();

    trace!("loud noises");
    debug!("squash these bugs");
    info!("some normal information");
    warn!("oh deer");
    error!("gosh heckie");
}