#Yu-zh/tracing

#Features

• debug/info logging with optional stdout output
• Chrome trace format (JSON) for visualization in Perfetto
• scope function to track function execution as duration events

#Usage

async fn main {
  @tracing.setup(stdout=true, chrome=Some("trace.json"))

  @tracing.scope("main", fn() {
    @tracing.debug("starting")
    do_work()
    @tracing.info("done")
  })

  @tracing.close()
}

#API

// Initialize tracing
// - stdout: print log messages to stdout
// - chrome: write Chrome trace events to file
pub fn setup(stdout~ : Bool = false, chrome~ : String? = None) -> Unit

// Log messages (instant events)
pub fn debug(msg : String) -> Unit
pub fn info(msg : String) -> Unit

// Track function execution (duration events)
pub fn[T] scope(name : String, f : () -> T) -> T
pub async fn[T] scope_async(name : String, f : async () -> T) -> T

// Write trace file and cleanup
pub async fn close() -> Unit

#Chrome Trace Format

• Instant events (ph:"i") for debug/info logs
• Complete events (ph:"X") for scope durations

[
{"pid":0, "name":"debug: starting", "ts":5, "ph":"i", "s":"g"},
{"pid":0, "name":"info: done", "ts":100, "ph":"i", "s":"g"},
{"pid":0, "name":"main", "ts":0, "tid":0, "ph":"X", "dur":105}
]

#Requirements