Builds plain, automatically-aligned tables of monospaced text.
This is basically what you want if you are implementing ls
.
use tabular::{Table, Row};
use std::path::Path;
fn ls(dir: &Path) -> ::std::io::Result<()> {
let mut table = Table::new("{:>} {:<}{:<} {:<}");
for entry_result in ::std::fs::read_dir(dir)? {
let entry = entry_result?;
let metadata = entry.metadata()?;
table.add_row(Row::new()
.with_cell(metadata.len())
.with_cell(if metadata.permissions().readonly() {"r"} else {""})
.with_cell(if metadata.is_dir() {"d"} else {""})
.with_cell(entry.path().display()));
}
print!("{}", table);
Ok(())
}
ls(Path::new(&"target")).unwrap();
produces something like
1198 target/.rustc_info.json
1120 d target/doc
192 d target/package
1056 d target/debug
-
The
Table::with_header()
andTable::add_header()
methods add lines that span all columns. -
The
row!
macro builds a row with a fixed number of columns using less syntax. -
The
Table::set_line_end()
method allows changing the line ending to include a carriage return (or whatever you want).
It's on crates.io, so you can add
[dependencies]
tabular = "0.1.4"
to your Cargo.toml
.
Feature unicode-width
is enabled be default; it depends on the
unicode-width crate. You can turn
it off with:
[dependencies]
tabular = { version = "0.1.4", default-features = false }
Note that without unicode-width
, alignment will be based on the count of the
std::str::Chars
iterator.
This crate supports Rust version 1.31.0 and later.
You may also want:
-
text-tables – This is more automatic than tabular. You give it an array of arrays, it renders a nice table with borders. Tabular doesn't do borders.
-
prettytable — This has an API more similar to tabular’s in terms of building a table, but it does a lot more, including, color, borders, and CSV import.