by nitishm

nitishm / go-rejson

Golang client for redislabs' ReJSON module with support for multilple redis clients (redigo, go-redi...

143 Stars 17 Forks Last release: 3 months ago (v3.0.0) MIT License 105 Commits 3 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Go-ReJSON - a golang client for ReJSON (a JSON data type for Redis)

Go-ReJSON is a Go client for ReJSON Redis Module.

GoDoc Build Status codecov Go Report Card

ReJSON is a Redis module that implements ECMA-404 The JSON Data Interchange Standard as a native data type. It allows storing, updating and fetching JSON values from Redis keys (documents).

Primary features of ReJSON Module:

* Full support of the JSON standard
* JSONPath-like syntax for selecting element inside documents
* Documents are stored as binary data in a tree structure, allowing fast access to sub-elements
* Typed atomic operations for all JSON values types

Each and every feature of ReJSON Module is fully incorporated in the project.

Enjoy ReJSON with the type-safe Redis client,

or use the print-like Redis-api client
. Go-ReJSON supports both the clients. Use any of the above two client you want, Go-ReJSON helps you out with all its features and functionalities in a more generic and standard way.

Support for

and other Redis clients is in our RoadMap. Any contributions on the support for other clients is hearty welcome.


go get github.com/nitishm/go-rejson

Example usage

package main

import ( "encoding/json" "flag" "fmt" "log"

goredis "github.com/go-redis/redis/v7"


// Name - student name type Name struct { First string json:"first,omitempty" Middle string json:"middle,omitempty" Last string json:"last,omitempty" }

// Student - student object type Student struct { Name Name json:"name,omitempty" Rank int json:"rank,omitempty" }

func Example_JSONSet(rh *rejson.Handler) {

student := Student{
    Name: Name{
    Rank: 1,
res, err := rh.JSONSet("student", ".", student)
if err != nil {
    log.Fatalf("Failed to JSONSet")

if res.(string) == "OK" {
    fmt.Printf("Success: %s\n", res)
} else {
    fmt.Println("Failed to Set: ")

studentJSON, err := redis.Bytes(rh.JSONGet("student", "."))
if err != nil {
    log.Fatalf("Failed to JSONGet")

readStudent := Student{}
err = json.Unmarshal(studentJSON, &readStudent)
if err != nil {
    log.Fatalf("Failed to JSON Unmarshal")

fmt.Printf("Student read from redis : %#v\n", readStudent)


func main() { var addr = flag.String("Server", "localhost:6379", "Redis server address")

rh := rejson.NewReJSONHandler()

// Redigo Client
conn, err := redis.Dial("tcp", *addr)
if err != nil {
    log.Fatalf("Failed to connect to redis-server @ %s", *addr)
defer func() {
    _, err = conn.Do("FLUSHALL")
    err = conn.Close()
    if err != nil {
        log.Fatalf("Failed to communicate to redis-server @ %v", err)
fmt.Println("Executing Example_JSONSET for Redigo Client")

// GoRedis Client
cli := goredis.NewClient(&goredis.Options{Addr: *addr})
defer func() {
    if err := cli.FlushAll().Err(); err != nil {
        log.Fatalf("goredis - failed to flush: %v", err)
    if err := cli.Close(); err != nil {
        log.Fatalf("goredis - failed to communicate to redis-server: %v", err)
fmt.Println("\nExecuting Example_JSONSET for Redigo Client")


We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.