libutils-report 9.40.27

A custom error wrapper for detailed 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
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
96
97
98
99
100
101
102
103
104
105
106

//^
//^ HEAD
//^

//> HEAD -> FEATURES
#![allow(incomplete_features)]
#![feature(transmute_neo)]
#![feature(const_destruct)]
#![feature(try_trait_v2)]
#![feature(try_trait_v2_residual)]
#![feature(const_try)]
#![feature(const_default)]
#![feature(const_trait_impl)]
#![feature(unsized_const_params)]
#![feature(adt_const_params)]
#![feature(generic_const_exprs)]
#![feature(const_try_residual)]
#![feature(const_option_ops)]

//> HEAD -> MODULES
mod act;
mod shortcut;
#[cfg(test)]
mod tests;

//> HEAD -> ARRAY
use libutils_array::Array;

//> HEAD -> TERMINAL
use libutils_terminal::{
    TERMINAL,
    Console
};

//> HEAD -> ISSUE
use libutils_issue::Issue;

//> HEAD -> PROBLEM
use libutils_problem::{
    Threat,
    Severity
};

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

//> HEAD -> CORE
use core::mem::transmute_neo as transmute;


//^
//^ REPORT
//^

//> REPORT -> STRUCT
pub struct Report<const NAME: &'static str, const N: usize> {
    chain: Array<&'static str, N>
}

//> REPORT -> DEFAULT
const impl Default for Report<"Main", 1> {
    fn default() -> Self {
        let mut chain = Array::default();
        chain.push("Main");
        return Self {
            chain: chain
        }
    }
}

//> REPORT -> IMPLEMENTATION
impl<const NAME: &'static str, const N: usize> Report<NAME, N> {
    #[inline]
    pub fn warn<Object: Into<Issue>>(&self, object: Object) -> () {TERMINAL.write().problem(Threat {
        chain: self.chain.clone(),
        object: object,
        severity: Severity::Warning
    })}
    #[inline]
    pub fn error<Object: Into<Issue>>(&self, object: Object) -> () {TERMINAL.write().problem(Threat {
        chain: self.chain.clone(),
        object: object,
        severity: Severity::Error
    })}
    #[inline]
    pub fn sub<'valid, const OTHER: &'static str>(&'valid self) -> Report<OTHER, {N + 1}> {
        let mut chain = Array::from_iter(self.chain.clone().into_iter());
        chain.push(OTHER);
        return Report {
            chain: chain
        }
    }
    #[inline]
    pub fn with<Type>(self, value: Type) -> Act<Type> {return unsafe {transmute(Some(value))}}
    #[inline]
    pub fn with_default<Type: Default>(self) -> Act<Type> {return unsafe {transmute(Some(Type::default()))}}
    #[inline]
    pub fn fail<Type, Object: Into<Issue>>(self, object: Object) -> Act<Type> {
        TERMINAL.write().problem(Threat {
            chain: self.chain.clone(),
            object: object,
            severity: Severity::Critical
        });
        return unsafe {transmute(None::<Type>)};
    }
}