PanoramicData.ConsoleExtensions

Extensions for the System.Console namespace

install-package PanoramicData.ConsoleExtensions

ConsolePlus.ReadPassword

This method provides a simple and safe way to read a password from the command line, including permitting the user to use the backspace key.

using PanoramicData.ConsoleExtensions;

...

Console.Write("Password: ");
var password = ConsolePlus.ReadPassword();
Console.WriteLine();

ConsoleLogger

This class provides a simple ILogger implementation for the command line. It implements colored logging, with control over the color used for each log level and sensible defaults.

Basic Usage

using PanoramicData.ConsoleExtensions;

...

var consoleLogger1 = new ConsoleLogger();
consoleLogger1.LogInformation("The Date is {DateTime:yyyy-MM-dd}", DateTime.UtcNow);

var consoleLogger2 = new ConsoleLogger(new ConsoleLoggerOptions
	{
		TraceColor = ConsoleColor.DarkYellow,
		LogLevel = LogLevel.Debug
	});
consoleLogger2.LogTrace("The Date is {DateTime:yyyy-MM-dd}", DateTime.UtcNow);
consoleLogger2.LogError(exception, "Failure occurred at {DateTime:yyyy-MM-dd}", DateTime.UtcNow);

Structured Logging Features

The ConsoleLogger supports advanced structured logging features while maintaining backward compatibility:

Timestamps and Custom Formatting

var options = new ConsoleLoggerOptions
{
    IncludeTimestamp = true,
    IncludeEventId = true,
    TimeFormat = "yyyy-MM-dd HH:mm:ss.fff",
    OutputFormat = "{Timestamp} [{Level}] ({EventId}) {Message}"
};
var logger = new ConsoleLogger(options);
logger.LogInformation(new EventId(1001), "User {UserName} logged in", "Alice");

Hyperlink Support

URLs and file paths are automatically detected and made clickable in supported terminals:

var options = new ConsoleLoggerOptions { EnableHyperlinks = true };
var logger = new ConsoleLogger(options);
logger.LogInformation("Visit https://github.com/panoramicdata/PanoramicData.ConsoleExtensions");
logger.LogInformation("Error in file: C:\\Source\\MyProject\\Program.cs");

Exception Formatting

Choose between detailed multi-line or compact single-line exception formatting:

var options = new ConsoleLoggerOptions { SingleLineExceptions = true };
var logger = new ConsoleLogger(options);
logger.LogError(exception, "Operation failed");

Demo Application

A comprehensive demo application is included in the PanoramicData.ConsoleExtensions.Demo project that showcases all the library features: