Add a test runner executable.

lib/src/console_reporter.dart

 // 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 unittest.console_reporter;
 
 import 'dart:async';
 import 'dart:io';
 
 import 'engine.dart';
@@ skipping 31 matching lines @@
 
   /// A stopwatch that tracks the duration of the full run.
   final _stopwatch = new Stopwatch();
 
   /// The set of tests that have completed and been marked as passing.
   final _passed = new Set<LiveTest>();
 
   /// The set of tests that have completed and been marked as failing or error.
   final _failed = new Set<LiveTest>();
 
+  /// The size of [_passed] last time a progress notification was printed.
+  int _lastProgressPassed;
+
+  /// The size of [_failed] last time a progress notification was printed.
+  int _lastProgressFailed;
+
+  /// The message printed for the last progress notification.
+  String _lastProgressMessage;
+
   /// Creates a [ConsoleReporter] that will run all tests in [suites].
   ConsoleReporter(Iterable<Suite> suites)
       : _multipleSuites = suites.length > 1,
         _engine = new Engine(suites) {
 
     _engine.onTestStarted.listen((liveTest) {
       _progressLine(_description(liveTest));
       liveTest.onStateChange.listen((state) {
         if (state.status != Status.complete) return;
         if (state.result == Result.success) {
           _passed.add(liveTest);
         } else {
           _passed.remove(liveTest);
           _failed.add(liveTest);
         }
         _progressLine(_description(liveTest));
       });
 
       liveTest.onError.listen((error) {
         if (liveTest.state.status != Status.complete) return;
 
-        // TODO(nweiz): don't re-print the progress line if a test has multiple
-        // errors in a row.
         _progressLine(_description(liveTest));
         print('');
-        print(indent("${error.error}\n${error.stackTrace}"));
+        print(indent(error.error.toString()));
+        print(indent(terseChain(error.stackTrace).toString()));
       });
     });
   }
 
   /// Runs all tests in all provided suites.
   ///
   /// This returns `true` if all tests succeed, and `false` otherwise. It will
   /// only return once all tests have finished running.
   Future<bool> run() {
     if (_stopwatch.isRunning) {
       throw new StateError("ConsoleReporter.run() may not be called more than "
           "once.");
     }
 
+    if (_engine.liveTests.isEmpty) {
+      print("No tests ran.");
+      return new Future.value(true);
+    }
+
     _stopwatch.start();
     return _engine.run().then((success) {
-      if (_engine.liveTests.isEmpty) {
-        print("\nNo tests ran.");
-      } else if (success) {
+      if (success) {
         _progressLine("All tests passed!");
         print('');
       } else {
         _progressLine('Some tests failed.', color: _red);
         print('');
       }
 
       return success;
     });
   }
 
+  /// Signals that the caller is done with any test output and the reporter
+  /// should release any resources it has allocated.
+  Future close() => _engine.close();
+
   /// Prints a line representing the current state of the tests.
   ///
   /// [message] goes after the progress report, and may be truncated to fit the
   /// entire line within [_lineLength]. If [color] is passed, it's used as the
   /// color for [message].
   void _progressLine(String message, {String color}) {
+    // Print nothing if nothing has changed since the last progress line.
+    if (_passed.length == _lastProgressPassed &&
+        _failed.length == _lastProgressFailed &&
+        message == _lastProgressMessage) {
+      return;
+    }
+
+    _lastProgressPassed = _passed.length;
+    _lastProgressFailed = _failed.length;
+    _lastProgressMessage = message;
+
     if (color == null) color = '';
     var duration = _stopwatch.elapsed;
     var buffer = new StringBuffer();
 
     // \r moves back to the beginning of the current line.
     buffer.write('\r${_timeString(duration)} ');
     buffer.write(_green);
     buffer.write('+');
     buffer.write(_passed.length);
     buffer.write(_noColor);
@@ skipping 72 matching lines @@
 
   /// Returns a description of [liveTest].
   ///
   /// This differs from the test's own description in that it may also include
   /// the suite's name.
   String _description(LiveTest liveTest) {
     if (_multipleSuites) return "${liveTest.suite.name}: ${liveTest.test.name}";
     return liveTest.test.name;
   }
 }