1 unstable release

0.1.0 May 26, 2023

#28 in #fail

Download history 82/week @ 2023-12-18 30/week @ 2023-12-25 40/week @ 2024-01-01 146/week @ 2024-01-08 145/week @ 2024-01-15 194/week @ 2024-01-22 172/week @ 2024-01-29 400/week @ 2024-02-05 320/week @ 2024-02-12 150/week @ 2024-02-19 205/week @ 2024-02-26 174/week @ 2024-03-04 226/week @ 2024-03-11 318/week @ 2024-03-18 343/week @ 2024-03-25 482/week @ 2024-04-01

1,379 downloads per month
Used in 6 crates (via tokio-shared-rt)

MIT license

40KB
681 lines

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;
}

lib.rs:

Macros for use with Tokio

Dependencies

~325–770KB
~18K SLoC