Type-safe Redis client for Golang
Go to file
Vladimir Mihailenco 381a6375dd Merge pull request #75 from go-redis/fix/better-rate-limiter
Improve rate-limiter
2015-03-30 16:15:21 +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 Fixed redirects logic - 'max' means less that or equals to 2015-03-19 11:40:18 +00:00
cluster_client_test.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
cluster_test.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
command.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
command_test.go Use a lock-free connection pool 2015-01-31 13:20:37 +00:00
commands.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
commands_test.go Add Redis Cluster support. 2015-03-19 11:19:55 +02: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 Fix example. 2015-01-30 15:41:57 +02:00
export_test.go all: switch to gopkg.in. 2014-05-11 10:44:22 +03:00
multi.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
multi_test.go Migrates tests to ginkgo/gomega 2015-01-25 11:56:03 +00: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 Migrates tests to ginkgo/gomega 2015-01-25 11:56:03 +00:00
pool.go Improved rate-limiter, use ratelimit package 2015-03-25 17:02:26 +00: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 Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
script.go all: switch to gopkg.in. 2014-05-11 10:44:22 +03:00
sentinel.go Add Redis Cluster support. 2015-03-19 11:19:55 +02:00
sentinel_test.go Make sentinel tests more reliable. 2015-01-30 16:45:57 +02: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()