9 releases (5 breaking)

0.6.1 Jul 1, 2023
0.6.0 Jun 27, 2023
0.5.1 Jun 10, 2023
0.4.0 Jun 3, 2023
0.1.0 May 13, 2023

#80 in Value formatting

Download history 148/week @ 2024-02-12 173/week @ 2024-02-19 95/week @ 2024-02-26 1104/week @ 2024-03-04 313/week @ 2024-03-11 386/week @ 2024-03-18 970/week @ 2024-03-25 249/week @ 2024-04-01 388/week @ 2024-04-08 122/week @ 2024-04-15 221/week @ 2024-04-22 1490/week @ 2024-04-29 1282/week @ 2024-05-06 1227/week @ 2024-05-13 213/week @ 2024-05-20 226/week @ 2024-05-27

2,972 downloads per month

MIT/Apache

42KB
765 lines

Table Formatter

Repo   Crates-io Version   Language Count   License
Build Status   Commit Activity   Recent Downloads

This lib is used to format plain-text table.

Example

Code:

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 or Apache-2.0

Dependencies

~0.8–11MB
~83K SLoC