Support configuring timeouts per-test and -group.

lib/src/frontend/timeout.dart

+// Copyright (c) 2015, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+library test.frontend.timeout;
+
+/// A class representing a modification to the default timeout for a test.
+///
+/// By default, a test will time out after 30 seconds. With [new Timeout], that
+/// can be overridden entirely; with [new Timeout.factor], it can be scaled
+/// relative to the default.
+class Timeout {
+  /// The timeout duration.
+  ///
+  /// If set, this overrides the default duration entirely. It will be
+  /// non-`null` only when [scaleFactor] is `null`.
+  final Duration duration;
+
+  /// The timeout factor.
+  ///
+  /// The default timeout will be multiplied by this to get the new timeout.
+  /// Thus a factor of 2 means that the test will take twice as long to time
+  /// out, and a factor of 0.5 means that it will time out twice as quickly.
+  final num scaleFactor;
+
+  /// Declares an absolute timeout that overrides the default.
+  const Timeout(this.duration)
+      : scaleFactor = null;
+
+  /// Declares a relative timeout that scales the default.
+  const Timeout.factor(this.scaleFactor)
+      : duration = null;
+
+  /// Returns a new [Timeout] that merges [this] with [other].
+  ///
+  /// If [other] declares a [duration], that takes precedence. Otherwise, this
+  /// timeout's [duration] or [factor] are multiplied by [other]'s [factor].
+  Timeout merge(Timeout other) {
+    if (other.duration != null) return new Timeout(other.duration);
+    if (duration != null) return new Timeout(duration * other.scaleFactor);
+    return new Timeout.factor(scaleFactor * other.scaleFactor);
+  }
+
+  /// Returns a new [Duration] from applying [this] to [base].
+  Duration apply(Duration base) =>
+      duration == null ? base * scaleFactor : duration;
+}