#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

#143 in Asynchronous

Download history 1066/week @ 2024-10-08 1214/week @ 2024-10-15 1076/week @ 2024-10-22 998/week @ 2024-10-29 903/week @ 2024-11-05 888/week @ 2024-11-12 876/week @ 2024-11-19 1109/week @ 2024-11-26 1062/week @ 2024-12-03 1328/week @ 2024-12-10 838/week @ 2024-12-17 483/week @ 2024-12-24 606/week @ 2024-12-31 1238/week @ 2025-01-07 1124/week @ 2025-01-14 833/week @ 2025-01-21

3,872 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
~36K SLoC