logdb 0.3.0

Embedded, append-only, crash-recoverable, optionally tamper-proof local log database
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

//! Internal observability shim.
//!
//! When the `tracing` feature is enabled, the `log_*!` macros forward to the
//! [`tracing`](https://docs.rs/tracing) crate (structured, subscriber-driven
//! logging). When `metrics` is enabled, the `metric_*!` macros forward to the
//! [`metrics`](https://docs.rs/metrics) facade (counters / histograms / gauges
//! — install a recorder, e.g. a Prometheus exporter, in the host to collect).
//! When a feature is off, its macros expand to nothing — so logdb stays
//! zero-extra-dependency by default, and call sites need no `#[cfg]` of their
//! own.

#[cfg(feature = "tracing")]
macro_rules! log_debug {
    ($($arg:tt)*) => {
        tracing::debug!($($arg)*)
    };
}
#[cfg(feature = "tracing")]
macro_rules! log_info {
    ($($arg:tt)*) => {
        tracing::info!($($arg)*)
    };
}
#[cfg(feature = "tracing")]
macro_rules! log_warn {
    ($($arg:tt)*) => {
        tracing::warn!($($arg)*)
    };
}

#[cfg(not(feature = "tracing"))]
macro_rules! log_debug {
    ($($arg:tt)*) => {};
}
#[cfg(not(feature = "tracing"))]
macro_rules! log_info {
    ($($arg:tt)*) => {};
}
#[cfg(not(feature = "tracing"))]
macro_rules! log_warn {
    ($($arg:tt)*) => {};
}

// ── metrics facade (counters / histograms / gauges) ─────────────────────────
//
// Same no-op-when-off pattern as the tracing macros above. The `metrics` crate
// macros accept `(name, value[, "label" => "v", …])`; we pass tokens through
// verbatim so call sites stay cfg-free.

#[cfg(feature = "metrics")]
macro_rules! metric_counter {
    ($name:expr, $n:expr $(,)?) => {
        metrics::counter!($name).increment($n)
    };
}
#[cfg(feature = "metrics")]
macro_rules! metric_histogram {
    ($name:expr, $dur:expr $(,)?) => {
        metrics::histogram!($name).record($dur)
    };
}
#[cfg(feature = "metrics")]
macro_rules! metric_gauge {
    ($name:expr, $val:expr $(,)?) => {
        metrics::gauge!($name).set(($val) as f64)
    };
}

#[cfg(not(feature = "metrics"))]
macro_rules! metric_counter {
    ($($arg:tt)*) => {};
}
#[cfg(not(feature = "metrics"))]
macro_rules! metric_histogram {
    ($($arg:tt)*) => {};
}
#[cfg(not(feature = "metrics"))]
macro_rules! metric_gauge {
    ($($arg:tt)*) => {};
}