Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/hoisie/redis

A simple, powerful Redis client for Go
https://github.com/hoisie/redis

Last synced: 24 days ago
JSON representation

A simple, powerful Redis client for Go

Lists

README 

        
## redis.go



redis.go is a client for the [redis](http://github.com/antirez/redis) key-value store. 



Some features include:



* Designed for Redis 2.6.x. 

* Support for all redis types - strings, lists, sets, sorted sets, and hashes

* Very simple usage

* Connection pooling ( with configurable size )

* Support for concurrent access

* Manages connections to the redis server, including dropped and timed out connections

* Marshaling/Unmarshaling go types to hashes



This library is stable and is used in production environments. However, some commands have not been tested as thoroughly as others. If you find any bugs please file an issue!



# Installation



Just run `go get github.com/hoisie/redis`



## Examples



Most of the examples connect to a redis database running in the default port -- 6379. 



### Hello World example



```go

package main



import "github.com/hoisie/redis"



func main() {

    var client redis.Client

    var key = "hello"

    client.Set(key, []byte("world"))

    val, _ := client.Get("hello")

    println(key, string(val))

}

```



### Strings 

```go

var client redis.Client

client.Set("a", []byte("hello"))

val, _ := client.Get("a")

println(string(val))

client.Del("a")

```

### Lists

```go

var client redis.Client

vals := []string{"a", "b", "c", "d", "e"}

for _, v := range vals {

    client.Rpush("l", []byte(v))

}

dbvals,_ := client.Lrange("l", 0, 4)

for i, v := range dbvals {

    println(i,":",string(v))

}

client.Del("l")

```

### Publish/Subscribe

```go

sub := make(chan string, 1)

sub <- "foo"

messages := make(chan Message, 0)

go client.Subscribe(sub, nil, nil, nil, messages)



time.Sleep(10 * 1000 * 1000)

client.Publish("foo", []byte("bar"))



msg := <-messages

println("received from:", msg.Channel, " message:", string(msg.Message))



close(sub)

close(messages)

```



More examples coming soon. See `redis_test.go` for more usage examples.



## Commands not supported yet



* MULTI/EXEC/DISCARD/WATCH/UNWATCH

* SORT

* ZUNIONSTORE / ZINTERSTORE