Fields

• benchName :: !String

  Name of the benchmark (used for golden file naming)

• benchAction :: !(IO ())

  The IO action to benchmark

• benchConfig :: !BenchConfig

  Configuration parameters

Fields

• iterations :: !Int

  Number of benchmark iterations to run

• warmupIterations :: !Int

  Number of warm-up iterations (discarded before measurement)

• tolerancePercent :: !Double

  Allowed deviation in mean time (as percentage, e.g., 15.0 = ±15%)

• absoluteToleranceMs :: !(Maybe Double)

  Minimum absolute tolerance in milliseconds (e.g., 0.01 = 10 microseconds). When set, benchmarks pass if EITHER the percentage difference is within tolerancePercent OR the absolute time difference is within this threshold. This prevents false failures for extremely fast operations (< 1ms) where measurement noise causes large percentage variations despite negligible absolute time differences. Set to Nothing to disable (percentage-only).

• warnOnVarianceChange :: !Bool

  Whether to emit warnings when stddev changes significantly

• varianceTolerancePercent :: !Double

  Allowed deviation in stddev (as percentage)

• outputDir :: !FilePath

  Directory for storing golden files

• failOnFirstRun :: !Bool

  Whether to fail if no golden file exists yet

• useRobustStatistics :: !Bool

  Use robust statistics (trimmed mean, MAD) instead of mean/stddev

• trimPercent :: !Double

  Percentage to trim from each tail for trimmed mean (e.g., 10.0 = 10%)

• outlierThreshold :: !Double

  MAD multiplier for outlier detection (e.g., 3.0 = 3 MADs from median)

Fields

• statsMean :: !Double

  Mean execution time in milliseconds

• statsStddev :: !Double

  Standard deviation in milliseconds

• statsMedian :: !Double

  Median execution time in milliseconds

• statsMin :: !Double

  Minimum execution time in milliseconds

• statsMax :: !Double

  Maximum execution time in milliseconds

• statsPercentiles :: ![(Int, Double)]

  Percentile values (e.g., [(50, 1.2), (90, 1.5), (99, 1.8)])

• statsArch :: !Text

  Architecture identifier

• statsTimestamp :: !UTCTime

  When this baseline was recorded

• statsTrimmedMean :: !Double

  Trimmed mean (with tails removed) in milliseconds

• statsMAD :: !Double

  Median absolute deviation in milliseconds

• statsIQR :: !Double

  Interquartile range (Q3 - Q1) in milliseconds

• statsOutliers :: ![Double]

  List of detected outlier timings in milliseconds

Fields

• archId :: !Text

  Unique identifier (e.g., "aarch64-darwin-Apple_M1")

• archOS :: !Text

  Operating system (e.g., "darwin", "linux")

• archCPU :: !Text

  CPU architecture (e.g., "aarch64", "x86_64")

• archModel :: !(Maybe Text)

  CPU model if available (e.g., "Apple M1", "Intel Core i7")