#lock #mutex #rwlock #locking

padlock

Safely acquire RwLock/Mutex locks

3 unstable releases

0.2.0 May 4, 2020
0.1.1-alpha Feb 1, 2020
0.1.0-alpha Jan 28, 2020

#709 in Concurrency

Download history 380/week @ 2024-07-21 405/week @ 2024-07-28 343/week @ 2024-08-04 392/week @ 2024-08-11 411/week @ 2024-08-18 425/week @ 2024-08-25 358/week @ 2024-09-01 405/week @ 2024-09-08 396/week @ 2024-09-15 576/week @ 2024-09-22 592/week @ 2024-09-29 259/week @ 2024-10-06 346/week @ 2024-10-13 411/week @ 2024-10-20 421/week @ 2024-10-27 296/week @ 2024-11-03

1,497 downloads per month
Used in 7 crates (via tray-item)

MIT/Apache

9KB
96 lines

Padlock

Safely acquire RwLock/Mutex locks and never worry about remembering to drop them!

CircleCI docs

License

MIT or Apache-2.0


lib.rs:

Aquire Mutex and RwLocks safely.

All methods in this crate will try to lock the passed Mutex or RwLock, if the locking fails, spin_loop_hint is called and we try again. This practice is called spinlock.

This means that all calls will block the current thread.

Important: When using methods like mutex_lock, remember that the lock is droped first when the lambda finishes running.

Example:

 use std::{
     thread,
     sync::{Arc, Mutex},
     time::Duration
 };

 #[derive(Debug)]
 struct Person {
     age: u8,
     name: String
 }

 fn main() {

     let people = Arc::new(Mutex::new(Vec::<Person>::new()));
     let mut threads = Vec::<thread::JoinHandle<()>>::new();

     // Write in one thread
     let people_clone = Arc::clone(&people);
     threads.push(thread::spawn(move || {

         for i in 0..10 {

             padlock::mutex_lock(&people_clone, |lock| {

                 lock.push(Person {
                     age: i * 10,
                     name: format!("Name {}", i)
                 });

             });

             thread::sleep(Duration::from_millis(500));

         }

     }));

     // Read from another
     let people_clone = Arc::clone(&people);
     threads.push(thread::spawn(move || {

         for _ in 0..6 {

             padlock::mutex_lock(&people_clone, |lock| {

                 for person in lock {
                     println!("{:?}", person);
                 }

             });

             thread::sleep(Duration::from_secs(1));

         }

     }));

     for t in threads {
         t.join();
     }

 }

No runtime deps