7 stable releases
new 1.5.0 | Nov 23, 2024 |
---|---|
1.4.1 | Nov 11, 2024 |
0.1.0 |
|
#425 in Command-line interface
3,979 downloads per month
29KB
550 lines
forestry
A simple, efficient, concise, and elegant logging library for Rust.
Table of Contents
Installation
To install forestry, simply add it to your Rust project via Cargo:
cargo add forestry
Dependencies
Forestry depends on the colored
crate for colorized output.
Usage
Forestry is a simple logging library that allows you to log messages to the console with different levels of severity. Here's an example of how to use it:
use forestry::prelude::*;
let log = Logger::new();
log.info("This is an info message.");
log.warn("This is a warning message.");
log.error("This is an error message.");
log.success("This is a success message.");
log.critical("This is a critical message.");
These calls can also be inlined as follows
use forestry::prelude::*
let log = Logger::new();
log.info("This is an info message.")
.warn("This is a warning message.")
.error("This is an error message.")
.success("This is a success message.")
.critical("This is a critical message.");
This will output the following to the console:
[0000:*] This is an info message.
[0001:~] This is a warning message.
[0002:!] This is an error message.
[0003:+] This is a success message.
[0004:%] This is a critical message.
It will also be coloured in most terminals.
All formatting is optional; please see the documentation at Docs.rs, specifically for crate::logs::Options
. Optional file output and timer inclusion is also supported via the same crate::logs::Options
enum.
Async
Forestry also supports asynchronous logging. To enable this feature, simply add the async
feature to forestry
's declaration in your Cargo.toml
file.
Example
[dependencies]
forestry = { version = ">=1.5", features = ["async"] }
Then, the logger's internal print calls will be asynchronous futures. This is useful for logging in async functions or in async contexts. await
ing the logger's methods will return the same &mut Logger
as before, so chaining is still possible (although only by adding await
to every call).
Contributing
If you would like to contribute to forestry, please open an issue or submit a pull request.
License
This code is dual-licensed under either the MIT or Apache 2.0 license, at your option. Please see the LICENSE
file for more information.
Dependencies
~0–9.5MB
~41K SLoC