#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

#116 in Asynchronous

Download history 1365/week @ 2024-07-23 1314/week @ 2024-07-30 1375/week @ 2024-08-06 1298/week @ 2024-08-13 1055/week @ 2024-08-20 901/week @ 2024-08-27 1038/week @ 2024-09-03 1378/week @ 2024-09-10 978/week @ 2024-09-17 1327/week @ 2024-09-24 1152/week @ 2024-10-01 1066/week @ 2024-10-08 1214/week @ 2024-10-15 1076/week @ 2024-10-22 998/week @ 2024-10-29 864/week @ 2024-11-05

4,352 downloads per month
Used in 35 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–6MB
~37K SLoC