doclog 0.3.0

A Rust log library based on Rust's compiler logs
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

use crate::blocks::LogBlock;
use crate::printer::{Printable, Printer, PrinterFormat};
use crate::LogLevel;
use smallvec::SmallVec;
use std::fmt::Display;

/// A list of log elements.
#[derive(Default, Debug, Clone)]
pub struct LogContent<'a> {
    pub blocks: SmallVec<[LogBlock<'a>; 3]>,
}

impl<'a> LogContent<'a> {
    // CONSTRUCTORS -----------------------------------------------------------

    /// Builds a new content.
    pub fn new() -> Self {
        Self::default()
    }

    // METHODS ----------------------------------------------------------------

    /// Adds a new block.
    pub fn add_block(mut self, block: impl Into<LogBlock<'a>>) -> Self {
        self.blocks.push(block.into());
        self
    }

    /// Makes this type owned, i.e. changing the lifetime to `static`.
    pub fn make_owned(self) -> LogContent<'static> {
        LogContent {
            blocks: self.blocks.into_iter().map(|v| v.make_owned()).collect(),
        }
    }
}

impl<'a> Printable<'a> for LogContent<'a> {
    fn print<'s>(&'s self, printer: &mut Printer<'a>)
    where
        'a: 's,
    {
        for (i, block) in self.blocks.iter().enumerate() {
            if i > 0 {
                printer.push_plain_text("\n");
            }

            block.print(printer);
        }
    }
}

impl<'a> Display for LogContent<'a> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let mut printer = Printer::new(LogLevel::trace(), PrinterFormat::Plain);
        self.print(&mut printer);
        printer.fmt(f, PrinterFormat::Plain)
    }
}