implicit-await 0.1.0

Implicitly await calls returning Future impls
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

#![feature(async_await)]

use implicit_await::{defer, implicit_await};

use std::future::Future;
use futures::future::{join, ready, FutureExt};
use futures::executor::ThreadPool;

fn main() {
    ThreadPool::new().unwrap().run(sum().inspect(|sum| match sum {
        Ok(sum) => println!("The sum is {}", sum),
        Err(_) => println!("Summation failed")
    })).unwrap();
}

type IntResult = Result<u32, ()>;

#[implicit_await]
async fn sum() -> IntResult {
    // Call a synchronous function.
    let one: u32 = num_sync(1)?;
    // Call a synchronous function that returns an impl Future.
    let two: u32 = num_fut(2)?;
    // Call an asynchronous function.
    let three: u32 = num_async(3)?;
    // Sometimes you want to perform async actions in parallel. To allow that,
    // async function calls inside of a defer! {} block are not implicitly awaited.
    let (four, five, six) = defer! {(
        num_fut(4),
        num_async(5),
        num_async(6)
    )};
    // The join function is implicitly awaited.
    let (four, five) = join(four, five);
    // If you do end up with a Future value that was not implicitly awaited,
    // you can just use the .await operator as normal.
    let six = six.await?;
    Ok(one + two + three + four? + five? + six)
}

async fn num_async(num: u32) -> IntResult {
    Ok(num)
}

fn num_fut(num: u32) -> impl Future<Output = IntResult> {
    ready(Ok(num))
}

fn num_sync(num: u32) -> IntResult {
    Ok(num)
}