0e339e44b00511a6734c8f4a982f9f2c4984a7c6 - clock

commit	0e339e44b00511a6734c8f4a982f9f2c4984a7c6	[log] [tgz]
author	Natalie Weizenbaum <nweiz@google.com>	Wed May 02 13:01:53 2018 -0700
committer	GitHub <noreply@github.com>	Wed May 02 13:01:53 2018 -0700
tree	63022888e3ffb6ba9feeaddbfcebe5cbb137309c
parent	8b6ba73cf13549d7fc5d3635df0f263589f912ce [diff]

tree: 63022888e3ffb6ba9feeaddbfcebe5cbb137309c

README.md

This package provides a Clock class which encapsulates the notion of the “current time” and provides easy access to points relative to the current time. Different Clocks can have a different notion of the current time, and the default top-level clock's notion can be swapped out to reliably test timing-dependent code.

For example, you can use clock in your libraries like this:

// run_with_timing.dart
import 'package:clock/clock.dart';

/// Runs [callback] and prints how long it took.
T runWithTiming<T>(T callback()) {
  var stopwatch = clock.stopwatch()..start();
  var result = callback();
  print("It took ${stopwatch.elapsed}!");
  return result;
}

...and then test your code using the fake_async package, which automatically overrides the current clock:

// run_with_timing_test.dart
import 'run_with_timing.dart';

import 'package:fake_async/fake_async.dart';
import 'package:test/test.dart';

void main() {
  test("runWithTiming() prints the elapsed time", () {
    new FakeAsync().run((async) {
      expect(() {
        runWithTiming(() {
          async.elapse(new Duration(seconds: 10));
        });
      }, prints("It took 0:00:10.000000!"));
    });
  });
}