tiny-table 0.1.0

A simple and customizable table library for Rust.
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

# Tiny Table


Tiny Table is a simple and customizable table library for Rust.

## Installation


```bash
cargo add tiny-table
```

Or add it manually:

```toml
[dependencies]
tiny-table = "0.1.0"
```

To disable ANSI styling support:

```toml
[dependencies]
tiny-table = { version = "0.1.0", default-features = false }
```

## Examples


### Simple


```rust
use tiny_table::{Cell, Column, Table};

fn main() {
    let mut table = Table::with_columns(vec![
        Column::new("Name").width(15),
        Column::new("Role").width(20),
        Column::new("Status").width(10),
    ]);

    table.add_row(vec![
        Cell::new("Ada Lovelace"),
        Cell::new("Engineer"),
        Cell::new("Active"),
    ]);

    table.add_row(vec![
        Cell::new("Bob"),
        Cell::new("Support"),
        Cell::new("Away"),
    ]);

    println!("{}", table);
}
```

```
┌─────────────────┬──────────────────────┬────────────┐
│ Name            │ Role                 │ Status     │
├─────────────────┼──────────────────────┼────────────┤
│ Ada Lovelace    │ Engineer             │ Active     │
│ Bob             │ Support              │ Away       │
└─────────────────┴──────────────────────┴────────────┘
```

### Styled


```rust
use tiny_table::{Align, Cell, Column, SectionStyle, Table, Trunc};

fn main() {
    let mut table = Table::with_columns(vec![
        Column::new("Name").bright_cyan().bold().width(0.3),
        Column::new("Role").width(0.4).truncate(Trunc::Middle),
        Column::new("Status").bright_yellow().bold().width(0.3),
    ])
    .with_section_style(SectionStyle {
        horiz: "═",
        mid_left: "╞",
        mid_right: "╡",
        mid_joint: "╪",
    })
    .with_separator_style(SectionStyle {
        horiz: "╌",
        mid_joint: "│",
        ..SectionStyle::unicode()
    });

    table.add_section("Team").align(Align::Center);
    table.add_row(vec![
        Cell::new("Ada Lovelace"),
        Cell::new("Principal Engineer"),
        Cell::new("Active").bright_green(),
    ]);

    table.add_separator();
    table.add_row(vec![
        Cell::new("Bob"),
        Cell::new("Support"),
        Cell::new("Away"),
    ]);

    println!("{}", table);
}
```

```
┌────────────────┬────────────────────┬───────────────┐
│ Name           │ Role               │ Status        │
╞════════════════╪══════ Team ════════╪═══════════════╡
│ Ada Lovelace   │ Principal Engineer │ Active        │
├╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌│╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌│╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
│ Bob            │ Support            │ Away          │
└────────────────┴────────────────────┴───────────────┘
```

## Feature Flags


### Style


Adds ANSI styling functions.