fast-observe 0.1.0

Error faults with causal trees + fastrace-first profiling/log orchestration
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

//! Superluminal backend — `scope!` → superluminal event
//! (feature `profile-with-superluminal`, windows-only dep).
//!
//! Mirrors upstream `profiling`'s `SuperluminalGuard`.

/// `0xFFFFFFFF` means "use default color" (upstream value).
const DEFAULT_SUPERLUMINAL_COLOR: u32 = 0xFFFF_FFFF;

/// Begin a superluminal event. `tag` becomes the event's attached data.
#[must_use]
pub fn enter(name: &'static str, tag: Option<&'static str>) -> SuperluminalGuard {
    match tag {
        Some(data) => {
            superluminal_perf::begin_event_with_data(name, data, DEFAULT_SUPERLUMINAL_COLOR)
        }
        None => superluminal_perf::begin_event(name),
    }
    SuperluminalGuard
}

/// Construct a no-op `SuperluminalGuard` (does nothing on drop).
#[must_use]
pub const fn dummy() -> SuperluminalGuard {
    SuperluminalGuard
}

/// Guard — ends the superluminal event on drop.
pub struct SuperluminalGuard;

impl Drop for SuperluminalGuard {
    fn drop(&mut self) {
        superluminal_perf::end_event();
    }
}