better-logger 2.3.2

Flexible sync/async logger with console, file, and HTTP output
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
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126

// better-logger/src/interface/logger.rs

#[cfg(any(feature = "native", feature = "wasm"))]
pub use crate::{trace, debug, debugx, info, warn, error};

///0
///1
///2
///3
///4
///5
///6
///7
///8
///9

#[cfg(any(feature = "native", feature = "wasm"))]
use super::settings::{LoggerSettings, RunningSettings, RUNNING_SETTINGS};

///0
///1
///2
///3
///4
///5
///6
///7
///8
///9

#[cfg(any(feature = "native", feature = "wasm"))]
pub fn init(settings: LoggerSettings) -> Result<String, String> {
    match init_private(settings) {
        Ok(msg) => {
            return Ok(msg);
        },
        Err(error) => {
            return Err(error);
        }
    }
}

///0
///1
///2
///3
///4
///5
///6
///7
///8
///9

#[cfg(any(feature = "native", feature = "wasm"))]
fn init_private(settings: LoggerSettings) -> Result<String, String> {
    if settings.use_bearer_auth == true && settings.bearer_auth_key.trim().is_empty() {
        return Err(format!(r#"better-logger: "bearer_auth_key" must be set when "use_bearer_auth" is true"#));
    }

    #[cfg(feature = "native")]
    if settings.async_logging == true {
        if settings.wasm_logging == false {
            if tokio::runtime::Handle::try_current().is_err() {
                return Err(format!(r#"better-logger: "logger::init()" must be called inside a Tokio runtime"#));
            }
        }
    }

    if settings.terminal_logs == true {
        if settings.wasm_logging == false {
            #[cfg(feature = "native")]
            crate::native::auxiliary::initialize_native_logger(settings.terminal_log_lvl.to_lowercase().as_str())?;
        }
        else {
            #[cfg(feature = "wasm")]
            crate::wasm::auxiliary::initialize_wasm_logger(settings.terminal_log_lvl.to_lowercase().as_str())?;
        }
    }

    if settings.file_logs == true {
        if settings.wasm_logging == true {
            return Err(format!(r#"better-logger: file logging is not allowed in a WASM environment"#));
        }

        #[cfg(feature = "native")]
        crate::native::auxiliary::initialize_file_logging(&settings.file_log_lvl.to_lowercase().as_str(), &settings.log_file_path)?;
    }

    if settings.network_logs == true {
        #[cfg(feature = "native")]
        crate::native::auxiliary::initialize_network_logging(&settings.network_log_lvl.to_lowercase().as_str())?;

        #[cfg(feature = "wasm")]
        crate::wasm::auxiliary::initialize_network_logging(&settings.network_log_lvl.to_lowercase().as_str())?;

        #[cfg(feature = "wasm")]
        if settings.async_logging == false {
            return Err(format!(r#"better-logger: when using network logging in a WASM environment, the async_logging setting must be true. Browsers don't allow blocking network I/O on the main thread"#));
        }
    }

    let running_settings = RunningSettings {
        terminal_logs: settings.terminal_logs,
        terminal_log_lvl: settings.terminal_log_lvl,
        wasm_logging: settings.wasm_logging,
        file_logs: settings.file_logs,
        file_log_lvl: settings.file_log_lvl,
        network_logs: settings.network_logs,
        network_log_lvl: settings.network_log_lvl,
        network_endpoint_url: settings.network_endpoint_url,
        network_format: settings.network_format,
        use_bearer_auth: settings.use_bearer_auth,
        bearer_auth_key: settings.bearer_auth_key,
        debug_extra: settings.debug_extra,
        async_logging: settings.async_logging,
    };

    match RUNNING_SETTINGS.set(running_settings) {
        Ok(_ok) => {
            return Ok("better-logger initialized successfully".to_string());
        },
        Err(_error) => {
            return Err(format!(r#"better-logger: RUNNING_SETTINGS have already been initialized"#));
        }
    }
}