standby 0.2.0

A world-class cross-platform time management tool for sleep, timeout, and wait operations with full POSIX compliance and GNU coreutils compatibility
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

//! Debug and logging utilities for timeout troubleshooting.
//!
//! When verbose mode is enabled, provides detailed logging of timeout behavior
//! including process spawning, signal sending, and timing information.

use std::sync::OnceLock;

static VERBOSE_MODE: OnceLock<bool> = OnceLock::new();

/// Initialize verbose mode globally.
pub fn init_verbose(verbose: bool) {
    let _ = VERBOSE_MODE.set(verbose);
}

/// Check if verbose mode is enabled.
pub fn is_verbose() -> bool {
    VERBOSE_MODE.get().copied().unwrap_or(false)
}

/// Log a debug message if verbose mode is enabled.
///
/// Example: `debug!("Process spawned with PID: {}", pid);`
#[macro_export]
macro_rules! debug {
    ($($arg:tt)*) => {
        if $crate::debug::is_verbose() {
            eprintln!("[standby] {}", format!($($arg)*));
        }
    };
}

// Make debug macro available without prefix
pub use debug;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_verbose_mode_disabled() {
        init_verbose(false);
        // This should not produce output
        debug!("This should not be printed");
    }

    #[test]
    fn test_verbose_mode_enabled() {
        init_verbose(true);
        // This would print to stderr
        debug!("This should be printed if verbose");
    }
}