[go: up one dir, main page]

async-lock 3.3.0

Async synchronization primitives
Documentation
mod common;

use std::sync::Arc;
#[cfg(not(target_family = "wasm"))]
use std::thread;

use async_lock::Mutex;
use futures_lite::future;

use common::check_yields_when_contended;

#[cfg(target_family = "wasm")]
use wasm_bindgen_test::wasm_bindgen_test as test;

#[cfg(target_family = "wasm")]
wasm_bindgen_test::wasm_bindgen_test_configure!(run_in_browser);

#[test]
fn smoke() {
    future::block_on(async {
        let m = Mutex::new(());
        drop(m.lock().await);
        drop(m.lock().await);
    })
}

#[cfg(all(feature = "std", not(target_family = "wasm")))]
#[test]
fn smoke_blocking() {
    let m = Mutex::new(());
    drop(m.lock_blocking());
    drop(m.lock_blocking());
}

#[cfg(all(feature = "std", not(target_family = "wasm")))]
#[test]
fn smoke_arc_blocking() {
    let m = Arc::new(Mutex::new(()));
    drop(m.lock_arc_blocking());
    drop(m.lock_arc_blocking());
}

#[test]
fn try_lock() {
    let m = Mutex::new(());
    *m.try_lock().unwrap() = ();
}

#[test]
fn into_inner() {
    let m = Mutex::new(10i32);
    assert_eq!(m.into_inner(), 10);
}

#[test]
fn get_mut() {
    let mut m = Mutex::new(10i32);
    *m.get_mut() = 20;
    assert_eq!(m.into_inner(), 20);
}

#[cfg(not(target_family = "wasm"))]
#[test]
fn contention() {
    future::block_on(async {
        let (tx, rx) = async_channel::unbounded();

        let tx = Arc::new(tx);
        let mutex = Arc::new(Mutex::new(0i32));
        let num_tasks = 100;

        for _ in 0..num_tasks {
            let tx = tx.clone();
            let mutex = mutex.clone();

            thread::spawn(|| {
                future::block_on(async move {
                    let mut lock = mutex.lock().await;
                    *lock += 1;
                    tx.send(()).await.unwrap();
                    drop(lock);
                })
            });
        }

        for _ in 0..num_tasks {
            rx.recv().await.unwrap();
        }

        let lock = mutex.lock().await;
        assert_eq!(num_tasks, *lock);
    });
}

#[test]
fn lifetime() {
    // Show that the future keeps the mutex alive.
    let _fut = {
        let mutex = Arc::new(Mutex::new(0i32));
        mutex.lock_arc()
    };
}

#[test]
fn yields_when_contended() {
    let m = Mutex::new(());
    check_yields_when_contended(m.try_lock().unwrap(), m.lock());

    let m = Arc::new(m);
    check_yields_when_contended(m.try_lock_arc().unwrap(), m.lock_arc());
}