Type-safe Redis client for Golang
Go to file
Elena Kolevska e96c7b5f58
Function stats, function kill, fcall and fcall_ro (#2486)
2023-03-30 21:52:06 +08:00
.github chore(deps): bump actions/setup-go from 3 to 4 (#2495) 2023-03-20 13:35:49 +08:00
example chore: update go mod, Upgrade golang.org/x/net version to 0.7.0 (#2476) 2023-03-06 19:42:42 +08:00
extra chore: update go mod, Upgrade golang.org/x/net version to 0.7.0 (#2476) 2023-03-06 19:42:42 +08:00
fuzz chore: update import path 2023-01-23 08:48:54 +02:00
internal Pointer -> Ptr (#2458) 2023-02-24 13:47:58 +08:00
scripts chore: downgrade OpenTelemetry 2023-01-30 09:47:57 +02:00
.gitignore test: `TestRingSetAddrsContention` changed to Benchmark (#2316) 2022-12-16 23:34:43 +08:00
.golangci.yml chore: don't enable all lints 2021-11-19 17:09:58 +02:00
.prettierrc.yml chore: lazy reload when moved or ask 2021-10-04 13:16:33 +03:00
CHANGELOG.md chore: move pipelines change to breaking section 2023-02-05 09:24:53 +02:00
LICENSE chore: update import path 2023-01-23 08:48:54 +02:00
Makefile redis 7.0.10 (#2508) 2023-03-28 20:35:14 +08:00
README.md Allowing for running tests on a port other than the fixed 6380 (#2466) 2023-03-06 21:31:39 +08:00
RELEASING.md Fix releasing.md 2021-09-03 12:20:59 +03:00
bench_decode_test.go chore: update import path 2023-01-23 08:48:54 +02:00
bench_test.go chore: update import path 2023-01-23 08:48:54 +02:00
cluster.go fix(conn): releaseConn should be executed correctly 2023-01-28 15:44:06 +08:00
cluster_commands.go chore: cleanup names 2023-01-21 10:30:02 +02:00
cluster_test.go feat: Add support for CLUSTER SHARDS command (#2507) 2023-03-29 21:44:06 +08:00
command.go Function stats, function kill, fcall and fcall_ro (#2486) 2023-03-30 21:52:06 +08:00
command_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
commands.go Function stats, function kill, fcall and fcall_ro (#2486) 2023-03-30 21:52:06 +08:00
commands_test.go Function stats, function kill, fcall and fcall_ro (#2486) 2023-03-30 21:52:06 +08:00
doc.go doc: fix outdated reference. 2014-10-07 09:27:55 +03:00
error.go chore: update import path 2023-01-23 08:48:54 +02:00
example_instrumentation_test.go chore: update import path 2023-01-23 08:48:54 +02:00
example_test.go chore: update import path 2023-01-23 08:48:54 +02:00
export_test.go chore: update import path 2023-01-23 08:48:54 +02:00
go.mod test: remove testify (#2463) 2023-02-28 14:56:41 +08:00
go.sum test: remove testify (#2463) 2023-02-28 14:56:41 +08:00
internal_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
iterator.go fix: remove iterator mutex as it's not needed 2022-08-13 11:05:04 +10:00
iterator_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
main_test.go Allowing for running tests on a port other than the fixed 6380 (#2466) 2023-03-06 21:31:39 +08:00
options.go chore: update import path 2023-01-23 08:48:54 +02:00
options_test.go feat: add ClientName option 2022-12-28 22:14:52 +08:00
package.json chore: release v9.0.2 (release.sh) (#2412) 2023-02-01 10:13:41 +02:00
pipeline.go docs: fix comment typo (#2505) 2023-03-27 17:53:36 +08:00
pipeline_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
pool_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
pubsub.go chore: update import path 2023-01-23 08:48:54 +02:00
pubsub_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
race_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
redis.go fixed #2462 v9 continue support dragonfly, it's Hello command return "NOAUTH Authentication required" error (#2479) 2023-03-10 21:21:24 +08:00
redis_test.go Allowing for running tests on a port other than the fixed 6380 (#2466) 2023-03-06 21:31:39 +08:00
result.go chore: fix some command names 2022-08-08 10:28:46 +03:00
ring.go chore: update import path 2023-01-23 08:48:54 +02:00
ring_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
script.go feat: add HasErrorPrefix 2022-11-17 16:18:04 +02:00
sentinel.go chore: update import path 2023-01-23 08:48:54 +02:00
sentinel_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
tx.go chore: update import path 2023-01-23 08:48:54 +02:00
tx_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
universal.go feat: add ClientName option 2022-12-28 22:14:52 +08:00
universal_test.go chore: fewer test dependencies 2023-01-27 15:01:50 +00:00
version.go chore: release v9.0.2 (release.sh) (#2412) 2023-02-01 10:13:41 +02:00

README.md

Redis client for Go

build workflow PkgGoDev Documentation Chat

go-redis is brought to you by uptrace/uptrace. Uptrace is an open-source APM tool that supports distributed tracing, metrics, and logs. You can use it to monitor applications and set up automatic alerts to receive notifications via email, Slack, Telegram, and others.

See OpenTelemetry example which demonstrates how you can use Uptrace to monitor go-redis.

Documentation

Resources

Ecosystem

This client also works with Kvrocks, a distributed key value NoSQL database that uses RocksDB as storage engine and is compatible with Redis protocol.

Features

Installation

go-redis supports 2 last Go versions and requires a Go version with modules support. So make sure to initialize a Go module:

go mod init github.com/my/repo

Then install go-redis/v9:

go get github.com/redis/go-redis/v9

Quickstart

import (
    "context"
    "github.com/redis/go-redis/v9"
    "fmt"
)

var ctx = context.Background()

func ExampleClient() {
    rdb := redis.NewClient(&redis.Options{
        Addr:     "localhost:6379",
        Password: "", // no password set
        DB:       0,  // use default DB
    })

    err := rdb.Set(ctx, "key", "value", 0).Err()
    if err != nil {
        panic(err)
    }

    val, err := rdb.Get(ctx, "key").Result()
    if err != nil {
        panic(err)
    }
    fmt.Println("key", val)

    val2, err := rdb.Get(ctx, "key2").Result()
    if err == redis.Nil {
        fmt.Println("key2 does not exist")
    } else if err != nil {
        panic(err)
    } else {
        fmt.Println("key2", val2)
    }
    // Output: key value
    // key2 does not exist
}

Look and feel

Some corner cases:

// SET key value EX 10 NX
set, err := rdb.SetNX(ctx, "key", "value", 10*time.Second).Result()

// SET key value keepttl NX
set, err := rdb.SetNX(ctx, "key", "value", redis.KeepTTL).Result()

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

// ZRANGEBYSCORE zset -inf +inf WITHSCORES LIMIT 0 2
vals, err := rdb.ZRangeByScoreWithScores(ctx, "zset", &redis.ZRangeBy{
    Min: "-inf",
    Max: "+inf",
    Offset: 0,
    Count: 2,
}).Result()

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

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

// custom command
res, err := rdb.Do(ctx, "set", "key", "value").Result()

Run the test

go-redis will start a redis-server and run the test cases.

The paths of redis-server bin file and redis config file are defined in main_test.go:

var (
	redisServerBin, _  = filepath.Abs(filepath.Join("testdata", "redis", "src", "redis-server"))
	redisServerConf, _ = filepath.Abs(filepath.Join("testdata", "redis", "redis.conf"))
)

For local testing, you can change the variables to refer to your local files, or create a soft link to the corresponding folder for redis-server and copy the config file to testdata/redis/:

ln -s /usr/bin/redis-server ./go-redis/testdata/redis/src
cp ./go-redis/testdata/redis.conf ./go-redis/testdata/redis/

Lastly, run:

go test

Another option is to run your specific tests with an already running redis. The example below, tests against a redis running on port 9999.:

REDIS_PORT=9999 go test <your options>

See also

Contributors

Thanks to all the people who already contributed!