tokio-shared-rt

Crates.iotokio-shared-rt
lib.rstokio-shared-rt
version0.1.0
sourcesrc
created_at2023-05-26 09:23:52.107041
updated_at2023-05-26 09:23:52.107041
descriptionAllow `#[tokio::test]` to use a *shared* runtime
homepage
repository
max_upload_size
id874903
size3,996
gwy15 (gwy15)

documentation

README

tokio-shared-rt

Allow #[tokio::test] to use a shared runtime, so that static variables that connect to a tokio runtime inside are still valid between different test cases.

For example, if you have a global, static database connection pool, it internally holds references to some TCP connections which are bound to the runtime that created it. So if you have two test cases that are both marked #[tokio::test] and access that db pool, good chance is that one of them will fail.

thread 't3' panicked at 'called Result::unwrap() on an Err value: Custom { kind: Other, error: "A Tokio 1.x context was found, but it is being shutdown." }'

This crate provides a macro that uses a shared tokio runtime to run test cases to avoid this problem. Just replace your #[tokio::test] with #[tokio_shared_rt::test(shared)] and vualá! Now test passes.

Usage

#[tokio_shared_rt::test]
async fn t1() {
    db_pool().foo().await;
}
#[tokio_shared_rt::test(shared)]
async fn t2() {
    db_pool().foo().await;
}
#[tokio_shared_rt::test(shared = true)]
async fn t3() {
    db_pool().foo().await;
}
#[tokio_shared_rt::test(shared = false)]
async fn delicate_runtime_test() {
    db_pool().foo().await;
}
Commit count: 0

cargo fmt