niki/vendor/github.com/redis/go-redis/v9
alikafy 4185ef594b fix: rebase 2024-07-03 10:17:54 +03:30
..
internal feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
.gitignore feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
.golangci.yml feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
.prettierrc.yml feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
CHANGELOG.md feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
CONTRIBUTING.md feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
LICENSE feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
Makefile feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
README.md feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
RELEASING.md feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
acl_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
bitmap_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
cluster_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
command.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
doc.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
error.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
gears_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
generic_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
geo_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
hash_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
hyperloglog_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
iterator.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
json.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
list_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
options.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
osscluster.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
osscluster_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
package.json feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
pipeline.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
probabilistic.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
pubsub.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
pubsub_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
redis.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
result.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
ring.go fix: rebase 2024-07-03 10:17:54 +03:30
script.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
scripting_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
sentinel.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
set_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
sortedset_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
stream_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
string_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
timeseries_commands.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
tx.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
universal.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30
version.go feat(niki): dockerize app 2024-02-18 14:12:21 +03:30

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.

How do I Redis?

Learn for free at Redis University

Build faster with the Redis Launchpad

Try the Redis Cloud

Dive in developer tutorials

Join the Redis community

Work at 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"
    "fmt"

    "github.com/redis/go-redis/v9"
)

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
}

The above can be modified to specify the version of the RESP protocol by adding the protocol option to the Options struct:

    rdb := redis.NewClient(&redis.Options{
        Addr:     "localhost:6379",
        Password: "", // no password set
        DB:       0,  // use default DB
        Protocol: 3, // specify 2 for RESP 2 or 3 for RESP 3
    })

Connecting via a redis url

go-redis also supports connecting via the redis uri specification. The example below demonstrates how the connection can easily be configured using a string, adhering to this specification.

import (
    "context"
    "fmt"

    "github.com/redis/go-redis/v9"
)

func ExampleClient() *redis.Client {
    url := "redis://user:password@localhost:6379/0?protocol=3"
    opts, err := redis.ParseURL(url)
    if err != nil {
        panic(err)
    }

    return redis.NewClient(opts)
}

Contributing

Please see out contributing guidelines to help us improve this library!

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!