| OLD | NEW |
| 1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 import 'dart:async'; | 5 import 'dart:async'; |
| 6 | 6 |
| 7 import 'group.dart'; | 7 import 'group.dart'; |
| 8 import 'state.dart'; | 8 import 'state.dart'; |
| 9 import 'suite.dart'; | 9 import 'suite.dart'; |
| 10 import 'test.dart'; | 10 import 'test.dart'; |
| 11 | 11 |
| 12 /// A runnable instance of a test. | 12 /// A runnable instance of a test. |
| 13 /// | 13 /// |
| 14 /// This is distinct from [Test] in order to keep [Test]. Running a test | 14 /// This is distinct from [Test] in order to keep [Test] immutable. Running a |
| 15 /// requires state, and [LiveTest] provides a view of the state of the test as | 15 /// test requires state, and [LiveTest] provides a view of the state of the test |
| 16 /// it runs. | 16 /// as it runs. |
| 17 /// | 17 /// |
| 18 /// If the state changes, [state] will be updated before [onStateChange] fires. | 18 /// If the state changes, [state] will be updated before [onStateChange] fires. |
| 19 /// Likewise, if an error is caught, it will be added to [errors] before being | 19 /// Likewise, if an error is caught, it will be added to [errors] before being |
| 20 /// emitted via [onError]. If an error causes a state change, [onStateChange] | 20 /// emitted via [onError]. If an error causes a state change, [onStateChange] |
| 21 /// will fire before [onError]. If an error or other state change causes the | 21 /// will fire before [onError]. If an error or other state change causes the |
| 22 /// test to complete, [onComplete] will complete after [onStateChange] and | 22 /// test to complete, [onComplete] will complete after [onStateChange] and |
| 23 /// [onError] fire. | 23 /// [onError] fire. |
| 24 abstract class LiveTest { | 24 abstract class LiveTest { |
| 25 /// The suite within which this test is being run. | 25 /// The suite within which this test is being run. |
| 26 Suite get suite; | 26 Suite get suite; |
| (...skipping 111 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 138 /// | 138 /// |
| 139 /// This doesn't automatically happen after the test completes because there | 139 /// This doesn't automatically happen after the test completes because there |
| 140 /// may be more asynchronous work going on in the background that could | 140 /// may be more asynchronous work going on in the background that could |
| 141 /// produce new errors. | 141 /// produce new errors. |
| 142 /// | 142 /// |
| 143 /// Returns a [Future] that completes once all resources are released *and* | 143 /// Returns a [Future] that completes once all resources are released *and* |
| 144 /// the test has completed. This allows the caller to wait until the test's | 144 /// the test has completed. This allows the caller to wait until the test's |
| 145 /// tear-down logic has run. | 145 /// tear-down logic has run. |
| 146 Future close(); | 146 Future close(); |
| 147 } | 147 } |
| OLD | NEW |