-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
b3dbf3f
commit 0eb7abc
Showing
2 changed files
with
69 additions
and
7 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,69 @@ | ||
# Vanessa | ||
|
||
Vanessa is a utility library for Rust programs. | ||
|
||
It provides an extremely easy logger and dead-simple threading. | ||
|
||
### Logging | ||
|
||
Logging is super simple, initialize it at the start of your program | ||
and you can use the various log level macros anywhere in your program! | ||
You can also create new loggers and log to them with the `s` macros | ||
(like `sinfo!` or `sdebug!`). Loggers have 7 levels here: | ||
|
||
- Hyper: Hyper is for really spammy debug messaging. The default logger | ||
and any logger from `Logger::quick` has the log level set too high | ||
for these. | ||
|
||
- Debug: Debug is for debug messaging (obviously). The default logger | ||
and any logger from `Logger::quick` will only show these when compiling | ||
in debug mode. | ||
|
||
- Info: Normal info messages. | ||
|
||
- Warn: Warnings. | ||
|
||
- Error: Errors. | ||
|
||
- Fatal: Critical errors, this is for full-program crashes or other | ||
similarly critical failures. | ||
|
||
- Input: This is a special log level used to get input from the user. | ||
Its macro returns an `Option<String>`. | ||
|
||
```rust | ||
use vanessa::{info,sinfo}; | ||
|
||
fn main() { | ||
// call this somewhere at the start of your program | ||
vanessa::log::init(); | ||
// or just call vanessa::full_init() to init everything! | ||
|
||
info!("Hello World!"); | ||
|
||
let logger2 = vanessa::log::Logger::quick("Another Logger"); | ||
sinfo!(logger2, "You can also log to specific loggers which can have their own log levels!"); | ||
} | ||
``` | ||
|
||
### Threading | ||
|
||
Concurrency is done via background workers. Call the init function | ||
at the start of your program and you can call the `bg` function from | ||
anywhere to run a closure in the background! | ||
|
||
```rust | ||
use vanessa::worker::bg; | ||
|
||
fn main() { | ||
// call this somewhere at the start of your program | ||
vanessa::worker::init(); | ||
// or just call vanessa::full_init() to init everything! | ||
// you can also call vanessa::worker::init_with(usize) | ||
// to initialize with a specified number of threads. | ||
|
||
bg(||{ | ||
// background tasks! | ||
}); | ||
} | ||
``` |