tabled 0.1.0

Tabled provides an interface to build tables from standard collections
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

[![Build Status](https://travis-ci.com/zhiburt/tabled.svg?branch=master)](https://travis-ci.org/https://github.com/zhiburt/tabled)
[![Coverage Status](https://coveralls.io/repos/github/zhiburt/tabled/badge.svg?branch=master)](https://coveralls.io/repos/github/zhiburt/tabled/badge.svg?branch=branch)
[![dependency status](https://deps.rs/repo/github/zhiburt/tabled/status.svg)](https://deps.rs/repo/github/zhiburt/tabled)

# tabled

This library provides an interface to pretty print vectors of structs

## Get started

The common and probably the best way to begin is to annotate your type with
`#[derive(Tabled)]`. You can also implement it on your own as well.

There's an example. Precisely it can be printed and you
will see the content of `expected` variable as an output.

```rust
use tabled::{Tabled, table};

#[derive(Tabled)]
struct Language {
    name: String,
    designed_by: String,
    invented_year: usize,
}

let languages = vec![
    Language{
        name: "C".to_owned(),
        designed_by: "Dennis Ritchie".to_owned(),
        invented_year: 1972
    },
    Language{
        name: "Rust".to_owned(),
        designed_by: "Graydon Hoare".to_owned(),
        invented_year: 2010},
];

let table = table(&languages);
let expected = "+------+----------------+---------------+\n\
                | name |  designed_by   | invented_year |\n\
                +------+----------------+---------------+\n\
                |  C   | Dennis Ritchie |     1972      |\n\
                +------+----------------+---------------+\n\
                | Rust | Graydon Hoare  |     2010      |\n\
                +------+----------------+---------------+\n";

assert_eq!(expected, table);
```

It should have a clue in what why print the field
accordingly each field should implement `std::fmt::Display`
The example below is not compiled

```rust,compile_fail
# use tabled::Tabled;
#[derive(Tabled)]
struct SomeType {
    field1: SomeOtherType,
}

struct SomeOtherType;
```
This crate implement the trait for default types.
Therefore you can use this to print one column vectors

```rust
use tabled::{Tabled, table};

let some_numbers = [1, 2, 3];
let table = table(&some_numbers);
```

License: Apache-2.0