Skip to content

Commit caf108e

Browse files
committed
v0.6.0 release prep
1 parent 5754276 commit caf108e

File tree

3 files changed

+26
-20
lines changed

3 files changed

+26
-20
lines changed

CHANGELOG.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,8 @@
1+
## 0.6.0
2+
3+
- class-based benchmarks - automatic naming, if not providen explicitly
4+
- printer - automatic duration formatting and unit selection
5+
16
## 0.5.0
27

38
- Initial version.

README.md

Lines changed: 19 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
11
# Benchmarking
22

3-
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.
3+
This package provides tools to measure performance of your code. Some features:
44

5-
There's first-class support for both synchronous as well as **`async`** code so that you get the most accurate measurements at all times.
6-
7-
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`.
5+
* first-class support both **sync** and **async** code
6+
* a class-based interface (like `package:benchmark_harness`)
7+
* a functional interface (like `package:test`)
8+
* handles simple micro-benchmarks as well as more complex ones (with setup and teardown functions)
89

910
## Writing your own bechmarks
1011

@@ -36,20 +37,20 @@ A result of running the benchmark would look something like:
3637
$ dart run example/benchmarking.dart
3738

3839
Map[k]
39-
total runs: 8 801
40-
total time: 2 000.1 ms
41-
average run: 0.2270 ms
42-
runs/second: 4 405.3
43-
units: 10 000
44-
units/second: 4 405.3
45-
time per unit: 0.0227 μs
40+
total runs: 8 384
41+
total time: 2.0002 s
42+
average run: 238 μs
43+
runs/second: 4 201.7
44+
units: 10 000
45+
units/second: 4 201.7
46+
time per unit: 0.0238 μs
4647

4748
HashMap[k]
48-
total runs: 18 839
49-
total time: 2 000.0 ms
50-
average run: 0.1060 ms
51-
runs/second: 9 434.0
52-
units: 10 000
53-
units/second: 9 434.0
54-
time per unit: 0.0106 μs
49+
total runs: 16 459
50+
total time: 2.0000 s
51+
average run: 121 μs
52+
runs/second: 8 264.5
53+
units: 10 000
54+
units/second: 8 264.5
55+
time per unit: 0.0121 μs
5556
```

pubspec.yaml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
name: benchmarking
2-
description: Tools to run benchmarks with ease and control.
3-
version: 0.5.0
2+
description: Tools to run (sync and async) benchmarks with ease and control.
3+
version: 0.6.0
44
repository: https://github.com/vaind/benchmarking.dart
55

66
environment:

0 commit comments

Comments
 (0)