longshot 0.1.13

API and CLI for ECAM-based Delonghi machines
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

//! Logging utilities.

use std::sync::atomic::AtomicBool;
pub(crate) static TRACE_ENABLED: AtomicBool = AtomicBool::new(false);

/// Enable tracing display to standard error.
pub fn enable_tracing() {
    TRACE_ENABLED.store(true, std::sync::atomic::Ordering::Relaxed);
}

/// Writes a trace of the given communication packet or event if [`enable_tracing`] has been called.
#[macro_export]
macro_rules! trace_packet {
    ($($arg:tt)*) => {{
        if $crate::logging::TRACE_ENABLED.load(std::sync::atomic::Ordering::Relaxed) {
            $crate::display::log($crate::display::LogLevel::Trace, &format!("{}", std::format!($($arg)*)));
        }
    }};
}

/// Writes a trace of the given shutdown event if [`enable_tracing`] has been called.
#[macro_export]
macro_rules! trace_shutdown {
    ($arg:literal) => {{
        if $crate::logging::TRACE_ENABLED.load(std::sync::atomic::Ordering::Relaxed) {
            $crate::display::log(
                $crate::display::LogLevel::Trace,
                &format!("[SHUTDOWN] {}", $arg),
            );
        }
    }};
}

/// Writes a warning of the given event if [`enable_tracing`] has been called.
#[macro_export]
macro_rules! warning {
    ($($arg:tt)*) => {{
        if $crate::logging::TRACE_ENABLED.load(std::sync::atomic::Ordering::Relaxed) {
            $crate::display::log($crate::display::LogLevel::Warning, &std::format!($($arg)*));
        }
    }};
}

/// Writes info text for the given event.
#[macro_export]
macro_rules! info {
    ($($arg:tt)*) => {{
        $crate::display::log($crate::display::LogLevel::Info, &std::format!($($arg)*));
    }};
}