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
.
toml
[dependencies]
tokio-async-await-test = { git = "https://github.com/LucioFranco/tokio-async-await-test" }
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.
toml
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.
``` rust
extern crate futures; extern crate tokio; extern crate tokioasyncawait_test;
use tokioasyncawaittest::asynctest;
async fn basic() { await!(exampleasyncfn()); } ```
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.
``` rust
fn basic() { // -- snip -- let mut rt = Runtime::new().unwrap();
rt.block_on(fut().unit_error().boxed().compat()).unwrap();
} ```
You can also use a current thread runtime by importing use tokio_async_await_test::async_current_thread_test;
.