libutils 7.30.19

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

//^
//^ HEAD
//^

//> HEAD -> MODULES
mod act;
mod machine;
mod shortcut;

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

//> HEAD -> CRATE
use crate::{
    problem::{
        Problem,
        Severity
    },
    issue::Issue
};

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

//> HEAD -> MACHINE
pub use machine::{
    Main,
    Mode,
    Set
};


//^
//^ REPORT
//^

//> REPORT -> STRUCT
pub struct Report<State: Mode>(State);

//> REPORT -> DEFAULT
impl Default for Report<Main> {
    fn default() -> Self {return Self(Main)}
}

//> REPORT -> IMPLEMENTATION
impl<State: Mode> Report<State> {
    #[inline]
    pub fn warn<Object: Into<Issue>>(&self, object: Object) -> () {
        self.0.send(Problem {
            chain: Vec::new(),
            at: Instant::now(),
            object: object,
            severity: Severity::Warning
        });
    }
    #[inline]
    pub fn error<Object: Into<Issue>>(&self, object: Object) -> () {
        self.0.send(Problem {
            chain: Vec::new(),
            at: Instant::now(),
            object: object,
            severity: Severity::Error
        });
    }
    #[inline]
    pub fn sub<'valid, const NAME: &'static str>(&'valid self) -> Report<Set<'valid, NAME>> {return Report(self.0.connect())}
    #[inline]
    pub fn with<Type>(self, value: Type) -> Act<Type, {State::NAME}> {return Act(Some(value))}
    #[inline]
    pub fn with_default<Type: Default>(self) -> Act<Type, {State::NAME}> {return Act(Some(Type::default()))}
    #[inline]
    pub fn fail<Type, Object: Into<Issue>>(self, object: Object) -> Act<Type, {State::NAME}> {
        self.0.send(Problem {
            chain: Vec::new(),
            at: Instant::now(),
            object: object,
            severity: Severity::Critical
        });
        return Act(None);
    }
}