Support configuring timeouts per-test and -group.

lib/test.dart

 // Copyright (c) 2013, 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;
 
 import 'dart:async';
 
 import 'package:path/path.dart' as p;
 
 import 'src/backend/declarer.dart';
 import 'src/backend/invoker.dart';
 import 'src/backend/suite.dart';
 import 'src/backend/test_platform.dart';
+import 'src/frontend/timeout.dart';
 import 'src/runner/reporter/no_io_compact.dart';
 import 'src/utils.dart';
 
 export 'package:matcher/matcher.dart';
 
 export 'src/frontend/expect.dart';
 export 'src/frontend/expect_async.dart';
 export 'src/frontend/future_matchers.dart';
 export 'src/frontend/prints_matcher.dart';
 export 'src/frontend/test_on.dart';
 export 'src/frontend/throws_matcher.dart';
 export 'src/frontend/throws_matchers.dart';
+export 'src/frontend/timeout.dart';
 
 /// The global declarer.
 ///
 /// This is used if a test file is run directly, rather than through the runner.
 Declarer _globalDeclarer;
 
 /// Gets the declarer for the current scope.
 ///
 /// When using the runner, this returns the [Zone]-scoped declarer that's set by
 /// [IsolateListener] or [IframeListener]. If the test file is run directly,
@@ skipping 22 matching lines @@
 
 // TODO(nweiz): This and other top-level functions should throw exceptions if
 // they're called after the declarer has finished declaring.
 /// Creates a new test case with the given description and body.
 ///
 /// The description will be added to the descriptions of any surrounding
 /// [group]s. If [testOn] is passed, it's parsed as a [platform selector][]; the
 /// test will only be run on matching platforms.
 ///
 /// [platform selector]: https://github.com/dart-lang/test/#platform-selector-syntax
-void test(String description, body(), {String testOn}) =>
-    _declarer.test(description, body, testOn: testOn);
+///
+/// If [timeout] is passed, it's used to modify or replace the default timeout
+/// of 30 seconds. Timeout modifications take precedence in suite-group-test
+/// order, so [timeout] will also modify any timeouts set on the group or suite.
+void test(String description, body(), {String testOn, Timeout timeout}) =>
+    _declarer.test(description, body, testOn: testOn, timeout: timeout);
 
 /// Creates a group of tests.
 ///
 /// A group's description is included in the descriptions of any tests or
 /// sub-groups it contains. [setUp] and [tearDown] are also scoped to the
 /// containing group.
 ///
 /// If [testOn] is passed, it's parsed as a [platform selector][]; the test will
 /// only be run on matching platforms.
 ///
 /// [platform selector]: https://github.com/dart-lang/test/#platform-selector-syntax
-void group(String description, void body(), {String testOn}) =>
-    _declarer.group(description, body, testOn: testOn);
+///
+/// If [timeout] is passed, it's used to modify or replace the default timeout
+/// of 30 seconds. Timeout modifications take precedence in suite-group-test
+/// order, so [timeout] will also modify any timeouts set on the suite, and will
+/// be modified by any timeouts set on individual tests.
+void group(String description, void body(), {String testOn, Timeout timeout}) =>
+    _declarer.group(description, body, testOn: testOn, timeout: timeout);
 
 /// Registers a function to be run before tests.
 ///
 /// This function will be called before each test is run. [callback] may be
 /// asynchronous; if so, it must return a [Future].
 ///
 /// If this is called within a test group, it applies only to tests in that
 /// group. [callback] will be run after any set-up callbacks in parent groups or
 /// at the top level.
 void setUp(callback()) => _declarer.setUp(callback);
@@ skipping 10 matching lines @@
 
 /// Handle an error that occurs outside of any test.
 void handleExternalError(error, String message, [stackTrace]) {
   // TODO(nweiz): handle this better.
   registerException(error, stackTrace);
 }
 
 /// Registers an exception that was caught for the current test.
 void registerException(error, [StackTrace stackTrace]) =>
     Invoker.current.handleError(error, stackTrace);