tabled

An easy to use library for pretty printing tables of Rust structs and enums.

There are more examples and you can find in this README.

Usage

To print a list of structs or enums as a table your types should implement the the Tabled trait or derive it with a #[derive(Tabled)] macro. Most of the default types implement the trait out of the box.

Most of a table configuration can be found in tabled::settings module.

```rust use tabled::{Table, Tabled};

[derive(Tabled)]

struct Language { name: String, designedby: String, inventedyear: usize, }

impl Language { fn new(name: &str, designedby: &str, inventedyear: usize) -> Self { Self { name: name.tostring(), designedby: designedby.tostring(), invented_year, } } }

let languages = vec![ Language::new("C", "Dennis Ritchie", 1972), Language::new("Go", "Rob Pike", 2009), Language::new("Rust", "Graydon Hoare", 2010), Language::new("Hare", "Drew DeVault", 2022), ];

let table = Table::new(languages).to_string();

asserteq!( table, "+------+----------------+---------------+\n\ | name | designedby | invented_year |\n\ +------+----------------+---------------+\n\ | C | Dennis Ritchie | 1972 |\n\ +------+----------------+---------------+\n\ | Go | Rob Pike | 2009 |\n\ +------+----------------+---------------+\n\ | Rust | Graydon Hoare | 2010 |\n\ +------+----------------+---------------+\n\ | Hare | Drew DeVault | 2022 |\n\ +------+----------------+---------------+" ); ```

The same example but we are building a table step by step.

```rust use tabled::{builder::Builder, settings::Style};

let mut builder = Builder::new(); builder.pushrecord(["C", "Dennis Ritchie", "1972"]); builder.pushrecord(["Go", "Rob Pike", "2009"]); builder.pushrecord(["Rust", "Graydon Hoare", "2010"]); builder.pushrecord(["Hare", "Drew DeVault", "2022"]);

let table = builder.build() .with(Style::asciirounded()) .tostring();

assert_eq!( table, concat!( ".------------------------------.\n", "| C | Dennis Ritchie | 1972 |\n", "| Go | Rob Pike | 2009 |\n", "| Rust | Graydon Hoare | 2010 |\n", "| Hare | Drew DeVault | 2022 |\n", "'------------------------------'" ) ); ```