ambience 0.2.1

Lightweight library for passing ambient parameters
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

# Ambience

A lightweight library for passing ambient parameters.

## Examples

Thread-local ambient parameters can be set with `ambience::thread::set`. The ambient parameter can then be accessed via `ambience::thread::get` until the guard object returned by `set` is dropped.

```rust
struct User {
    // ...
}

fn process() {
    // retrieve the user from this threads ambient environment
    let user: Rc<User> = ambience::thread::get::<User>();
    // ...
}

fn main() {
    let user = // ...

    // set the user as ambient data for the current thread.
    // the value is accessible until `_ambience_guard` is dropped.
    let _ambience_guard = ambience::thread::set::<User>(user);
    process();
}
```