A stand-alone Swift wrapper around the Redis client library, enabling access to Redis.
Swift
Latest commit de5a6b3 Jan 13, 2017 @kjessup kjessup Changed Net dep version

README.md

Perfect-Redis 简体中文

Get Involed with Perfect!

Star Perfect On Github Stack Overflow Follow Perfect on Twitter Join the Perfect Slack

Swift 3.0 Platforms OS X | Linux License Apache PerfectlySoft Twitter Slack Status

Redis client support for Perfect

Issues

We are transitioning to using JIRA for all bugs and support related issues, therefore the GitHub issues has been disabled.

If you find a mistake, bug, or any other helpful suggestion you'd like to make on the docs please head over to http://jira.perfect.org:8080/servicedesk/customer/portal/1 and raise it.

A comprehensive list of open issues can be found at http://jira.perfect.org:8080/projects/ISS/issues

Quick Start

Get a redis client with defaults:

RedisClient.getClient(withIdentifier: RedisClientIdentifier()) {
    c in
    do {
        let client = try c()
        ...
    } catch {
        ...
    }
}

Ping the server:

client.ping {
    response in
    defer {
        RedisClient.releaseClient(client)
    }
    guard case .simpleString(let s) = response else {
        ...
        return
    }
    XCTAssert(s == "PONG", "Unexpected response \(response)")
}

Set/get a value:

let (key, value) = ("mykey", "myvalue")
client.set(key: key, value: .string(value)) {
    response in
    guard case .simpleString(let s) = response else {
        ...
        return
    }
    client.get(key: key) {
        response in
        defer {
            RedisClient.releaseClient(client)
        }
        guard case .bulkString = response else {
            ...
            return
        }
        let s = response.toString()
        XCTAssert(s == value, "Unexpected response \(response)")
    }
}

Pub/sub:

RedisClient.getClient(withIdentifier: RedisClientIdentifier()) {
    c in
    do {
        let client1 = try c()
        RedisClient.getClient(withIdentifier: RedisClientIdentifier()) {
            c in
            do {
                let client2 = try c()
                client1.subscribe(channels: ["foo"]) {
                    response in
                    client2.publish(channel: "foo", message: .string("Hello!")) {
                        response in
                        client1.readPublished(timeoutSeconds: 5.0) {
                            response in
                            guard case .array(let array) = response else {
                                ...
                                return
                            }
                            XCTAssert(array.count == 3, "Invalid array elements")
                            XCTAssert(array[0].toString() == "message")
                            XCTAssert(array[1].toString() == "foo")
                            XCTAssert(array[2].toString() == "Hello!")
                        }
                    }
                }
            } catch {
                ...
            }
        }
    } catch {
        ...
    }
}

Building

Add this project as a dependency in your Package.swift file.

.Package(url: "https://github.com/PerfectlySoft/Perfect-Redis.git", Version(0,0,0)..<Version(10,0,0))

Further Information

For more information on the Perfect project, please visit perfect.org.