comfy-table

You can enhance tables by applying presets (like UTF8_FULL), modifiers (like UTF8_ROUND_CORNERS), and setting content arrangement to ContentArrangement::Dynamic for automatic wrapping.

To control alignment:

• Use Cell::new("...").set_alignment(CellAlignment::...) for individual cells.
• Use table.column_mut(index).set_cell_alignment(CellAlignment::...) to set a default alignment for an entire column.

use comfy_table::modifiers::UTF8_ROUND_CORNERS;
use comfy_table::presets::UTF8_FULL;
use comfy_table::*;

fn main() {
    let mut table = Table::new();
    table
        .load_preset(UTF8_FULL)
        .apply_modifier(UTF8_ROUND_CORNERS)
        .set_content_arrangement(ContentArrangement::Dynamic)
        .set_width(40)
        .set_header(vec!["Header1", "Header2", "Header3"])
        .add_row(vec![
            Cell::new("Center aligned").set_alignment(CellAlignment::Center),
            Cell::new("This is another text"),
            Cell::new("This is the third text"),
        ])
        .add_row(vec![
            "This is another text",
            "Now\nadd some\nmulti line stuff",
            "This is awesome",
        ]);

    // Set the default alignment for the third column to right
    let column = table.column_mut(2).expect("Our table has three columns");
    column.set_cell_alignment(CellAlignment::Right);

    println!("{table}");
}

Cells can be styled using colors (fg for foreground, bg for background) and attributes (add_attribute or add_attributes).

Common styling methods:

• .fg(Color::...): Set foreground color.
• .bg(Color::...): Set background color.
• .add_attribute(Attribute::...): Add a single attribute like Attribute::Bold or Attribute::SlowBlink.
• .add_attributes(vec![...]): Add multiple attributes at once.

use comfy_table::presets::UTF8_FULL;
use comfy_table::*;

fn main() {
    let mut table = Table::new();
    table.load_preset(UTF8_FULL)
        .set_content_arrangement(ContentArrangement::Dynamic)
        .set_width(80)
        .set_header(vec![
            Cell::new("Header1").add_attribute(Attribute::Bold),
            Cell::new("Header2").fg(Color::Green),
            Cell::new("Header3"),
        ])
        .add_row(vec![
             Cell::new("This is a bold text").add_attribute(Attribute::Bold),
             Cell::new("This is a green text").fg(Color::Green),
             Cell::new("This one has black background").bg(Color::Black),
        ])
        .add_row(vec![
            Cell::new("Blinky boi").add_attribute(Attribute::SlowBlink),
            Cell::new("This table's content is dynamically arranged. The table is exactly 80 characters wide.\nHere comes a reallylongwordthatshoulddynamicallywrap"),
            Cell::new("COMBINE ALL THE THINGS")
                .fg(Color::Green)
                .bg(Color::Black)
                .add_attributes(vec![
                    Attribute::Bold,
                    Attribute::SlowBlink,
                ])
        ]);

    println!("{table}");
}

To create a table, instantiate Table::new() and use a builder pattern to configure its appearance and content.

Key capabilities demonstrated in this pattern include:

• Presets: Apply predefined styles like UTF8_FULL using .load_preset().
• Layout: Control how content is wrapped and arranged using .set_content_arrangement(ContentArrangement::Dynamic) and set a fixed width with .set_width(n).
• Headers: Define a header row using .set_header(vec![...]).
• Rows: Add data rows using .add_row(vec![...]).
• Cell Styling: Individual cells are created with Cell::new("text"). You can apply styles directly to cells using:
  • .add_attribute(Attribute::...) for text effects (e.g., Attribute::Bold, Attribute::SlowBlink).
  • .fg(Color::...) to set foreground color.
  • .bg(Color::...) to set background color.
  • .add_attributes(vec![...]) to apply multiple attributes at once.

Finally, the table can be printed using the Display implementation via println!("{table}").

use comfy_table::{presets::UTF8_FULL, *};

fn main() {
    let mut table = Table::new();
    table.load_preset(UTF8_FULL)
        .set_content_arrangement(ContentArrangement::Dynamic)
        .set_width(80)
        .set_header(vec![
            Cell::new("Header1").add_attribute(Attribute::Bold),
            Cell::new("Header2").fg(Color::Green),
            Cell::new("Header3"),
        ])
        .add_row(vec![
            Cell::new("This is a bold text").add_attribute(Attribute::Bold),
            Cell::new("This is a green text").fg(Color::Green),
            Cell::new("This one has black background").bg(Color::Black),
        ])
        .add_row(vec![
            Cell::new("Blinky boi").add_attribute(Attribute::SlowBlink),
            Cell::new("This table's content is dynamically arranged. The table is exactly 80 characters wide.\nHere comes a reallylongwordthatshoulddynamicallywrap"),
            Cell::new("COMBINE ALL THE THINGS")
            .fg(Color::Green)
            .bg(Color::Black)
            .add_attributes(vec![
                Attribute::Bold,
                Attribute::SlowBlink,
            ])
        ]);

println!("{table}");
}

You can create a Table and configure its layout using set_content_arrangement, set_width, and load_preset. Using ContentArrangement::Dynamic allows the table to wrap text and adjust cell content to fit within the specified width. This example demonstrates a table that functions even when the tty feature is disabled, meaning it will not attempt to use terminal-specific styling like colors or bold text.

To run this specific example without default features, use:

cargo run --example no_tty -- --no-default-features

use comfy_table::{presets::UTF8_FULL, *};

fn main() {
    let mut table = Table::new();
    table.load_preset(UTF8_FULL)
        .set_content_arrangement(ContentArrangement::Dynamic)
        .set_width(80)
        .set_header(vec![
            Cell::new("Header1"),
            Cell::new("Header2"),
            Cell::new("Header3"),
        ])
        .add_row(vec![
            Cell::new("No bold text without tty"),
            Cell::new("No colored text without tty"),
            Cell::new("No custom background without tty"),
        ])
        .add_row(vec![
            Cell::new("Blinky boi"),
            Cell::new("This table's content is dynamically arranged. The table is exactly 80 characters wide.\nHere comes a reallylongwordthatshoulddynamicallywrap"),
            Cell::new("Done"),
        ]);

println!("{table}");
}