fast-async-mutex 0.5.0

The fast async mutex which uses spinlock algorithm with using waker
Documentation

fast-async-mutex

The fast async mutex which uses atomics with spinlock algorithm. Spinlock algorithm integrated with the Rust futures concept without the overhead of any libs. Also when the MutexGuard is dropped, a waker of the next locker will be executed. It will be works with any async runtime in Rust, it may be a tokio, smol, async-std and etc..

Examples

use fast_async_mutex::mutex::Mutex;

#[tokio::main]
async fn main() {
    let mutex = Mutex::new(10);
    let guard = mutex.lock().await;
    assert_eq!(*guard, 10);
}

Benchmarks

There is result of benchmarks which runs on MacBook Pro (16-inch, 2019) 2,3 GHz 8-Core Intel Core i9 16GB RAM Tests you can find in the benchmarks dir.

running 30 tests
test mutex::fast_async_mutex::tests::concurrency_without_waiting            ... bench:   1,582,255 ns/iter (+/- 226,548)
test mutex::fast_async_mutex::tests::create                                 ... bench:           0 ns/iter (+/- 0)
test mutex::fast_async_mutex::tests::step_by_step_without_waiting           ... bench:     165,499 ns/iter (+/- 58,886)
test mutex::fast_async_mutex_unordered::tests::concurrency_without_waiting  ... bench:   1,559,522 ns/iter (+/- 213,015)
test mutex::fast_async_mutex_unordered::tests::create                       ... bench:           0 ns/iter (+/- 0)
test mutex::fast_async_mutex_unordered::tests::step_by_step_without_waiting ... bench:      92,905 ns/iter (+/- 13,518)
test mutex::futures::tests::concurrency_without_waiting                     ... bench:   1,636,030 ns/iter (+/- 109,052)
test mutex::futures::tests::create                                          ... bench:          88 ns/iter (+/- 15)
test mutex::futures::tests::step_by_step_without_waiting                    ... bench:     210,283 ns/iter (+/- 15,931)
test mutex::smol::tests::concurrency_without_waiting                        ... bench:   1,870,199 ns/iter (+/- 142,146)
test mutex::smol::tests::create                                             ... bench:           0 ns/iter (+/- 0)
test mutex::smol::tests::step_by_step_without_waiting                       ... bench:     343,573 ns/iter (+/- 32,607)
test mutex::tokio::tests::concurrency_without_waiting                       ... bench:  22,686,028 ns/iter (+/- 3,648,661)
test mutex::tokio::tests::create                                            ... bench:          89 ns/iter (+/- 10)
test mutex::tokio::tests::step_by_step_without_waiting                      ... bench:     707,779 ns/iter (+/- 114,661)
test rwlock::fast_async_mutex::tests::concurrency_read                      ... bench:   1,698,161 ns/iter (+/- 153,215)
test rwlock::fast_async_mutex::tests::concurrency_write                     ... bench:   1,584,764 ns/iter (+/- 115,173)
test rwlock::fast_async_mutex::tests::create                                ... bench:           0 ns/iter (+/- 0)
test rwlock::fast_async_mutex::tests::step_by_step_read                     ... bench:     247,954 ns/iter (+/- 33,076)
test rwlock::fast_async_mutex::tests::step_by_step_writing                  ... bench:     153,154 ns/iter (+/- 27,294)
test rwlock::smol::tests::concurrency_read                                  ... bench:   1,667,601 ns/iter (+/- 188,827)
test rwlock::smol::tests::concurrency_write                                 ... bench:   2,139,812 ns/iter (+/- 208,289)
test rwlock::smol::tests::create                                            ... bench:           1 ns/iter (+/- 0)
test rwlock::smol::tests::step_by_step_read                                 ... bench:     196,376 ns/iter (+/- 26,671)
test rwlock::smol::tests::step_by_step_writing                              ... bench:     623,069 ns/iter (+/- 121,692)
test rwlock::tokio::tests::concurrency_read                                 ... bench:  24,207,303 ns/iter (+/- 3,060,491)
test rwlock::tokio::tests::concurrency_write                                ... bench:  23,943,930 ns/iter (+/- 1,776,313)
test rwlock::tokio::tests::create                                           ... bench:          86 ns/iter (+/- 19)
test rwlock::tokio::tests::step_by_step_read                                ... bench:     815,935 ns/iter (+/- 58,694)
test rwlock::tokio::tests::step_by_step_writing                             ... bench:     841,960 ns/iter (+/- 180,398)

test result: ok. 0 passed; 0 failed; 0 ignored; 30 measured; 0 filtered out

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.