#table #print #terminal #format #pretty-table #macro-derive #pretty-print

no-std tabled

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

32 releases

0.16.0 Aug 5, 2024
0.15.0 Dec 20, 2023
0.14.0 Aug 4, 2023
0.13.0 Jul 24, 2023
0.1.0 Mar 23, 2020

#1 in Visualization

Download history 70290/week @ 2024-07-18 69715/week @ 2024-07-25 70935/week @ 2024-08-01 77679/week @ 2024-08-08 74387/week @ 2024-08-15 87563/week @ 2024-08-22 83822/week @ 2024-08-29 92077/week @ 2024-09-05 76974/week @ 2024-09-12 88152/week @ 2024-09-19 114769/week @ 2024-09-26 93493/week @ 2024-10-03 101403/week @ 2024-10-10 110276/week @ 2024-10-17 97576/week @ 2024-10-24 78826/week @ 2024-10-31

404,854 downloads per month
Used in 356 crates (272 directly)

MIT license

1MB
23K SLoC

github crates.io docs.rs build status coverage dependency status

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.

use tabled::{Table, Tabled};

#[derive(Tabled)]
struct Language {
    name: String,
    designed_by: String,
    invented_year: usize,
}

impl Language {
    fn new(name: &str, designed_by: &str, invented_year: usize) -> Self {
        Self {
            name: name.to_string(),
            designed_by: designed_by.to_string(),
            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();

assert_eq!(
    table,
    "+------+----------------+---------------+\n\
     | name | designed_by    | 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.

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

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

let table = builder.build()
    .with(Style::ascii_rounded())
    .to_string();

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",
        "'------------------------------'"
    )
);

Dependencies

~2MB
~34K SLoC