tabled 0.20.0

An easy to use library for pretty print tables of Rust `struct`s and `enum`s.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! This example demonstrates using the [attribute macro](https://doc.rust-lang.org/reference/procedural-macros.html#attribute-macros)
//! [`display_with`] to seamlessly augment field representations in a [`Table`] display.
//!
//! * [`display_with`] functions act as transformers during [`Table`] instantiation.
//!
//! * Note how [`display_with`] works with [std] and custom functions alike.
//!
//! * [`display_with`] attributes can be constructed in two ways (shown below).
//!
//! * Attribute arguments can be directly overridden with static values, effectively ignoring the
//!   augmented fields natural value entirely. Even an entire object can be passed as context with `self`.

use tabled::{Table, Tabled};

#[derive(Tabled)]
struct Country {
    name: String,
    #[tabled(display = "str::to_uppercase")]
    capital: String,
    #[tabled(display("perimeter", self, false))]
    area_km2: f32,
    #[tabled(display("tabled::derive::display::option", "unknown"))]
    currency: Option<String>,
}

fn perimeter(area: &f32, country: &Country, _milies: bool) -> String {
    let is_big = *area > 1_000_000.0f32;
    let big_sign = if is_big { "B" } else { "" };
    format!("{} {}", country.area_km2, big_sign)
}

fn main() {
    let data = [
        Country {
            name: String::from("Afghanistan"),
            capital: String::from("Kabul"),
            area_km2: 652867.0,
            currency: Some(String::from("Afghan afghani (AFN)")),
        },
        Country {
            name: String::from("Angola"),
            capital: String::from("Luanda"),
            area_km2: 1246700.0,
            currency: None,
        },
        Country {
            name: String::from("Canada"),
            capital: String::from("Ottawa"),
            area_km2: 9984670.0,
            currency: None,
        },
    ];

    let table = Table::new(data);

    println!("{table}");
}