Renamed runtime -> duration.

Author: simphotonics

lib/src/base/async_benchmark.dart

@@ -37,8 +37,8 @@ Future<void> asyncReportMean(
 ) async {
   final watch = Stopwatch()..start();
   final score = await instance.measure();
-  final runtime = watch.elapsed.msus.style(ColorProfile.dim);
-  emitter.emit('$runtime ${instance.description}', score);
+  final duration = watch.elapsed.msus.style(ColorProfile.dim);
+  emitter.emit('$duration ${instance.description}', score);
 }
 
 // Generic function that reports benchmark scores by calling an emitter [E].
@@ -88,7 +88,7 @@ class AsyncBenchmark extends AsyncBenchmarkBase {
   /// Returns the benchmark description (corresponds to the getter name).
   String get description => name;
 
-  /// Runs [measure] and emits the score and benchmark runtime.
+  /// Runs [measure] and emits the score and measured benchmark duration.
   @override
   Future<void> report() async {
     await asyncReportMean(this, emitter as ColorPrintEmitter);
@@ -165,7 +165,7 @@ class AsyncBenchmark extends AsyncBenchmarkBase {
     watch.stop();
     //stats.removeOutliers(10);
     return Score(
-      runtime: watch.elapsed,
+      duration: watch.elapsed,
       sample: sample.scores,
       innerIter: sample.innerIter,
     );
@@ -269,7 +269,7 @@ Future<void> asyncBenchmark<E extends ColorPrintEmitter>(
           error,
           stack,
           description: instance.description,
-          runtime: watch.elapsed,
+          duration: watch.elapsed,
           errorMark: benchmarkError,
         );
       }
@@ -280,7 +280,7 @@ Future<void> asyncBenchmark<E extends ColorPrintEmitter>(
         error,
         stack,
         description: instance.description,
-        runtime: watch.elapsed,
+        duration: watch.elapsed,
         errorMark: benchmarkError,
       );
     }),

lib/src/base/benchmark.dart

@@ -30,8 +30,8 @@ void reportMean(Benchmark instance, ColorPrintEmitter emitter) {
   final watch = Stopwatch()..start();
   final value = instance.measure();
   watch.stop();
-  final runtime = watch.elapsed.msus.style(ColorProfile.dim);
-  emitter.emit('$runtime ${instance.description}', value);
+  final duration = watch.elapsed.msus.style(ColorProfile.dim);
+  emitter.emit('$duration ${instance.description}', value);
 }
 
 /// Generic function that reports benchmark scores by calling an emitter [E].
@@ -146,7 +146,7 @@ class Benchmark extends BenchmarkBase {
     final watch = Stopwatch()..start();
     final sample = this.sample();
     return Score(
-      runtime: watch.elapsed,
+      duration: watch.elapsed,
       sample: sample.scores,
       innerIter: sample.innerIter,
     );
@@ -196,7 +196,7 @@ void benchmark<E extends ColorPrintEmitter>(
       error,
       stack,
       description: instance.description,
-      runtime: watch.elapsed,
+      duration: watch.elapsed,
       errorMark: benchmarkError,
     );
     return;
@@ -233,7 +233,7 @@ void benchmark<E extends ColorPrintEmitter>(
           error,
           stack,
           description: instance.description,
-          runtime: watch.elapsed,
+          duration: watch.elapsed,
           errorMark: benchmarkError,
         );
       }
@@ -244,7 +244,7 @@ void benchmark<E extends ColorPrintEmitter>(
         error,
         stack,
         description: instance.description,
-        runtime: watch.elapsed,
+        duration: watch.elapsed,
         errorMark: benchmarkError,
       );
     }),

lib/src/base/group.dart

@@ -41,7 +41,7 @@ class Group {
             error,
             stack,
             description: description,
-            runtime: watch.elapsed,
+            duration: watch.elapsed,
             errorMark: groupErrorMark,
           );
         }
@@ -52,7 +52,7 @@ class Group {
           error,
           stack,
           description: description,
-          runtime: watch.elapsed,
+          duration: watch.elapsed,
           errorMark: groupErrorMark,
         );
       }),
@@ -71,7 +71,7 @@ class Group {
           error,
           stack,
           description: description,
-          runtime: watch.elapsed,
+          duration: watch.elapsed,
           errorMark: groupErrorMark,
         );
       }),

lib/src/base/score.dart

@@ -1,13 +1,16 @@
 import '../util/stats.dart';
 
-/// Object holding sample stats and the sample generation runtime.
+/// Object holding sample stats and the duration it took to generate the
+/// score sample.
 class Score<T extends num> {
   Score(
-      {required this.runtime, required List<T> sample, required this.innerIter})
+      {required this.duration,
+      required List<T> sample,
+      required this.innerIter})
       : stats = Stats(sample);
 
-  /// Micro-benchmark duration
-  final Duration runtime;
+  /// Measured micro-benchmark duration
+  final Duration duration;
 
   /// Indicates if the a sample point was averaged over [iter] runs.
   final int innerIter;

lib/src/emitter/color_print_emitter.dart

@@ -28,7 +28,7 @@ class ColorPrintEmitter extends PrintEmitter {
   }) {
     //final indentCharacters = score.runtime.msus.length;
     final indent = '  ';
-    final part1 = '${score.runtime.msus.style(ColorProfile.dim)} $description';
+    final part1 = '${score.duration.msus.style(ColorProfile.dim)} $description';
 
     final mean = score.stats.mean / score.timeScale.factor;
     final stdDev = score.stats.stdDev / score.timeScale.factor;

lib/src/extension/string_utils.dart

@@ -27,15 +27,16 @@ void addSuccessMark([String mark = successMark]) {
 }
 
 /// Reports an error and adds an error mark
+/// [duration] refers to the measured benchmark duration. 
 void reportError(
   error,
   StackTrace stack, {
   required String description,
-  required Duration runtime,
+  required Duration duration,
   required String errorMark,
 }) {
   print(
-    '${runtime.ssms.style(ColorProfile.dim)} '
+    '${duration.ssms.style(ColorProfile.dim)} '
     '$description'
     '${errorMark == groupErrorMark ? ':' : ''} '
     '${error.toString().style(ColorProfile.error)}\n ',