tree_decorator 0.1.2

An utility lib to render pleasing tree structures at terminal programs.
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
75
76
77
78
79
80
81
82
83
84
85
86
87

# Tree Decorator

An utility rust lib to render pleasing tree structures at terminal programs.

[![Latest Version](https://img.shields.io/crates/v/tree_decorator)](https://crates.io/crates/tree_decorator)

It's goal is to simplify tree structure display while ensuring a good looking to it. 
So it just handle strings, returning the expected result (with current level and supplied styles) and nothing more.

Already comes with a standard visual implementation, so is ready to use, but a custom implementation is very easy to set.

## Dependencies

As little as possible.

* [log](https://crates.io/crates/log): to simplify macro calls.

## Usage

Please, check [Documentation](https://docs.rs/tree_decorator) to see a detailed explanation.

## Examples

### Simple

```rust
use tree_decorator::tree_item;

tree_item!(block, "Items");
tree_item!("A");
tree_item!(block, "B");
tree_item!(last, "B.1");
tree_item!("C");
tree_item!(last, "D");
```

```
Items
├  A
├  B
│  └  B.1
├  C
└  D
```

### More Complex

```rust
use tree_decorator::tree_item;

tree_item!(block, "Items");
tree_item!("A");
tree_item!(block, "B");
tree_item!(block, "B.1");
tree_item!(last, "B.1.a");
tree_item!(block, "B.2");
tree_item!("B.2.a");
tree_item!(last, "B.2.b");
tree_item!(last, "B.3");
tree_item!("C");
tree_item!(last; block, "D");
tree_item!("D.1");
tree_item!("D.2");
tree_item!(last, "D.3");
close_tree_item!();
```

```rust
Items
├  A
├  B
│  ├  B.1
│  │  └  B.1.a
│  ├  B.2
│  │  ├  B.2.a
│  │  └  B.2.b
│  └  B.3
├  C
└  D
   ├  D.1
   ├  D.2
   └  D.3
```

## License

Everything is licensed under [MIT License](/LICENSE).