Skip to content

Commit

Permalink
docs: update the readme slightly
Browse files Browse the repository at this point in the history
  • Loading branch information
madelynwith5ns committed May 20, 2024
1 parent b3dbf3f commit 0eb7abc
Show file tree
Hide file tree
Showing 2 changed files with 69 additions and 7 deletions.
7 changes: 0 additions & 7 deletions README

This file was deleted.

69 changes: 69 additions & 0 deletions README.md
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!
});
}
```

0 comments on commit 0eb7abc

Please sign in to comment.