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 library test.runner.reporter; | |
6 | |
7 /// An interface for classes that watch the progress of an Engine and report it | 5 /// An interface for classes that watch the progress of an Engine and report it |
8 /// to the user. | 6 /// to the user. |
9 /// | 7 /// |
10 /// A reporter should subscribe to the Engine's events as soon as it's created. | 8 /// A reporter should subscribe to the Engine's events as soon as it's created. |
11 abstract class Reporter { | 9 abstract class Reporter { |
12 /// Pauses the reporter's output. | 10 /// Pauses the reporter's output. |
13 /// | 11 /// |
14 /// Subclasses should buffer any events from the engine while they're paused. | 12 /// Subclasses should buffer any events from the engine while they're paused. |
15 /// They should also ensure that this does nothing if the reporter is already | 13 /// They should also ensure that this does nothing if the reporter is already |
16 /// paused. | 14 /// paused. |
17 void pause(); | 15 void pause(); |
18 | 16 |
19 /// Resumes the reporter's output after being [paused]. | 17 /// Resumes the reporter's output after being [paused]. |
20 /// | 18 /// |
21 /// Subclasses should ensure that this does nothing if the reporter isn't | 19 /// Subclasses should ensure that this does nothing if the reporter isn't |
22 /// paused. | 20 /// paused. |
23 void resume(); | 21 void resume(); |
24 | 22 |
25 /// Cancels the reporter's output. | 23 /// Cancels the reporter's output. |
26 void cancel(); | 24 void cancel(); |
27 } | 25 } |
OLD | NEW |