# colonnade
tabular text
Colonnade lets As you can see, it supports text It doesn't yet
you format text alignment, viewport width, and support color
in columns. column widths. codes or other
formatting,
though that may
come.
Two or more rows of columns makes
a table.
## USAGE
```rust
extern crate colonnade;
use colonnade::{Alignment, Colonnade};
#[allow(unused_must_use)]
fn main() {
// text to put in tabular form
let text = vec![
vec![
"Colonnade lets you format text in columns.",
"As you can see, it supports text alignment, viewport width, and column widths.",
"It doesn't yet support color codes or other formatting, though that may come.",
],
vec!["", "Two or more rows of columns makes a table.", ""],
];
let mut colonnade = Colonnade::new(3, 80).unwrap(); // 3 columns of text in an 80-character viewport
// configure the table a bit
colonnade.left_margin_all(4);
colonnade.left_margin(0, 8); // the first column should have a left margin 8 spaces wide
colonnade.fixed_width_all(15);
colonnade.clear_limits(1); // the central column has no fixed size limits
colonnade.alignment(0, Alignment::Right);
colonnade.alignment(1, Alignment::Center);
colonnade.alignment(2, Alignment::Left);
colonnade.spaces_between_rows(1); // add a blank link between rows
// now print out the table
for line in colonnade.tabulate(&text).unwrap() {
println!("{}", line);
}
}
```