Struct ResultWriter 

pub struct ResultWriter { /* private fields */ }

Writes results.json and summary.md to an output directory.

Files are written atomically by flushing to a .tmp sibling file and then renaming, so a concurrent SIGINT cannot leave a half-written JSON file.

Examples

use zeph_bench::{ResultWriter, BenchRun, RunStatus, Aggregate};

let writer = ResultWriter::new("/tmp/my-bench-run").unwrap();
println!("results at {}", writer.results_path().display());

Implementations

impl ResultWriter

pub fn new(output_dir: impl Into<PathBuf>) -> Result<Self, BenchError>

Create a writer targeting output_dir.

The directory is created automatically (single level) if it does not exist.

Errors

Returns BenchError::Io if the directory cannot be created.

pub fn results_path(&self) -> PathBuf

Absolute path of results.json inside the output directory.

Examples

use std::path::Path;
use zeph_bench::ResultWriter;

let dir = tempfile::tempdir().unwrap();
let writer = ResultWriter::new(dir.path()).unwrap();
assert!(writer.results_path().ends_with("results.json"));

pub fn summary_path(&self) -> PathBuf

Absolute path of summary.md inside the output directory.

Examples

use zeph_bench::ResultWriter;

let dir = tempfile::tempdir().unwrap();
let writer = ResultWriter::new(dir.path()).unwrap();
assert!(writer.summary_path().ends_with("summary.md"));

pub fn load_existing(&self) -> Result<Option<BenchRun>, BenchError>

Load an existing results.json for resume.

Returns None when the file does not exist (treat as fresh run).

Errors

Returns BenchError::Io on read failure, or BenchError::InvalidFormat if the file exists but cannot be deserialized.

pub fn write(&self, run: &BenchRun) -> Result<(), BenchError>

Write run to results.json and summary.md atomically (best-effort).

Errors

Returns BenchError on serialization or I/O failure.