# Stybulate - Tabulate with Style!

A Rust library (and a CLI binary) to create ASCII tables with styled borders.
Inspired by the PyPi package <https://pypi.org/project/tabulate/>.

[![Build status](https://github.com/guigui64/stybulate/workflows/CI/badge.svg)](https://github.com/guigui64/stybulate/actions)
[![Crates.io](https://img.shields.io/badge/crates.io-stybulate-green)](https://crates.io/crates/stybulate)
[![Rust](https://img.shields.io/badge/rust-1.38.0%2B-blue.svg?maxAge=3600)](https://github.com/guigui64/stybulate)
[![Docs.rs](https://docs.rs/stybulate/badge.svg)](https://docs.rs/stybulate)
[![License](https://img.shields.io/crates/l/stybulate)](LICENSE-MIT)

## Binary

Install with `cargo install stybulate --features=cli`.

See `stybulate --help` for options and arguments.

## Library

### Example

```rust
use stybulate::{Table, Style, Cell, Headers};
let result = Table::new(
    Style::Fancy,
    vec![
        vec![Cell::from("answer"), Cell::Int(42)],
        vec![Cell::from("pi"), Cell::Float(3.1415)],
    ],
    Some(Headers::from(vec!["strings", "numbers"])),
).tabulate();
let expected = vec![
    "╒═══════════╤═══════════╕",
    "│ strings   │   numbers │",
    "╞═══════════╪═══════════╡",
    "│ answer    │   42      │",
    "├───────────┼───────────┤",
    "│ pi        │    3.1415 │",
    "╘═══════════╧═══════════╛",
].join("\n");
assert_eq!(expected, result);
```

See [examples](examples/) for more detailed examples.

### Change log

See [here](CHANGELOG.md)

### License

This project is licensed under either of

 * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or
   http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license ([LICENSE-MIT](LICENSE-MIT) or
   http://opensource.org/licenses/MIT)

at your option.