#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

#124 in Asynchronous

Download history 1274/week @ 2024-08-12 1130/week @ 2024-08-19 944/week @ 2024-08-26 943/week @ 2024-09-02 1416/week @ 2024-09-09 973/week @ 2024-09-16 1336/week @ 2024-09-23 1120/week @ 2024-09-30 1080/week @ 2024-10-07 1228/week @ 2024-10-14 1086/week @ 2024-10-21 956/week @ 2024-10-28 1011/week @ 2024-11-04 840/week @ 2024-11-11 883/week @ 2024-11-18 1069/week @ 2024-11-25

3,886 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