Tables

Automated table rendering with Unicode support and custom styling

Overview

Create beautiful ASCII/Unicode tables for terminal output

The table module provides:

Automatic column width calculation
Unicode box-drawing characters
Header and data row support
Custom alignment and padding
Colored cells and borders

Basic Table

Create a simple table with headers and rows

Basic Table Example

use zfish::table::Table;

// Create table with headers
let mut table = Table::new(vec!["Name", "Age", "City"]);

// Add data rows
table.add_row(vec!["Alice", "25", "New York"]);
table.add_row(vec!["Bob", "30", "London"]);
table.add_row(vec!["Charlie", "28", "Tokyo"]);

// Print the table
table.print();

Output

┌─────────┬─────┬──────────┐
│ Name    │ Age │ City     │
├─────────┼─────┼──────────┤
│ Alice   │ 25  │ New York │
│ Bob     │ 30  │ London   │
│ Charlie │ 28  │ Tokyo    │
└─────────┴─────┴──────────┘

Styled Table

Customize table appearance with colors and styles

Styled Table Example

use zfish::table::Table;
use zfish::style::Color;

// Create table with headers
let mut table = Table::new(vec!["Product", "Price", "Stock"]);
table.set_box_style(BoxStyle::Double);

// Add colored rows
table.add_row(&["Laptop", "$999", "In Stock"]);
table.add_row(&["Mouse", "$25", "Low Stock"]);
table.add_row(&["Keyboard", "$75", "Out of Stock"]);

// Set border color
table.set_border_color(Color::Blue);

table.print();

Output

┌──────────┬───────┬──────────────┐
│ Product  │ Price │ Stock        │
├──────────┼───────┼──────────────┤
│ Laptop   │ $999  │ In Stock     │
│ Mouse    │ $25   │ Low Stock    │
│ Keyboard │ $75   │ Out of Stock │
└──────────┴───────┴──────────────┘

Column Alignment

Align columns left, center, or right

Column Alignment Example

use zfish::table::{Table, Alignment};

// Create table with headers
let mut table = Table::new(vec!["Item", "Quantity", "Price"]);

// Set column alignments
table.set_column_alignment(0, Alignment::Left);
table.set_column_alignment(1, Alignment::Center);
table.set_column_alignment(2, Alignment::Right);

// Add rows
table.add_row(vec!["Apple", "10", "$1.50"]);
table.add_row(vec!["Banana", "5", "$0.80"]);
table.add_row(vec!["Orange", "8", "$1.20"]);

table.print();

Output

┌────────┬──────────┬───────┐
│ Item   │ Quantity │ Price │
├────────┼──────────┼───────┤
│ Apple  │    10    │ $1.50 │
│ Banana │     5    │ $0.80 │
│ Orange │     8    │ $1.20 │
└────────┴──────────┴───────┘

Custom Box Style

Use different box-drawing character sets

ASCII Box Style

use zfish::table::{Table, BoxStyle};

// Create table with headers
let mut table = Table::new(vec!["Header 1", "Header 2", "Header 3"]);

// Use ASCII style instead of Unicode
table.set_box_style(BoxStyle::Ascii);

table.add_row(vec!["Data 1", "Data 2", "Data 3"]);

table.print();

Output

+----------+----------+----------+
| Header 1 | Header 2 | Header 3 |
+----------+----------+----------+
| Data 1   | Data 2   | Data 3   |
+----------+----------+----------+

Unicode Support

Proper handling of Unicode characters and emoji

Unicode Support Example

use zfish::table::Table;

// Create table with headers
let mut table = Table::new(vec!["Emoji", "Name", "Category"]);

table.add_row(vec!["🚀", "Rocket", "Transport"]);
table.add_row(vec!["🎨", "Palette", "Art"]);
table.add_row(vec!["🐟", "Fish", "Animal"]);
table.add_row(vec!["你好", "Hello (Chinese)", "Language"]);

table.print();

Output

┌───────┬──────────────────┬───────────┐
│ Emoji │ Name             │ Category  │
├───────┼──────────────────┼───────────┤
│ 🚀    │ Rocket           │ Transport │
│ 🎨    │ Palette          │ Art       │
│ 🐟    │ Fish             │ Animal    │
│ 你好  │ Hello (Chinese)  │ Language  │
└───────┴──────────────────┴───────────┘

Manual Box Drawing

Draw custom boxes and borders

Manual Box Drawing

use zfish::table::draw_box;
use zfish::style::Color;

// Draw a colored box
draw_box(
    "Hello, ZFish!",
    Color::Green,
    Some(60),
    true
);

// Draw a simple box
draw_box(
    "Simple message",
    Color::Blue,
    None,
    false
);

Output

┌────────────────────────────────────────────────────────────┐
│                      Hello, ZFish!                         │
└────────────────────────────────────────────────────────────┘

┌──────────────────┐
│ Simple message   │
└──────────────────┘

API Reference

Available methods and options

Table Methods

new()Create a new table

add_row(&[&str])Add a row to the table

set_header_style(color)Style the header row

set_column_alignment(col, align)Set column alignment

set_border_color(color)Set border color

set_box_style(style)Set box-drawing style

print()Print the table

Box Styles

UnicodeAsciiRoundedDoubleBold