# Lisa #
A CLI interface, and logging tool for Rem-Verse.
[](https://crates.io/crates/rm-lisa)
[][documentation]
[](LICENSE)
[](https://crates.io/crates/rm-lisa)

## Key features ##
- Multiple Logging Formats, that are built for many individuals.
- Colored for pretty ascii color & erasing interfaces.
- Plaintext for a simple line based format ideal for braille displays, and
local human log files.
- JSON for structured logging, with quick parsing/slicing/dicing support.
- Task Status, and Logging.
- Queue up many background tasks, and have log lines prefixed with task
names, and status updates.
- T4T (terminal for terminal), have your own autocomplete-ing command inputs
with full support for a wide variety of stty keybinds (that are re-bindable).
- Full customization at runtime of data to include by users.
## What is Lisa? ##
Lisa aims to be the de-factor logging library across all of Rem-Verse. It's
built for our needs first, and foremost. If you have a lot of similar opinions
to logging as us this will probably be a good fit.
If you have different opinions it may not be _yet_, but we'd be open to hearing
all feature requests! If there's something we can do to make lisa more useful,
we'd like to take that on!
## Installation ##
Install via Cargo by adding to your `Cargo.toml` file:
```toml
[dependencies]
rm-lisa = "^0.4.0"
```
You must also set `tracing-unstable`, and `tokio-unstable` enabled through
rustflags. The easiest way to do this is create a `.cargo/config.toml` file
in the root of your workspace:
```toml
[build]
rustflags = ["--cfg", "tokio_unstable", "--cfg", "tracing_unstable"]
```
This project's source code and documentation are licensed under the MIT license. See the [LICENSE](LICENSE) file for details.
[documentation]: https://docs.rs/rm-lisa