XConsole 1.0.4

XConsole

Extended .NET console with coloring microsyntax, multiline pinning, write-to-position, etc. Safe for multitasking, safe for >9000 lines, easy to use.

The main features are shown in the following image:

<br><br>

• Install
• Setup
• Coloring
• Pinning
• Positioning
• License <br>

<a name="install"></a>Install

By Package Manager:

PM> Install-Package XConsole

By adding to *.csproj file:

<PackageReference Include="XConsole" Version="1.0.*" />

More ways to install see on NuGet Gallery. <br><br>

<a name="setup"></a>Setup

Simplest way to start using the XConsole is by adding using to your code:

namespace MyProject
{
    using Console = XConsole;
    ...

After that you can write Console as usual and get all the features of XConsole.

This trick is also great for upgrading your regular console application, because the XConsole is backwards compatible with the standard Console. Once you add using, your application will not change how it works unless you want to start using the XConsole features. <br><br>

<a name="coloring"></a>Coloring

To colorize the text you need to add a prefix to a string. The prefix consists of one or two letters denoting colors, followed by a trailing ` character, after which the text immediately begins.

Let’s denote the text color letter as X and the background color letter as Z. In this case, there are three prefix patterns: X` to change text color, Z ` to change background color, ZX` to change both colors.

For example, to colorize text to green just add G` prefix (G means green):

Console.WriteLine("G`This log message is colorized using microsyntax");

To make a multicolor message split it to parts with individual color prefixes and pass them to single WriteLine method. Be sure that your messages will not be broken by other threads.

Console.WriteLine("C`It is easy ", "bW`to use many", "R` colors in ", "Y`one message");

The following table shows all possible colors and their letter designations:

<br><br>

<a name="pinning"></a>Pinning

You can pin some text below regular log messages with the Pin method. Pinned text can be static or dynamic, contain one or more lines, and of course can be colorized. Pin is resistant to line wrapping and to console buffer overflows (>9000 log lines).

Static pin

Console.Pin("Simple static pin");           // Simple static pin
Console.Pin("Y`Multicolor", " static pin"); // Multicolor static pin
Console.Pin("Multiline\nstatic pin");       // Multiline static pin

Dynamic pin

Console.Pin(() => "Simple pin, value=" + value);                           // Simple dynamic pin
Console.Pin(() => new[] { "Y`Multicolor", " pin, value=", "C`" + value }); // Multicolor dynamic pin
Console.Pin(() => new[] { "Multiline pin,\nvalue=", "C`" + value });       // Multiline dynamic pin

The dynamic pin will be automatically updated every time the Write or WriteLine methods are called. You can also update a dynamic pin manually using the UpdatePin method:

Console.UpdatePin(); // Update dynamic pin manually

To remove a pin, call the Unpin method:

Console.Unpin(); // Remove pin

<br>

<a name="positioning"></a>Positioning

XConsole provides an XConsolePosition structure, which is a position in the console area. This is an important feature if you have a lot of log messages. This structure is resistant to console buffer overflows (>9000 log lines) and always points to the correct position in the console area.

Each Write and WriteLine method returns a start and end position. You can save them and use later to rewrite the text or add text to the end of the message. To do this, XConsolePosition has its own Write method, which returns a new end position.

NB! The end position of WriteLine means the position after the last character before the line break.

var (begin, end) = Console.WriteLine("Hello, World!"); // Write message and save positions

begin.Write("C`HELLO");       // Rewrite part of text
end = end.Write(" I'm here"); // Add text to the end and update end position
end.Write("Y`!");

<br><br> You can also get or set XConsolePosition of the cursor using the CursorPosition property:

XConsolePosition position = Console.CursorPosition;              // Get cursor position
Console.CursorPosition = new XConsolePosition(left: 15, top: 5); // Set cursor position

<br>

<a name="license"></a>License

The XConsole is licensed under the MIT license. <br><br>