From 50cf7de9157bead751b3b2e620c2715056a6031d Mon Sep 17 00:00:00 2001
From: Philipp Paulweber
Date: Mon, 21 Mar 2022 20:57:24 +0100
Subject: [PATCH] Refactor Markdown table emitting to generic Markup function
---
src/export/markdown.rs | 29 ++++++-----------------
src/export/markup.rs | 54 +++++++++++++++++++++++++++++-------------
2 files changed, 45 insertions(+), 38 deletions(-)
diff --git a/src/export/markdown.rs b/src/export/markdown.rs
index 4c91dd7..e7f98c5 100644
--- a/src/export/markdown.rs
+++ b/src/export/markdown.rs
@@ -1,11 +1,10 @@
use super::Exporter;
use crate::benchmark::benchmark_result::BenchmarkResult;
use crate::benchmark::relative_speed;
-use crate::export::markup::markup_results_unit;
-use crate::export::markup::markup_table_data;
-use crate::export::markup::markup_table_line;
-use crate::export::markup::MarkupType;
use crate::export::markup::markup_results;
+use crate::export::markup::markup_table;
+use crate::export::markup::markup_unit;
+use crate::export::markup::MarkupType;
use crate::util::units::Unit;
use anyhow::{anyhow, Result};
@@ -15,8 +14,6 @@ pub struct MarkdownExporter {}
impl Exporter for MarkdownExporter {
fn serialize(&self, results: &[BenchmarkResult], unit: Option) -> Result> {
- let unit = markup_results_unit(results, unit);
-
let entries = relative_speed::compute(results);
if entries.is_none() {
return Err(anyhow!(
@@ -25,27 +22,15 @@ impl Exporter for MarkdownExporter {
}
let kind = MarkupType::Markdown;
- let data = markup_results( &kind, &entries.unwrap(), unit );
- let head: &Vec = data.first().unwrap();
- let tail: &[Vec] = &data[1..];
-
- // emit header
- let mut table = markup_table_data(&kind, head);
-
- // emit horizontal line
- table.push_str(&markup_table_line(&kind, head.len()));
-
- // emit data rows
- for row in tail {
- table.push_str(&markup_table_data(&kind, row))
- }
-
+ let unit = markup_unit(results, unit);
+ let data = markup_results(&kind, &entries.unwrap(), unit);
+ let table = markup_table(&kind, &data);
Ok(table.as_bytes().to_vec())
}
}
/// Test helper function to create unit-based header and horizontal line
-/// independently from the markup functionality.
+/// independently from the markup functionality for Markdown.
#[cfg(test)]
fn test_table_header(unit_short_name: String) -> String {
format!(
diff --git a/src/export/markup.rs b/src/export/markup.rs
index 274e455..ab9bfce 100644
--- a/src/export/markup.rs
+++ b/src/export/markup.rs
@@ -1,7 +1,7 @@
use crate::benchmark::benchmark_result::BenchmarkResult;
+use crate::benchmark::relative_speed::BenchmarkResultWithRelativeSpeed;
use crate::output::format::format_duration_value;
use crate::util::units::Unit;
-use crate::benchmark::relative_speed::BenchmarkResultWithRelativeSpeed;
#[derive(Clone)]
pub enum MarkupType {
@@ -9,19 +9,41 @@ pub enum MarkupType {
Markdown,
}
-pub fn markup_table_data(kind: &MarkupType, data: &Vec) -> String {
+pub fn markup_table(kind: &MarkupType, data: &[Vec]) -> String {
+ let head: &Vec = data.first().unwrap();
+ let tail: &[Vec] = &data[1..];
+
+ // emit header
+ let mut table = markup_table_data(&kind, head);
+
+ // emit horizontal line
+ table.push_str(&markup_table_line(&kind, head.len()));
+
+ // emit data rows
+ for row in tail {
+ table.push_str(&markup_table_data(&kind, row))
+ }
+
+ return table;
+}
+
+fn markup_table_data(kind: &MarkupType, data: &Vec) -> String {
return match kind {
MarkupType::Markdown => format!("| {} |\n", data.join(" | ")),
};
}
-pub fn markup_table_line(kind: &MarkupType, size: usize) -> String {
+fn markup_table_line(kind: &MarkupType, size: usize) -> String {
return match kind {
MarkupType::Markdown => format!("|:---|{}\n", "---:|".repeat(size - 1)),
};
}
-pub fn markup_results(kind: &MarkupType, entries: &[BenchmarkResultWithRelativeSpeed], unit: Unit) -> Vec> {
+pub fn markup_results(
+ kind: &MarkupType,
+ entries: &[BenchmarkResultWithRelativeSpeed],
+ unit: Unit,
+) -> Vec> {
// prepare table header strings
let notation = format!("[{}]", unit.short_name());
let mut data: Vec> = vec![vec![
@@ -55,7 +77,7 @@ pub fn markup_results(kind: &MarkupType, entries: &[BenchmarkResultWithRelativeS
// prepare table row entries
data.push(vec![
match kind {
- MarkupType::Markdown => format!( "`{}`", cmd_str ),
+ MarkupType::Markdown => format!("`{}`", cmd_str),
},
format!("{}{}", mean_str, stddev_str),
format!("{}", min_str),
@@ -67,7 +89,7 @@ pub fn markup_results(kind: &MarkupType, entries: &[BenchmarkResultWithRelativeS
return data;
}
-pub fn markup_results_unit(results: &[BenchmarkResult], unit: Option) -> Unit {
+pub fn markup_unit(results: &[BenchmarkResult], unit: Option) -> Unit {
return if let Some(unit) = unit {
// Use the given unit for all entries.
unit
@@ -106,7 +128,7 @@ fn test_markup_table_line_markdown() {
/// Check unit resolving for timing results and given unit 's'
#[test]
-fn test_markup_table_results_unit_given_s() {
+fn test_markup_table_unit_given_s() {
use std::collections::BTreeMap;
let results = vec![
BenchmarkResult {
@@ -138,7 +160,7 @@ fn test_markup_table_results_unit_given_s() {
];
let unit = Some(Unit::Second);
- let markup_actual = markup_results_unit(&results, unit);
+ let markup_actual = markup_unit(&results, unit);
let markup_expected = Unit::Second;
assert_eq!(markup_expected, markup_actual);
@@ -146,7 +168,7 @@ fn test_markup_table_results_unit_given_s() {
/// Check unit resolving for timing results and given unit 'ms'
#[test]
-fn test_markup_table_results_unit_given_ms() {
+fn test_markup_table_unit_given_ms() {
use std::collections::BTreeMap;
let results = vec![
BenchmarkResult {
@@ -178,7 +200,7 @@ fn test_markup_table_results_unit_given_ms() {
];
let unit = Some(Unit::MilliSecond);
- let markup_actual = markup_results_unit(&results, unit);
+ let markup_actual = markup_unit(&results, unit);
let markup_expected = Unit::MilliSecond;
assert_eq!(markup_expected, markup_actual);
@@ -186,7 +208,7 @@ fn test_markup_table_results_unit_given_ms() {
/// Check unit resolving for timing results using the first result entry as 's'
#[test]
-fn test_markup_table_results_unit_first_s() {
+fn test_markup_table_unit_first_s() {
use std::collections::BTreeMap;
let results = vec![
BenchmarkResult {
@@ -218,7 +240,7 @@ fn test_markup_table_results_unit_first_s() {
];
let unit = None;
- let markup_actual = markup_results_unit(&results, unit);
+ let markup_actual = markup_unit(&results, unit);
let markup_expected = Unit::Second;
assert_eq!(markup_expected, markup_actual);
@@ -226,7 +248,7 @@ fn test_markup_table_results_unit_first_s() {
/// Check unit resolving for timing results using the first result entry as 'ms'
#[test]
-fn test_markup_table_results_unit_first_ms() {
+fn test_markup_table_unit_first_ms() {
use std::collections::BTreeMap;
let results = vec![
BenchmarkResult {
@@ -258,7 +280,7 @@ fn test_markup_table_results_unit_first_ms() {
];
let unit = None;
- let markup_actual = markup_results_unit(&results, unit);
+ let markup_actual = markup_unit(&results, unit);
let markup_expected = Unit::MilliSecond;
assert_eq!(markup_expected, markup_actual);
@@ -266,11 +288,11 @@ fn test_markup_table_results_unit_first_ms() {
/// Check unit resolving for not timing results and no given unit defaulting to 's'
#[test]
-fn test_markup_table_results_unit_default_s() {
+fn test_markup_table_unit_default_s() {
let results: Vec = vec![];
let unit = None;
- let markup_actual = markup_results_unit(&results, unit);
+ let markup_actual = markup_unit(&results, unit);
let markup_expected = Unit::Second;
assert_eq!(markup_expected, markup_actual);