scredis

Scredis is an advanced Redis client entirely written in Scala. It has been (and still is) extensively used in production at Livestream.

Redis v2.8.x commands are now supported! Scredis v1.1.0 has been released with the following changes.

Features

Supports all Redis commands up to v2.8.x
Native Scala types and customizable parsing
Asynchronous and synchronous commands processing
Transactions, pipelining and configurable automatic pipelining
Customizable timeouts and retries on a per-command basis
Client pooling

Getting started

Binaries

Scredis is compatible with Scala 2.9.x and 2.10.x. Binary releases are hosted on the Sonatype Central Repository.

resolvers += "Sonatype OSS Releases" at "https://oss.sonatype.org/content/repositories/releases/"

libraryDependencies ++= Seq("com.livestream" %% "scredis" % "1.1.0")

Snapshots are hosted on a separate repository.

resolvers += "Sonatype OSS Snapshots" at "https://oss.sonatype.org/content/repositories/snapshots/"

libraryDependencies ++= Seq("com.livestream" %% "scredis" % "1.1.1-SNAPSHOT")

Quick example

import scredis._
import scala.util.{ Success, Failure }
// Creates a rich asynchronous client with default parameters.
// See reference.conf for the complete list of configurable parameters.
val redis = Redis()

// Import the default execution context for working with futures
import redis.ec

// Futures handling
redis.hGetAll("my-hash") onComplete {
  case Success(content) => println(content)
  case Failure(e) => e.printStackTrace()
}

// Explicit pipelining
redis.pipelined { p =>
  p.hSet("my-hash")("name", "value")
  p.hGet("my-hash")("name")
}

// Executes a synchronous command, or any other command synchronously
redis.sync(_.blPop(0, "queue"))
redis.withClient(_.blPop(0, "queue"))

// Disconnects all internal clients and shutdown the default execution context
redis.quit()

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.

http://www.apache.org/licenses/LICENSE-2.0