async-promise 0.1.1

Async promise which resolves once and may be read by multiple consumers.
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
29
30
31
32
33
34
35

# `async-promise`

A simple promise implementation that allows for a single producer to resolve a value to multiple consumers.

Similar to a oneshot channel, but allows for multiple consumers to wait for the value to be resolved, which will be
provided as a reference (`&T`).

Similar to an async `OnceCell`, but consumers may only await the value, and may not attempt to set it.

Use [`channel()`] to create a new promise and resolver pair.

## Usage

Add the following to your `Cargo.toml`:

```toml
[dependencies]
async-promise = "..."
```

Basic usage:
```rust
#[tokio::main]
async fn main() {
    let (resolve, promise) = async_promise::channel::<i32>();

    // Resolve the promise.
    resolve.into_resolve(42);

    // Read the value.
    // May be read by multiple consumers.
    let value = promise.wait().await;
    assert_eq!(Some(&42), value);
}
```