martianbook 0.1.0

Transform ordinary Rust codebases into explainable execution artifacts.
Documentation

MartianBook for Rust

Experimental Rust adapter for MartianBook.

MartianBook transforms ordinary codebases into explainable execution artifacts. This crate is the first Rust adapter: it captures Rust execution metadata and emits a Martian-compatible report.json.

Write Rust.
Martian observes.
No notebooks required.

Status

Early 0.1.0 release.

Current capabilities:

  • Generate Martian-compatible report.json
  • Capture named Rust execution blocks
  • Emit ExecutionNode records
  • Render through the existing MartianBook viewer

Planned:

  • #[martian] procedural macros
  • Real source extraction
  • stdout/stderr interception
  • nested call trees
  • artifact detection
  • sections
  • Cargo workflow integration

Installation

cargo add martianbook

Example

use martianbook::capture::capture;
use martianbook::write_report;

fn main() {
    capture("load_data", || {
        println!("loading data");
    });

    write_report();
}

This generates:

.martian/report.json

The report can be rendered by MartianBook.

Repository

https://github.com/martianbook/martian-rust

License

MIT