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 for more detailed information
• 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.

• debug! macro

toml [dependencies] cli-toolbox = { version = "0.6", features = ["debug"] }

• eval! macro

toml [dependencies] cli-toolbox = { version = "0.6", features = ["eval"] } verbosity = "0.1"

• release! macro

toml [dependencies] cli-toolbox = { version = "0.6", features = ["release"] } verbosity = "0.1"

• report! macro

toml [dependencies] cli-toolbox = { version = "0.6", features = ["report"] } verbosity = "0.1"

Roadmap

• [ ] ...

Implemented

• [x] debug! macro
• [x] eval! macro
• [x] release! macro
• [x] report! macro