Skip to content

An implementation of a single instance Redis Lock for server side Swift

Notifications You must be signed in to change notification settings

gotranseo/redis-lock

 
 

Repository files navigation

RedisLock

This is an implementation of a single instance Redis Lock as described in Distributed Locks with Redis.

  • Uses a RediStack client which sits on SwiftNIO
  • Supports Swift async calls

Example

These examples are simple and all use async/await. EventLoopFuture versions exist of all the APIs. Have a look at the tests for more insight.

    let firstLock = RedisLock(key: "simLock")
    let secondLock = RedisLock(key: "simLock")

    try await firstLock.lock(expirySeconds: 20, on: redis) // Succeeds
    try await firstLock.isLocked(on: redis) // true
    try await secondLock.ensureLock(on: redis) // Throws because it uses the same key as the active lock
    try await secondLock.isLocked(on: redis) // true, even though it's not the owner
    
    try await firstLock.unlock(on: redis)
    try await secondLock.ensureLock(on: redis) // Works now because the first lock succeeded
    try await firstLock.verifyOwnership(on: redis) // false
    try await secondLock.verifyOwnership(on: redis) // true

Installing

To install RedisLock, just add it to Package.swift in the top level dependencies section.

dependencies: [
    .package(url: "https://github.com/gotranseo/RedisLock.git", from: "1.0.0")
]

And add it to your target dependencies like this:

    .product(name: "RedisLock", package: "redis-lock")

About

An implementation of a single instance Redis Lock for server side Swift

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 100.0%