libutils 5.27.18

Common library types for faster development
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

//^
//^ HEAD
//^

//> HEAD -> crate
use crate::report::{
    ToIssue,
    Issue
};

//> HEAD -> STD
use std::time::Instant;

//> HEAD -> CORE
use core::fmt::{
    Display,
    Formatter,
    Result as Format,
    Debug
};


//^
//^ PROBLEM
//^

//> PROBLEM -> STRUCT
pub struct Problem<Object: ToIssue> {
    pub chain: Vec<&'static str>,
    pub at: Instant,
    pub object: Object,
    pub severity: Severity
}

//> PROBLEM -> SEVERITY
#[derive(Clone, Copy, Debug)]
pub enum Severity {
    Warning,
    Error,
    Critical
}

//> PROBLEM -> DISPLAY
impl Display for Problem<Issue> {
    fn fmt(&self, formatter: &mut Formatter<'_>) -> Format {write!(
        formatter,
        "@{}\n{:?}: {}{}",
        self.chain.iter().rev().map(|node| *node).collect::<Vec<&'static str>>().join(" > "),
        self.severity,
        self.object.name,
        if let Some(description) = &self.object.description {format!("\n    {}", description)} else {String::new()}
    )}
}