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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

//^
//^ HEAD
//^

//> HEAD -> MODULES
mod act;
mod issue;
mod note;
mod shortcut;
mod toissue;

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

//> HEAD -> TOISSUE
pub use toissue::ToIssue;

//> HEAD -> ISSUE
pub use issue::Issue;

//> HEAD -> CRATE
use crate::terminal::{
    TERMINAL,
    Problem,
    Console,
    Severity
};

//> HEAD -> NOTE
pub use note::Note;

//> HEAD -> ACT
pub use act::Act;


//^
//^ REPORT
//^

//> REPORT -> STRUCT
pub struct Report<Object: ToIssue, const NAME: &'static str> {
    problems: Vec<Problem<Object>> = Vec::new()
}

//> REPORT -> DEFAULT
impl<Object: ToIssue, const NAME: &'static str> Default for Report<Object, NAME> {
    fn default() -> Self {return Self {..}}
}

//> REPORT -> IMPLEMENTATION
impl<Object: ToIssue, const NAME: &'static str> Report<Object, NAME> {
    #[inline]
    pub fn warn(&mut self, object: Object) -> () {
        let problem = Problem {
            chain: Vec::from([NAME]),
            at: Instant::now(),
            object: object,
            severity: Severity::Warning
        };
        TERMINAL.write().issue(&problem);
        self.problems.push(problem);
    }
    #[inline]
    pub fn error(&mut self, object: Object) -> () {
        let problem = Problem {
            chain: Vec::from([NAME]),
            at: Instant::now(),
            object: object,
            severity: Severity::Error
        };
        TERMINAL.write().issue(&problem);
        self.problems.push(problem);
    }
    #[inline]
    pub fn finish<Type>(mut self, with: Result<Type, Object>) -> Act<Type, Object, NAME> {return match with {
        Ok(value) => Act {
            problems: self.problems,
            result: Some(value)
        },
        Err(object) => {
            let problem = Problem {
                chain: Vec::from([NAME]),
                at: Instant::now(),
                object: object,
                severity: Severity::Critical
            };
            TERMINAL.write().issue(&problem);
            self.problems.push(problem);
            Act {
                problems: self.problems,
                result: None
            }
        }
    }}
}