go-rejson

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,

Go-Redis/Redis
or use the print-like Redis-api client
GoModule/Redigo
. 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

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

Installation

go get github.com/nitishm/go-rejson

Example usage

package main

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

"github.com/nitishm/go-rejson"
goredis "github.com/go-redis/redis/v7"
"github.com/gomodule/redigo/redis"

)

// 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{
        "Mark",
        "S",
        "Pronto",
    },
    Rank: 1,
}
res, err := rh.JSONSet("student", ".", student)
if err != nil {
    log.Fatalf("Failed to JSONSet")
    return
}

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")
    return
}

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

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

}

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

rh := rejson.NewReJSONHandler()
flag.Parse()

// 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)
    }
}()
rh.SetRedigoClient(conn)
fmt.Println("Executing Example_JSONSET for Redigo Client")
Example_JSONSet(rh)

// 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)
    }
}()
rh.SetGoRedisClient(cli)
fmt.Println("\nExecuting Example_JSONSET for Redigo Client")
Example_JSONSet(rh)

}

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.