ascii_table 5.0.0

Print ASCII tables to the terminal
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

# ascii_table

Print ASCII tables to the terminal.

## Example

```
use ::ascii_table::AsciiTable;

let ascii_table = AsciiTable::new();
let data = &[&["1", "2", "3"], &["4", "5", "6"], &["7", "8", "9"]];
ascii_table.println(data);
// ┌───┬───┬───┐
// │ 1 │ 2 │ 3 │
// │ 4 │ 5 │ 6 │
// │ 7 │ 8 │ 9 │
// └───┴───┴───┘
```

## Example

```
use ::ascii_table::{Align, AsciiTable, Width};

let mut ascii_table = AsciiTable::new();
ascii_table.set_max_width(Width::Fixed(26));
ascii_table
    .column(0)
    .set_header("H1")
    .set_align(Align::Left);
ascii_table
    .column(1)
    .set_header("H2")
    .set_align(Align::Center);
ascii_table
    .column(2)
    .set_header("H3")
    .set_align(Align::Right);

let data: &[&[&str]] = &[&["v", "v", "v"], &["123", "456", "789", "abcdef"]];
ascii_table.println(data);
// ┌─────┬─────┬─────┬──────┐
// │ H1  │ H2  │ H3  │      │
// ├─────┼─────┼─────┼──────┤
// │ v   │  v  │   v │      │
// │ 123 │ 456 │ 789 │ abc+ │
// └─────┴─────┴─────┴──────┘
```

## Features

- `auto_table_width`: Sets the default max width of the Ascii Table to the width of the terminal.
- `color_codes`: Correctly calculates the width of a string when terminal color codes are present
  (like those from the `colorful` crate).
- `wide_characters`: Correctly calculates the width of a string when wide characters are present
  (like emoji's).

## Changelog

### v5.0.0 (2025-11-30)

- Complete rewrite. All the features are still the same except Ascii Table no longer accepts 2D arrays
  of `Display`. You will have to stringify your data before you give it to Ascii Table.

### v4.0.8 (2025-10-12)

- Replaced the crate `termsize` with `termize` to fix a edge-case where it was unable to get the terminal
  width on some SSH sessions. This will only affect the `auto_table_width` feature.

### v4.0.7 (2025-05-14)

- Replaced the crate `lazy_static` with `std::sync::LazyLock`. This change is only for the `color_codes`
  feature.

### v4.0.6 (2025-02-25)

- Bumped Rust edition to 2024.
- Replaced `termion` with the more lightweight `termsize`. This will only affect the `auto_table_width`
  feature.

### v4.0.5 (2024-11-20)

- Bumped crate unicode-width from 0.1 to 0.2.

### v4.0.4 (2024-08-28)

- Bumped versions on 3rd party crates.

### v4.0.3 (2023-08-28)

- Added documentation to explain Ascii Table's features.
- Some minor refactoring.

### v4.0.2 (2022-01-25)

- Created a new feature `auto_table_width`. It will set the default max width of your ascii table to
  the width of your terminal. Note that `AsciiTable::set_max_width` will override this value.
- Changed ascii table default max width from 80 to 100.

### v4.0.1 (2022-01-24)

- Moved color code parsing to its own feature `color_codes`. Enable this feature when you want to display
  colors in the terminal using the `colorful` crate.
- Created a new feature `wide_characters` who will use unicode rules to determine the width of strings.
  Use this feature when you want to display emoji's or other wide characters.

### v4.0.0 (2022-01-23)

- Revamped API.