#read-write #async #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

#134 in Asynchronous

Download history 858/week @ 2024-11-16 963/week @ 2024-11-23 1228/week @ 2024-11-30 1226/week @ 2024-12-07 1032/week @ 2024-12-14 549/week @ 2024-12-21 453/week @ 2024-12-28 1083/week @ 2025-01-04 1245/week @ 2025-01-11 959/week @ 2025-01-18 679/week @ 2025-01-25 965/week @ 2025-02-01 853/week @ 2025-02-08 929/week @ 2025-02-15 919/week @ 2025-02-22 1357/week @ 2025-03-01

4,223 downloads per month
Used in 38 crates (6 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–7MB
~36K SLoC