ConsoleTable.Text 1.0.2

ConsoleTable.Text

A lightweight .NET library for creating beautifully formatted console tables with customizable headers, rows, padding, and text alignment.

Features

• Create formatted tables as a string with headers and data rows
• Unicode box-drawing characters for clean borders
• Automatic column width calculation
• Configurable cell padding
• Text alignment options (left/right) for headers and rows
• Easy clearing and reusing of tables
• Simple and intuitive API
• Optimized for performance
• Support for varying column counts across rows (each row can have its own number of cells).

Releases

Check releases for the changelog here https://github.com/BrunoVT1992/ConsoleTable/releases/

Installation

Package Manager

Install-Package ConsoleTable.Text

.NET CLI

dotnet add package ConsoleTable.Text

PackageReference

<PackageReference Include="ConsoleTable.Text" Version="1.0.0" />

nuget.org

Download this nuget package from https://www.nuget.org/packages/ConsoleTable.Text

Quick Start

using ConsoleTable.Text;

var table = new Table();

// Set headers
table.SetHeaders("Name", "Age", "City");

// Add rows
table.AddRow("Alice Cooper", "30", "New York");

table.AddRows(new string[][]
{
    new string[] { "Bob", "25", "Los Angeles" },
    new string[] { "Charlie Brown", "47", "Chicago" }
});

// Display the table
Console.WriteLine(table.ToTable());

Output:

┌─────────┬─────┬─────────────┐
│ Name    │ Age │ City        │
├─────────┼─────┼─────────────┤
│ Alice   │ 30  │ New York    │
├─────────┼─────┼─────────────┤
│ Bob     │ 25  │ Los Angeles │
├─────────┼─────┼─────────────┤
│ Charlie │ 47  │ Chicago     │
└─────────┴─────┴─────────────┘

API Reference

Properties

Methods

Examples

Custom Padding

using ConsoleTable.Text;

var table = new Table { Padding = 10 };

table.SetHeaders("Name", "Age", "City");

table.AddRows(
    new string[] { "Alice", "30", "New York" },
    new string[] { "Bob", "25", "Los Angeles" },
    new string[] { "Charlie", "47", "Chicago" }
);

Console.WriteLine(table.ToTable());

Output:

┌───────────────────────────┬───────────────────────┬───────────────────────────────┐
│          Name             │          Age          │          City                 │
├───────────────────────────┼───────────────────────┼───────────────────────────────┤
│          Alice            │          30           │          New York             │
├───────────────────────────┼───────────────────────┼───────────────────────────────┤
│          Bob              │          25           │          Los Angeles          │
├───────────────────────────┼───────────────────────┼───────────────────────────────┤
│          Charlie          │          47           │          Chicago              │
└───────────────────────────┴───────────────────────┴───────────────────────────────┘

Text Alignment Right

using ConsoleTable.Text;

var table = new Table { HeaderTextAlignmentRight = true, RowTextAlignmentRight = true };

table.SetHeaders("Name", "Age", "City");

table.AddRows(
    new string[] { "Alice Cooper", "30", "New York" },
    new string[] { "Bob", "25", "Los Angeles" },
    new string[] { "Charlie Brown", "47", "Chicago" }
);

Console.WriteLine(table.ToTable());

Output:

┌───────────────┬─────┬─────────────┐
│          Name │ Age │        City │
├───────────────┼─────┼─────────────┤
│  Alice Cooper │  30 │    New York │
├───────────────┼─────┼─────────────┤
│           Bob │  25 │ Los Angeles │
├───────────────┼─────┼─────────────┤
│ Charlie Brown │  47 │     Chicago │
└───────────────┴─────┴─────────────┘

Table with inconsistent columns across rows

using ConsoleTable.Text;

var table = new Table();

table.SetHeaders("Name", "Age", "City");

table.AddRow("Alice");
table.AddRow("Bob", "25", "Antwerp", "Belgium");
table.AddRow("Charlie", "47", "Chicago");
table.AddRow("Karina", "33", "Lima", "Peru", "South-America");
table.AddRow("Jenny", "43");
table.AddRow("John");
table.AddRow("Johny");
table.AddRow();
table.AddRow(null!);
table.AddRow("Thomas", "33", "Brussels", "Belgium", "Europe", "Earth", "Solar System");
table.AddRow("Nathalie", "29", "Paris", "France", "Europe", "Earth", "Solar System");
table.AddRow("Mathias", "37", "Oslo", "Norway", "Europe", "Earth", "Solar System");
table.AddRow("Kenny", "55", "Tokyo");

Console.WriteLine(table.ToTable());

Output:

┌──────────┬─────┬──────────┐
│ Name     │ Age │ City     │
├──────────┼─────┴──────────┘
│ Alice    │
├──────────┼─────┬──────────┬─────────┐
│ Bob      │ 25  │ Antwerp  │ Belgium │
├──────────┼─────┼──────────┼─────────┘
│ Charlie  │ 47  │ Chicago  │
├──────────┼─────┼──────────┼─────────┬───────────────┐
│ Karina   │ 33  │ Lima     │ Peru    │ South-America │
├──────────┼─────┼──────────┴─────────┴───────────────┘
│ Jenny    │ 43  │
├──────────┼─────┘
│ John     │
├──────────┤
│ Johny    │
├──────────┤
│          │
├──────────┤
│          │
├──────────┼─────┬──────────┬─────────┬───────────────┬───────┬──────────────┐
│ Thomas   │ 33  │ Brussels │ Belgium │ Europe        │ Earth │ Solar System │
├──────────┼─────┼──────────┼─────────┼───────────────┼───────┼──────────────┤
│ Nathalie │ 29  │ Paris    │ France  │ Europe        │ Earth │ Solar System │
├──────────┼─────┼──────────┼─────────┼───────────────┼───────┼──────────────┤
│ Mathias  │ 37  │ Oslo     │ Norway  │ Europe        │ Earth │ Solar System │
├──────────┼─────┼──────────┼─────────┴───────────────┴───────┴──────────────┘
│ Kenny    │ 55  │ Tokyo    │
└──────────┴─────┴──────────┘

Write a Table Fluent

using ConsoleTable.Text;

 var tableString = new Table()
    .SetHeaders("Name", "Age", "City")
    .AddRow("Alice Cooper", "30", "New York")
    .AddRows(
        new string[] { "Bob", "25", "Los Angeles" },
        new string[] { "Charlie Brown", "47", "Chicago" }
    )
    .ToTable();

Console.WriteLine(tableString);

Output:

┌───────────────┬─────┬─────────────┐
│ Name          │ Age │ City        │
├───────────────┼─────┼─────────────┤
│ Alice Cooper  │ 30  │ New York    │
├───────────────┼─────┼─────────────┤
│ Bob           │ 25  │ Los Angeles │
├───────────────┼─────┼─────────────┤
│ Charlie Brown │ 47  │ Chicago     │
└───────────────┴─────┴─────────────┘

License

This project is licensed under the MIT License - see the LICENSE file for details.