#distributed #locking

redlock

Implementation of the distributed locking mechanism built on top of Redis

6 releases (stable)

2.0.0 Apr 6, 2023
1.2.0 Aug 30, 2021
1.1.0 Apr 6, 2021
1.0.0 Jan 15, 2016
0.3.0 Apr 9, 2015

#188 in Concurrency

Download history 303/week @ 2023-11-02 231/week @ 2023-11-09 216/week @ 2023-11-16 594/week @ 2023-11-23 385/week @ 2023-11-30 299/week @ 2023-12-07 275/week @ 2023-12-14 242/week @ 2023-12-21 523/week @ 2023-12-28 431/week @ 2024-01-04 175/week @ 2024-01-11 296/week @ 2024-01-18 461/week @ 2024-01-25 140/week @ 2024-02-01 464/week @ 2024-02-08 431/week @ 2024-02-15

1,597 downloads per month

BSD-3-Clause

19KB
359 lines

redlock-rs - Distributed locks with Redis

GitHub Workflow Status Crates.io

This is an implementation of Redlock, the distributed locking mechanism built on top of Redis. It is more or less a port of the Ruby version.

It includes a sample application in main.rs.

Build

cargo build --release

Usage

use redlock::RedLock;

fn main() {
  let rl = RedLock::new(vec!["redis://127.0.0.1:6380/", "redis://127.0.0.1:6381/", "redis://127.0.0.1:6382/"]);

  let lock;
  loop {
    match rl.lock("mutex".as_bytes(), 1000) {
      Some(l) => { lock = l; break }
      None => ()
    }
  }

  // Critical section

  rl.unlock(&lock);
}

Tests

Run tests with:

cargo test

Run sample application with:

cargo run --release

Contribute

If you find bugs or want to help otherwise, please open an issue.

Maintainer

  • From 2014 to June 2021 this crate was owned and maintained by @badboy
  • From June 2021 on this crate is maintained by @aig787

License

BSD. See LICENSE.

Dependencies

~3–5MB
~115K SLoC