task list

ninjatracing-rs

Rust port of the ninjatracing Python script (originally from https://github.com/nico/ninjatracing). Converts Ninja build logs (.ninja_log) to Chrome Tracing format, enabling visualization of build performance in chrome://tracing or perfetto.dev.

Installation

As a CLI Tool

From crates.io (Recommended)

cargo install ninjatracing

From source

cargo install --path .

As a Library

Add this to your Cargo.toml:

[dependencies]
ninjatracing = "0.1"

Or with only the library (without CLI):

[dependencies]
ninjatracing = { version = "0.1", default-features = false }

CLI Usage

ninjatracing [OPTIONS] <LOG_FILES>... > trace.json

Arguments

Examples

# Basic usage
ninjatracing .ninja_log > trace.json

# Show all incremental steps
ninjatracing --showall .ninja_log > trace.json

# Embed clang traces
ninjatracing --embed-time-trace .ninja_log > trace.json

Library Usage

use ninjatracing::{log_to_dicts, TracingOptions};
use std::fs::File;
use std::io::BufReader;

fn main() -> anyhow::Result<()> {
    let file = File::open(".ninja_log")?;
    let reader = BufReader::new(file);
    let options = TracingOptions {
        show_all: false,
        granularity: 50000,
        embed_time_trace: false,
    };
    
    let events = log_to_dicts(reader, None, 42, &options)?;
    println!("Found {} events", events.len());
    Ok(())
}