active-reporting 1.0.3

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

//^
//^ HEAD
//^

//> HEAD -> SUPER
use super::Report;

//> HEAD -> CORE
use core::{
    ptr::NonNull,
    marker::PhantomCovariantLifetime
};

//> HEAD -> ALLOC
use alloc::vec::Vec;


//^
//^ ROOT
//^

//> ROOT -> STRUCT
pub struct Root {
    chain: Vec<&'static str>
}

//> ROOT -> IMPLEMENTATION
impl Root {
    pub const fn new(name: &'static str) -> Self {return Self {
        chain: if name.is_empty() {Vec::new()} else {
            let mut chain = Vec::new();
            chain.push(name);
            chain
        }
    }}
    pub const fn chain(&self) -> &[&'static str] {return self.chain.as_slice()}
    pub const fn to<'valid, 'next, const NAME: &'static str>(&'valid mut self) -> Report<'next, NAME> where 'valid: 'next {
        if !NAME.is_empty() {self.chain.push(NAME);}
        return Report {
            chain: NonNull::new(&raw mut self.chain).unwrap(),
            _lifetime: PhantomCovariantLifetime::new()
        }
    }
}

//> ROOT -> DEFAULT
const impl Default for Root {
    fn default() -> Self {return Self::new("Main")}
}

//> ROOT -> !SYNC
impl !Sync for Root {}