Struct benchmark_rs::benchmarks::Benchmarks

pub struct Benchmarks<C, W, E>where
    C: Clone + Display,
    W: Clone + Display,
    Error: From<E>,{ /* private fields */ }

Run and analyze a benchmarks suite

• C - configuration
• W - workload unit
• E - error type

Implementations

impl<C, W, E> Benchmarks<C, W, E>where C: Clone + Display, W: Clone + Display, Error: From<E>,

pub fn new(name: &str) -> Benchmarks<C, W, E>

Create a new Benchmarks

• name - the name of the benchmark session

pub fn run(&mut self) -> Result<(), Error>

Run all benchmarks

pub fn add( &mut self, name: &str, f: fn(stop_watch: &mut StopWatch, config: C, workload_point: W) -> Result<(), E>, config: C, work: Vec<W>, repeat: usize, ramp_up: usize ) -> Result<(), Error>

Create and add a Benchmark

• name - the name of the benchmark series. The result will be accessible by the name as a key from the summary.
• f - the function that runs the benchmark.
• config - the configuration value for this benchmark series
• work - workload points vector for this benchmark series. Elements of this vector are passed to f in each iteration
• repeat - number of times the benchmark will be repeated
• ramp_up - number of times the benchmark will be performed before the measurement is taken

pub fn summary(&self) -> Summary

Produce Summary for all series

pub fn summary_as_json(&self) -> String

Produce Summary for all series as JSON string.

pub fn csv_headers(&self) -> String

Produce headers for Self::summary_as_csv method

pub fn summary_as_csv(&self) -> HashMap<String, Vec<String>>

Produce summary for each series as vector of CSV lines. The key for series data is the series name used in Self::add method, values are placed as the headers returned by Self::csv_headers

pub fn configs(&self) -> HashMap<String, String>

Produce description of configurations for each series. The key for series config is the series name used in Self::add method.

pub fn name(&self) -> &String

The benchmarks suite name

pub fn analyze( &self, prev_result_string_opt: Option<String>, threshold: f64 ) -> Result<AnalysisResult, Error>

Compare the current result against a previous result.

• prev_result_string_opt - a JSON string of the Summary of previous run
• threshold - threshold used to determine equality.