Index: mojo/public/dart/third_party/test/lib/src/runner/load_suite.dart |
diff --git a/mojo/public/dart/third_party/test/lib/src/runner/load_suite.dart b/mojo/public/dart/third_party/test/lib/src/runner/load_suite.dart |
new file mode 100644 |
index 0000000000000000000000000000000000000000..0c1dabc5fa91afd3dae58b71e3d901b12b2272bb |
--- /dev/null |
+++ b/mojo/public/dart/third_party/test/lib/src/runner/load_suite.dart |
@@ -0,0 +1,139 @@ |
+// 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.runner.load_suite; |
+ |
+import 'dart:async'; |
+ |
+import 'package:stack_trace/stack_trace.dart'; |
+ |
+import '../../test.dart'; |
+import '../backend/invoker.dart'; |
+import '../backend/metadata.dart'; |
+import '../backend/test_platform.dart'; |
+import '../utils.dart'; |
+import 'load_exception.dart'; |
+import 'runner_suite.dart'; |
+import 'vm/environment.dart'; |
+ |
+/// A [Suite] emitted by a [Loader] that provides a test-like interface for |
+/// loading a test file. |
+/// |
+/// This is used to expose the current status of test loading to the user. It's |
+/// important to provide users visibility into what's taking a long time and |
+/// where failures occur. And since some tests may be loaded at the same time as |
+/// others are run, it's useful to provide that visibility in the form of a test |
+/// suite so that it can integrate well into the existing reporting interface |
+/// without too much extra logic. |
+/// |
+/// A suite is constructed with logic necessary to produce a test suite. As with |
+/// a normal test body, this logic isn't run until [LiveTest.run] is called. The |
+/// suite itself is returned by [suite] once it's avaialble, but any errors or |
+/// prints will be emitted through the running [LiveTest]. |
+class LoadSuite extends RunnerSuite { |
+ /// A future that completes to the loaded suite once the suite's test has been |
+ /// run and completed successfully. |
+ /// |
+ /// This will return `null` if the suite is unavailable for some reason (for |
+ /// example if an error occurred while loading it). |
+ final Future<RunnerSuite> suite; |
+ |
+ /// Creates a load suite named [name] on [platform]. |
+ /// |
+ /// [body] may return either a [RunnerSuite] or a [Future] that completes to a |
+ /// [RunnerSuite]. Its return value is forwarded through [suite], although if |
+ /// it throws an error that will be forwarded through the suite's test. |
+ /// |
+ /// If the the load test is closed before [body] is complete, it will close |
+ /// the suite returned by [body] once it completes. |
+ factory LoadSuite(String name, body(), {TestPlatform platform}) { |
+ var completer = new Completer.sync(); |
+ return new LoadSuite._(name, () { |
+ var invoker = Invoker.current; |
+ invoker.addOutstandingCallback(); |
+ |
+ invoke(() async { |
+ try { |
+ var suite = await body(); |
+ if (completer.isCompleted) { |
+ // If the load test has already been closed, close the suite it |
+ // generated. |
+ suite.close(); |
+ return; |
+ } |
+ |
+ completer.complete(suite); |
+ invoker.removeOutstandingCallback(); |
+ } catch (error, stackTrace) { |
+ registerException(error, stackTrace); |
+ if (!completer.isCompleted) completer.complete(); |
+ } |
+ }); |
+ |
+ // If the test is forcibly closed, exit immediately. It doesn't have any |
+ // cleanup to do that won't be handled by Loader.close. |
+ invoker.onClose.then((_) { |
+ if (completer.isCompleted) return; |
+ completer.complete(); |
+ invoker.removeOutstandingCallback(); |
+ }); |
+ }, completer.future, platform: platform); |
+ } |
+ |
+ /// A utility constructor for a load suite that just throws [exception]. |
+ /// |
+ /// The suite's name will be based on [exception]'s path. |
+ factory LoadSuite.forLoadException(LoadException exception, |
+ {StackTrace stackTrace, TestPlatform platform}) { |
+ if (stackTrace == null) stackTrace = new Trace.current(); |
+ |
+ return new LoadSuite("loading ${exception.path}", () { |
+ return new Future.error(exception, stackTrace); |
+ }, platform: platform); |
+ } |
+ |
+ /// A utility constructor for a load suite that just emits [suite]. |
+ factory LoadSuite.forSuite(RunnerSuite suite) { |
+ return new LoadSuite("loading ${suite.path}", () => suite, |
+ platform: suite.platform); |
+ } |
+ |
+ LoadSuite._(String name, void body(), this.suite, {TestPlatform platform}) |
+ : super(const VMEnvironment(), [ |
+ new LocalTest(name, |
+ new Metadata(timeout: new Timeout(new Duration(minutes: 5))), |
+ body) |
+ ], platform: platform); |
+ |
+ /// A constructor used by [changeSuite]. |
+ LoadSuite._changeSuite(LoadSuite old, Future<RunnerSuite> this.suite) |
+ : super(const VMEnvironment(), old.tests, platform: old.platform); |
+ |
+ /// Creates a new [LoadSuite] that's identical to this one, but that |
+ /// transforms [suite] once it's loaded. |
+ /// |
+ /// If [suite] completes to `null`, [change] won't be run. |
+ LoadSuite changeSuite(RunnerSuite change(RunnerSuite suite)) { |
+ return new LoadSuite._changeSuite(this, suite.then((loadedSuite) { |
+ if (loadedSuite == null) return null; |
+ return change(loadedSuite); |
+ })); |
+ } |
+ |
+ /// Runs the test and returns the suite. |
+ /// |
+ /// Rather than emitting errors through a [LiveTest], this just pipes them |
+ /// through the return value. |
+ Future<RunnerSuite> getSuite() async { |
+ var liveTest = await tests.single.load(this); |
+ liveTest.onPrint.listen(print); |
+ await liveTest.run(); |
+ |
+ if (liveTest.errors.isEmpty) return await suite; |
+ |
+ var error = liveTest.errors.first; |
+ await new Future.error(error.error, error.stackTrace); |
+ throw 'unreachable'; |
+ } |
+} |