nightly macro tokio-async-await-test

A macro for better async/await tokio testing

1 unstable release

✓ Uses Rust 2018 edition

0.1.0 Dec 3, 2018

#45 in #proc-macro

2 downloads per month



Tokio Async/Await Test

Build Status

This is a simple crate that provides a procedural macro similar to #[test] that will run the test as a single future on a tokio runtime.


First, you must be on nightly rust as of 12-02-2018. Add the crate to your Cargo.toml.

tokio-async-await-test = { git = "" }

This will give you the crate but you will also need to make sure that you also have futures-preview and tokio as dependencies like so.

tokio = { version = "0.1", features = ["async-await-preview"] }
futures-preview = { version = "0.3.0-alpha.10", features = ["tokio-compat"] }

Once, you have all these dependencies you can then use the attribute like so.

#![feature(pin, async_await, await_macro, futures_api)]

extern crate futures;
extern crate tokio;
extern crate tokio_async_await_test;

use tokio_async_await_test::async_test;

async fn basic() {

This will spin up a tokio runtime and block on the basic function. This generally expands to look like this. Where fut is the test future you are running.

fn basic() {
	// -- snip --
    let mut rt = Runtime::new().unwrap();

You can also use a current thread runtime by importing use tokio_async_await_test::async_current_thread_test;.


~42K SLoC