From caf108ecf4af975954fd19750be4771ef3c2fc20 Mon Sep 17 00:00:00 2001 From: Ivan Dlugos Date: Mon, 16 Aug 2021 18:47:42 +0200 Subject: [PATCH] v0.6.0 release prep --- CHANGELOG.md | 5 +++++ README.md | 37 +++++++++++++++++++------------------ pubspec.yaml | 4 ++-- 3 files changed, 26 insertions(+), 20 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index fcd7927..978cf64 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,8 @@ +## 0.6.0 + +- class-based benchmarks - automatic naming, if not providen explicitly +- printer - automatic duration formatting and unit selection + ## 0.5.0 - Initial version. diff --git a/README.md b/README.md index 0ccd0ee..55956ea 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,11 @@ # Benchmarking -Provides tools to measure performance of your code. You can run simple micro-benchmarks while picking the best approach for the function you're just writing, or benchmark more complex code with greater control on setup and teardown. +This package provides tools to measure performance of your code. Some features: -There's first-class support for both synchronous as well as **`async`** code so that you get the most accurate measurements at all times. - -You can also choose from two approaches to define your benchmarks - do it via a class-based interface, like with `package:benchmark_harness` or a functional one, like writing tests with `package:test`. +* first-class support both **sync** and **async** code +* a class-based interface (like `package:benchmark_harness`) +* a functional interface (like `package:test`) +* handles simple micro-benchmarks as well as more complex ones (with setup and teardown functions) ## Writing your own bechmarks @@ -36,20 +37,20 @@ A result of running the benchmark would look something like: $ dart run example/benchmarking.dart Map[k] - total runs: 8 801 - total time: 2 000.1 ms - average run: 0.2270 ms - runs/second: 4 405.3 - units: 10 000 - units/second: 4 405.3 - time per unit: 0.0227 μs + total runs: 8 384 + total time: 2.0002 s + average run: 238 μs + runs/second: 4 201.7 + units: 10 000 + units/second: 4 201.7 + time per unit: 0.0238 μs HashMap[k] - total runs: 18 839 - total time: 2 000.0 ms - average run: 0.1060 ms - runs/second: 9 434.0 - units: 10 000 - units/second: 9 434.0 - time per unit: 0.0106 μs + total runs: 16 459 + total time: 2.0000 s + average run: 121 μs + runs/second: 8 264.5 + units: 10 000 + units/second: 8 264.5 + time per unit: 0.0121 μs ``` diff --git a/pubspec.yaml b/pubspec.yaml index ed82d35..158ebc9 100644 --- a/pubspec.yaml +++ b/pubspec.yaml @@ -1,6 +1,6 @@ name: benchmarking -description: Tools to run benchmarks with ease and control. -version: 0.5.0 +description: Tools to run (sync and async) benchmarks with ease and control. +version: 0.6.0 repository: https://github.com/vaind/benchmarking.dart environment: