| 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 |