cli-toolbox 0.5.2

Utility library for working with cli output ergonomically
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

# cli-toolbox

Utility library for working with ```cli``` output ergonomically.

This is not a logging alternative, it's intended to produce output for end user consumption.

It handles three levels of verbosity that can be set dynamically at runtime:

* Quite - no output
* Terse - used to provide minimal user output
* Verbose - used to provide elaborated and/or additional user output 

### Output Macros


* `debug!` - conditionally compiled console debugging output - [`debug`]

* `report!` - conditional console output according to verbosity level - [`debug`|`release`]

\* _debug! is intended to be used during application development_

\* _all other debugging and telemetry output is most likely better served with a logging library_

### Conditional Code


* `eval!` - conditional code execution according to verbosity level - [`debug`|`release`]

* `release!` - conditional code execution according to verbosity level - [`release`]

## Resources 

* [Docs](https://docs.rs/cli-toolbox/0.5.2/cli_toolbox/) for more detailed information
* [Examples](https://github.com/Nejat/cli-toolbox-rs/tree/v0.5.2/examples) to see it in action

## Usage


Each macro is gated by a feature.

No feature is mutually exclusive and can be combined as needed.

```toml
[dependencies]
cli-toolbox = { version = "0.5", features = ["debug", "eval", "release", "report"] }
```

## Roadmap


* [ ] ...

## Implemented

* [x] ```debug!``` macro
* [x] ```Verbosity``` reporting level functionality
* [x] ```report!``` macro
* [x] functionality separated by features
* [x] ```release!``` macro
* [x] ```eval!``` macro