[−][src]Crate safina_async_test

A macro for running async fn tests.

It is part of safina, a safe async runtime.

Runs tests with safina_executor::block_on.

Features

forbid(unsafe_code)
Straightforward implementation

Limitations

Requires Rust nightly because safina-executor does

Examples

use safina_async_test::async_test;
#[async_test]
async fn test1() {
    an_async_fn().await.unwrap();
}

use safina_async_test::async_test;
#[async_test]
async fn test2() {
    let executor = safina_executor::Executor::new(1);
    executor.spawn(background_task());
    assert_eq!(42, do_request().await.unwrap());
}

Documentation

https://docs.rs/safina-async-test

Alternatives

Changelog

v0.1.5 - Use safina-executor v0.1.3 API
v0.1.4 - Upgrade to new safina-executor version which removes need for Box::pin.
v0.1.3 - Add badges to readme. Rename safina package to safina-executor.
v0.1.2 - Update docs
v0.1.1 - First published version

TO DO

DONE - Implement as declarative macro. UX is bad.
DONE - Implement as procedural macro.
DONE - Report errors nicely
DONE - Publish on crates.io
Let users depend only on safina-async-test:
1. Move proc macro to its own crate.
2. Make safina_async_test re-export the macro and safina_executor::block_on.
3. Change the macro to call safina_async_test::block_on.
Automatically start a worker thread and timer thread.

Release Process

Edit Cargo.toml and bump version number.
Run ./release.sh

Attribute Macros