[−][src]Crate tabular
Builds plain, automatically-aligned tables of monospaced text.
This is basically what you want if you are implementing ls
.
Example
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
Other features
-
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).
Usage
It's on crates.io, so you can add
[dependencies]
tabular = "0.1.3"
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.3", 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.18.0 and later.
See also
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.
Macros
row | A macro for building a |
table | A macro for building a |
Structs
Row | Type for building a |
Table | Builder type for constructing a formatted table. |
Enums
Error | Errors from parsing the table format string. |
Type Definitions
Result | Type alias specializing |