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

#136 in Value formatting

Download history 751/week @ 2024-07-19 560/week @ 2024-07-26 337/week @ 2024-08-02 443/week @ 2024-08-09 5536/week @ 2024-08-16 2045/week @ 2024-08-23 1525/week @ 2024-08-30 708/week @ 2024-09-06 908/week @ 2024-09-13 881/week @ 2024-09-20 1882/week @ 2024-09-27 699/week @ 2024-10-04 1372/week @ 2024-10-11 710/week @ 2024-10-18 1170/week @ 2024-10-25 543/week @ 2024-11-01

3,910 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.7–11MB
~66K SLoC