runi-log 0.1.0

Structured logging for the Runi library collection
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

mod format;

use format::UniFormatter;
use tracing_subscriber::{EnvFilter, fmt, prelude::*};

pub use tracing::Span;
pub use tracing::{Level, instrument, span};
pub use tracing::{debug, error, info, trace, warn};

/// Initialize logging with sensible defaults.
///
/// - Log level from `RUNI_LOG` env var (default: `info`)
/// - Uni-style format: `timestamp LEVEL [target] message - (file:line)`
/// - Colored output for terminals, JSON for non-terminals
pub fn init() {
    init_with_env("RUNI_LOG");
}

/// Initialize logging with a custom env var name for the filter.
pub fn init_with_env(env_var: &str) {
    let filter = EnvFilter::try_from_env(env_var).unwrap_or_else(|_| EnvFilter::new("info"));

    let is_terminal = std::io::IsTerminal::is_terminal(&std::io::stderr());

    if is_terminal {
        tracing_subscriber::registry()
            .with(filter)
            .with(fmt::layer().event_format(UniFormatter::new(true)))
            .init();
    } else {
        tracing_subscriber::registry()
            .with(filter)
            .with(
                fmt::layer()
                    .json()
                    .with_target(true)
                    .with_file(true)
                    .with_line_number(true),
            )
            .init();
    }
}

/// Initialize logging with a specific level string (e.g., "debug", "warn").
pub fn init_with_level(level: &str) {
    let filter = EnvFilter::new(level);
    tracing_subscriber::registry()
        .with(filter)
        .with(fmt::layer().event_format(UniFormatter::new(true)))
        .init();
}

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

    #[test]
    fn log_macros_compile() {
        trace!("trace message");
        debug!("debug message");
        info!("info message");
        warn!("warn message");
        error!("error message");
    }

    #[test]
    fn log_with_fields() {
        info!(host = "localhost", port = 8080, "server starting");
        debug!(elapsed_ms = 42, "request completed");
    }

    #[test]
    fn span_creation() {
        let _span = span!(Level::INFO, "my_span", id = 42);
    }
}