#async #read-write #tokio #wait-group #container #separation #design

dark-std

dark-std is an Implementation of asynchronous containers build on tokio. It uses a read-write separation design borrowed from Golang

4 releases

0.2.16 Jul 7, 2024
0.2.14 May 3, 2024
0.2.11 Mar 15, 2024
0.2.9 Dec 11, 2023
0.1.2 Mar 13, 2022

#159 in Asynchronous

Download history 1041/week @ 2024-09-15 1230/week @ 2024-09-22 1122/week @ 2024-09-29 1170/week @ 2024-10-06 1105/week @ 2024-10-13 1225/week @ 2024-10-20 961/week @ 2024-10-27 1025/week @ 2024-11-03 821/week @ 2024-11-10 835/week @ 2024-11-17 1021/week @ 2024-11-24 1186/week @ 2024-12-01 1236/week @ 2024-12-08 1029/week @ 2024-12-15 512/week @ 2024-12-22 362/week @ 2024-12-29

3,219 downloads per month
Used in 36 crates (5 directly)

MIT/Apache

51KB
1.5K SLoC

dark-std

dark-std is an Implementation of asynchronous

  • defer! (defer macro)
  • SyncHashMap (async HashMap)
  • SyncBtreeMap (async BtreeMap)
  • SyncVec (async Vec)
  • WaitGroup (async/blocking all support WaitGroup)
  • AtomicDuration (atomic duration)

for example:

    #[tokio::test]
    pub async fn test_get() {
        let m = SyncHashMap::<i32, i32>::new();
        let insert = m.insert(1, 2);
        
        let g = m.get(&1).unwrap();//don't need lock and await
        assert_eq!(&2, g);
    }

wait group:

use std::time::Duration;
use tokio::time::sleep;
use dark_std::sync::WaitGroup;
#[tokio::test]
async fn test_wg() {
    let wg = WaitGroup::new();
    let wg2 = wg.clone();
    tokio::spawn(async move {
        sleep(Duration::from_secs(1)).await;
        drop(wg2);
    });
    let wg2 = wg.clone();
    tokio::spawn(async move {
        sleep(Duration::from_secs(1)).await;
        drop(wg2);
    });
    wg.wait_async().await;
    println!("all done");
}

Dependencies

~1.4–6.5MB
~37K SLoC