Thursday 24 September 2020

Color Console

 


In this post I'll discuss a small Console helper class I've been using to make it easier and more consistent to use colors with the .NET Console command. While colors are easy enough to access in the Console, to switch colors is a bit of a pain with the plain Console API. The simple class I present here makes it easier to write a line or string in a given color, write a line with multiple colors (using simple [color]text[/color] templating) and an easy way to create a header. The following is a very simple ColorConsole class that provides some useful color helpers:

  • WriteLine() and Write() methods with Color parameters
  • WriteError()WriteInfo()WriteSuccess() and WriteWarning() methods
  • A color template expansion WriteEmbeddedColorLine() function
  • A header generation routine

The Write methods let me quickly write output in a specific color without worrying about setting and resetting the color. The output is written with the specified color and the color is always reset to previously active color.

The high level wrappers like WriteError() and WriteSuccess() provide an alternative the raw Write methods and are more explicit about the intent of the message. It makes colors more consistent with color choices for common situations like error or informational statements.

I often find myself writing Console output that requires multiple more than a single color in a line of text when highlighting values over labels or displaying multiple values of difference importance. I can use multiple Write() statements with colors for this, but to make this easier to read I created a templated method that allows delimiting text with [color]text[/color] delimiters in a string.

csharp
ColorConsole.WriteEmbeddedColorLine($"Site Url: [darkcyan]{ServerConfig.GetHttpUrl()}[/darkcyan] [darkgray](binding: {HostUrl})[darkgray]");

Try it out

To use the class looks something like this:

csharp
static void Main(string[] args) { ColorConsole.WriteWrappedHeader("Color Console Examples"); Console.WriteLine("\nUsing a splash of color in your Console code more easily... (plain text)\n"); ColorConsole.WriteLine("Color me this - in Red", ConsoleColor.Red); ColorConsole.WriteWrappedHeader("Off with their green Heads!", headerColor: ConsoleColor.Green); ColorConsole.WriteWarning("\nWorking...\n"); Console.WriteLine("Writing some mixed colors: (plain text)"); ColorConsole.WriteEmbeddedColorLine( "Launch the site with [darkcyan]https://localhost:5200[/darkcyan] and press [yellow]Ctrl-c[/yellow] to exit.\n"); ColorConsole.WriteSuccess("The operation completed successfully."); }

which produces the following output:

Code

Here's the ColorConsole class:

csharp
/// <summary> /// Console Color Helper class that provides coloring to individual commands /// </summary> public static class ColorConsole { /// <summary> /// WriteLine with color /// </summary> /// <param name="text"></param> /// <param name="color"></param> public static void WriteLine(string text, ConsoleColor? color = null) { if (color.HasValue) { var oldColor = System.Console.ForegroundColor; if (color == oldColor) Console.WriteLine(text); else { Console.ForegroundColor = color.Value; Console.WriteLine(text); Console.ForegroundColor = oldColor; } } else Console.WriteLine(text); } /// <summary> /// Writes out a line with a specific color as a string /// </summary> /// <param name="text">Text to write</param> /// <param name="color">A console color. Must match ConsoleColors collection names (case insensitive)</param> public static void WriteLine(string text, string color) { if (string.IsNullOrEmpty(color)) { WriteLine(text); return; } if (!Enum.TryParse(color, true, out ConsoleColor col)) { WriteLine(text); } else { WriteLine(text, col); } } /// <summary> /// Write with color /// </summary> /// <param name="text"></param> /// <param name="color"></param> public static void Write(string text, ConsoleColor? color = null) { if (color.HasValue) { var oldColor = System.Console.ForegroundColor; if (color == oldColor) Console.Write(text); else { Console.ForegroundColor = color.Value; Console.Write(text); Console.ForegroundColor = oldColor; } } else Console.Write(text); } /// <summary> /// Writes out a line with color specified as a string /// </summary> /// <param name="text">Text to write</param> /// <param name="color">A console color. Must match ConsoleColors collection names (case insensitive)</param> public static void Write(string text, string color) { if (string.IsNullOrEmpty(color)) { Write(text); return; } if (!ConsoleColor.TryParse(color, true, out ConsoleColor col)) { Write(text); } else { Write(text, col); } } #region Wrappers and Templates /// <summary> /// Writes a line of header text wrapped in a in a pair of lines of dashes: /// ----------- /// Header Text /// ----------- /// and allows you to specify a color for the header. The dashes are colored /// </summary> /// <param name="headerText">Header text to display</param> /// <param name="wrapperChar">wrapper character (-)</param> /// <param name="headerColor">Color for header text (yellow)</param> /// <param name="dashColor">Color for dashes (gray)</param> public static void WriteWrappedHeader(string headerText, char wrapperChar = '-', ConsoleColor headerColor = ConsoleColor.Yellow, ConsoleColor dashColor = ConsoleColor.DarkGray) { if (string.IsNullOrEmpty(headerText)) return; string line = new string(wrapperChar, headerText.Length); WriteLine(line,dashColor); WriteLine(headerText, headerColor); WriteLine(line,dashColor); } private static Lazy<Regex> colorBlockRegEx = new Lazy<Regex>( ()=> new Regex("\\[(?<color>.*?)\\](?<text>[^[]*)\\[/\\k<color>\\]", RegexOptions.IgnoreCase), isThreadSafe: true); /// <summary> /// Allows a string to be written with embedded color values using: /// This is [red]Red[/red] text and this is [cyan]Blue[/blue] text /// </summary> /// <param name="text">Text to display</param> /// <param name="baseTextColor">Base text color</param> public static void WriteEmbeddedColorLine(string text, ConsoleColor? baseTextColor = null) { if (baseTextColor == null) baseTextColor = Console.ForegroundColor; if (string.IsNullOrEmpty(text)) { WriteLine(string.Empty); return; } int at = text.IndexOf("["); int at2 = text.IndexOf("]"); if (at == -1 || at2 <= at) { WriteLine(text, baseTextColor); return; } while (true) { var match = colorBlockRegEx.Value.Match(text); if (match.Length < 1) { Write(text, baseTextColor); break; } // write up to expression Write(text.Substring(0, match.Index), baseTextColor); // strip out the expression string highlightText = match.Groups["text"].Value; string colorVal = match.Groups["color"].Value; Write(highlightText, colorVal); // remainder of string text = text.Substring(match.Index + match.Value.Length); } Console.WriteLine(); } #endregion #region Success, Error, Info, Warning Wrappers /// <summary> /// Write a Success Line - green /// </summary> /// <param name="text">Text to write out</param> public static void WriteSuccess(string text) { WriteLine(text, ConsoleColor.Green); } /// <summary> /// Write a Error Line - Red /// </summary> /// <param name="text">Text to write out</param> public static void WriteError(string text) { WriteLine(text, ConsoleColor.Red); } /// <summary> /// Write a Warning Line - Yellow /// </summary> /// <param name="text">Text to Write out</param> public static void WriteWarning(string text) { WriteLine(text, ConsoleColor.DarkYellow); } /// <summary> /// Write a Info Line - dark cyan /// </summary> /// <param name="text">Text to write out</param> public static void WriteInfo(string text) { WriteLine(text, ConsoleColor.DarkCyan); } #endregion }


Summary

Nothing fancy, and nothing you couldn't come up with in a few minutes yourself, but I find these super helpful and end up using this in just about any Console application now to make it easier to print help screens and provide basic status and progress information. Maybe some of you will find these useful as well...

No comments:

Post a Comment

Hide New... button on lookup controls in model-driven apps

  The 'New ...' button is shown upon opening the lookup search dialog whenever the logged in user has at least user create privileg...