Show detailed report on upgrade.

sdk/lib/_internal/pub/lib/src/log.dart

 // Copyright (c) 2012, 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.
 
 /// Message logging.
 library pub.log;
 
 import 'dart:async';
 import 'dart:collection';
 import 'dart:io';
@@ skipping 17 matching lines @@
 /// [recordTranscript()] is called.
 Transcript<Entry> _transcript;
 
 /// The timer used to write "..." during a progress log.
 Timer _progressTimer;
 
 /// The progress message as it's being incrementally appended. When the
 /// progress is done, a single entry will be added to the log for it.
 String _progressMessage;
 
+final _cyan = getSpecial('\u001b[36m');
 final _green = getSpecial('\u001b[32m');
+final _magenta = getSpecial('\u001b[35m');
 final _red = getSpecial('\u001b[31m');
 final _yellow = getSpecial('\u001b[33m');
 final _none = getSpecial('\u001b[0m');
+final _bold = getSpecial('\u001b[1m');
 
 /// An enum type for defining the different logging levels. By default, [ERROR]
 /// and [WARNING] messages are printed to sterr. [MESSAGE] messages are printed
 /// to stdout, and others are ignored.
 class Level {
   /// An error occurred and an operation could not be completed. Usually shown
   /// to the user on stderr.
   static const ERROR = const Level._("ERR ");
 
   /// Something unexpected happened, but the program was able to continue,
@@ skipping 159 matching lines @@
   stdout.write(_progressMessage);
 
   _progressTimer = new Timer.periodic(new Duration(milliseconds: 500), (_) {
     stdout.write('.');
     _progressMessage += '.';
   });
 
   return callback().whenComplete(_stopProgress);
 }
 
+/// Wraps [text] in the ANSI escape codes to make it bold when on a platform
+/// that supports that.
+///
+/// Use this to highlight the most important piece of a long chunk of text.
+String bold(text) => "$_bold$text$_none";
+
+/// Wraps [text] in the ANSI escape codes to color it cyan when on a platform
+/// that supports that.
+///
+/// Use this to highlight something interesting but neither good nor bad.
+String cyan(text) => "$_cyan$text$_none";
+
 /// Wraps [text] in the ANSI escape codes to color it green when on a platform
 /// that supports that.
+///
+/// Use this to highlight something successful or otherwise positive.
 String green(text) => "$_green$text$_none";
 
+/// Wraps [text] in the ANSI escape codes to color it magenta when on a
+/// platform that supports that.
+///
+/// Use this to highlight something risky that the user should be aware of but
+/// may intend to do.
+String magenta(text) => "$_magenta$text$_none";
+
 /// Wraps [text] in the ANSI escape codes to color it red when on a platform
 /// that supports that.
+///
+/// Use this to highlight unequivocal errors, problems, or failures.
 String red(text) => "$_red$text$_none";
 
 /// Wraps [text] in the ANSI escape codes to color it yellow when on a platform
 /// that supports that.
+///
+/// Use this to highlight warnings, cautions or other things that are bad but
+/// do not prevent the user's goal from being reached.
 String yellow(text) => "$_yellow$text$_none";
 
 /// Stops the running progress indicator, if currently running.
 _stopProgress() {
   if (_progressTimer == null) return;
 
   // Stop the timer.
   _progressTimer.cancel();
   _progressTimer = null;
   stdout.writeln();
@@ skipping 79 matching lines @@
       } else {
         sink.write('    | ');
       }
     }
 
     sink.writeln(line);
 
     firstLine = false;
   }
 }