Type-safe Redis client for Golang
Go to file
Vladimir Mihailenco fb7803ad5a Use time.Duration to specify timeout. 2015-04-13 09:48:40 +03:00
.test Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
.gitignore Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
.travis.yml travis: add missing dependency. 2015-03-30 16:00:36 +03:00
LICENSE Add license. Fixes #1. 2012-12-19 13:05:50 +02:00
Makefile Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
README.md Add link to the redis cluster. 2015-01-13 12:36:49 +02:00
cluster.go Add reaper that closes idle connections to the cluster. 2015-04-05 15:41:16 +03:00
cluster_client_test.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
cluster_test.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00
command.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00
command_test.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00
commands.go Use time.Duration to specify timeout. 2015-04-13 09:48:40 +03:00
commands_test.go Use time.Duration to specify timeout. 2015-04-13 09:48:40 +03:00
crc16.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
crc16_test.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
doc.go doc: fix outdated reference. 2014-10-07 09:27:55 +03:00
error.go Don't remove connection from the pool on redis errors. 2014-06-18 15:55:49 +03:00
example_test.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00
export_test.go Unexport HashSlot. 2015-03-23 10:23:33 +02:00
multi.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
multi_test.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00
parser.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
parser_test.go More benchmarks. 2014-07-04 15:19:45 +03:00
pipeline.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
pipeline_test.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00
pool.go Add reaper that closes idle connections to the cluster. 2015-04-05 15:41:16 +03:00
pool_test.go Use a lock-free connection pool 2015-01-31 13:20:37 +00:00
pubsub.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
pubsub_test.go Fix/normalise pubsubnumsub response 2015-01-30 17:09:57 +02:00
redis.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
redis_test.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00
script.go all: switch to gopkg.in. 2014-05-11 10:44:22 +03:00
sentinel.go Add reaper that closes idle connections to the cluster. 2015-04-05 15:41:16 +03:00
sentinel_test.go Refactor Set, SetNX and SetXX with expiration. 2015-03-30 16:49:08 +03:00

README.md

Redis client for Golang Build Status

Supports:

  • Redis 2.8 commands except QUIT, MONITOR, SLOWLOG and SYNC.
  • Pub/sub.
  • Transactions.
  • Pipelining.
  • Connection pool.
  • TLS connections.
  • Thread safety.
  • Timeouts.
  • Redis Sentinel.
  • Redis Cluster: https://github.com/bsm/redis-cluster.

API docs: http://godoc.org/gopkg.in/redis.v2. Examples: http://godoc.org/gopkg.in/redis.v2#pkg-examples.

Installation

Install:

go get gopkg.in/redis.v2

Look and feel

Some corner cases:

SORT list LIMIT 0 2 ASC
vals, err := client.Sort("list", redis.Sort{Offset: 0, Count: 2, Order: "ASC"}).Result()

ZRANGEBYSCORE zset -inf +inf WITHSCORES LIMIT 0 2
vals, err := client.ZRangeByScoreWithScores("zset", redis.ZRangeByScore{
    Min: "-inf",
    Max: "+inf",
    Offset: 0,
    Count: 2,
}).Result()

ZINTERSTORE out 2 zset1 zset2 WEIGHTS 2 3 AGGREGATE SUM
vals, err := client.ZInterStore("out", redis.ZStore{Weights: []int64{2, 3}}, "zset1", "zset2").Result()

EVAL "return {KEYS[1],ARGV[1]}" 1 "key" "hello"
vals, err := client.Eval("return {KEYS[1],ARGV[1]}", []string{"key"}, []string{"hello"}).Result()