table_formatter 0.6.0

A simple text table formatter written in 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

# Tabel Formatter


This lib is used to format plain-text table.

## Example


Code:

```rust
use itertools::Itertools;
use table_formatter::{cell, table};
use table_formatter::table::{Align, Border};
let table_header = vec![
    cell!("Cell Row").with_width(Some(20)),
    cell!("Left", align = Align::Left).with_width(Some(10)),
    cell!("Center", align = Align::Center).with_width(Some(10)),
    cell!("Right", align = Align::Right).with_width(Some(10)),
];
let table_cells = {
    let mut v = (0..=3_u8)
        .map(|_| {
            vec![
                cell!("Cell Row"),
                cell!("Left", align = Align::Left),
                cell!("Center", align = Align::Center),
                cell!("Right", align = Align::Right),
            ]
        })
        .collect_vec();
    v.push(cell!("Cross Cell!", align = Align::Center).with_span(3));
    v
};
let table = table! {
    table_header
    ---
    table_cells
    with Border::ALL
};
let mut buffer = vec![];
table.render(&mut buffer).unwrap();
println!("{}", String::from_utf8(buffer).unwrap());
```

Output:

```
────────────────────────────────────────────────────────────
| Cell Row              Left          Center         Right |
|──────────────────────────────────────────────────────────|
| Cell Row              Left          Center         Right |
| Cell Row              Left          Center         Right |
| Cell Row              Left          Center         Right |
| Cell Row              Left          Center         Right |
|                       Cross Cell!                        |
────────────────────────────────────────────────────────────
```

> Actually the border of the table is bold, but it cannot be rendered in markdown.

## Future Plan


Waiting for report :)

## Change Log


### V0.6.0


- Changed the api of formatter, and add a macro wrapper for them.
- Added documentations.

> If you are using the formatter, you just need to change your `vec!`s into `fmt!`s.

### V0.5.1


This version is yanked.

### V0.5.0


#### New features


- Add render target: Markdown.
- Add cross-cell support.
- Add macro support.

#### Warning


This version is ***Completely Incompatible*** with previous versions.

## License


[MIT][MIT-License] or [Apache-2.0][Apache-License]

[MIT-License]: LICENSE-MIT
[Apache-License]: LICENSE-APACHE