radix

package module
Version: v0.0.0-...-6d2ea26 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Dec 5, 2015 License: MIT Imports: 0 Imported by: 0

README

Radix

GoDoc

Radix is a minimalistic Redis client for Go. It is broken up into small, single-purpose packages for ease of use.

  • redis - A wrapper around a single, non-thread-safe redis connection. Supports normal commands/response as well as pipelining.

  • pool - a simple, automatically expanding/cleaning connection pool. If you have multiple go-routines using the same redis instance you'll need this.

  • pubsub - a simple wrapper providing convenient access to Redis Pub/Sub functionality.

  • sentinel - a client for redis sentinel which acts as a connection pool for a cluster of redis nodes. A sentinel client connects to a sentinel instance and any master redis instances that instance is monitoring. If a master becomes unavailable, the sentinel client will automatically start distributing connections from the slave chosen by the sentinel instance.

  • cluster - a client for a redis cluster which automatically handles interacting with a redis cluster, transparently handling redirects and pooling. This client keeps a mapping of slots to nodes internally, and automatically keeps it up-to-date.

  • util - a package containing a number of helper methods for doing common tasks with the radix package, such as SCANing either a single redis instance or every one in a cluster, or executing server-side lua

Installation

go get github.com/mediocregopher/radix.v2/...

Testing

go test github.com/mediocregopher/radix.v2/...

The test action assumes you have the following running:

  • A redis server listening on port 6379

  • A redis cluster node listening on port 7000, handling slots 0 through 8191

  • A redis cluster node listening on port 7001, handling slots 8192 through 16383

The slot number are particularly important as the tests for the cluster package do some trickery which depends on certain keys being assigned to certain nodes

Why is this V2?

V1 of radix was started by fzzy and can be found here. Some time in 2014 I took over the project and reached a point where I couldn't make improvements that I wanted to make due to past design decisions (mostly my own). So I've started V2, which has redesigned some core aspects of the api and hopefully made things easier to use and faster.

Here are some of the major changes since V1:

  • Combining resp and redis packages

  • Reply is now Resp

  • Hash is now Map

  • Append is now PipeAppend, GetReply is now PipeResp

  • PipelineQueueEmptyError is now ErrPipelineEmpty

  • Significant changes to pool, making it easier to use

  • More functionality in cluster

Unless otherwise noted, the source files are distributed under the MIT License found in the LICENSE.txt file.

Documentation

Overview

Package radix is a simple redis driver. This top-level package is a wrapper for its sub-packages and doesn't actually contain an code. You likely want to look at the redis sub-package for a straightforward redis client

Source Files

Directories

Path Synopsis
Package cluster implements an almost drop-in replacement for a normal Client which accounts for a redis cluster setup.
Package cluster implements an almost drop-in replacement for a normal Client which accounts for a redis cluster setup.
Package pool implements a connection pool for redis connections which is thread-safe.
Package pool implements a connection pool for redis connections which is thread-safe.
Package pubsub provides a wrapper around a normal redis client which makes interacting with publish/subscribe commands much easier
Package pubsub provides a wrapper around a normal redis client which makes interacting with publish/subscribe commands much easier
Package redis is a simple client for connecting and interacting with a single redis instance.
Package redis is a simple client for connecting and interacting with a single redis instance.
Package sentinel provides a convenient interface with a redis sentinel which will automatically handle pooling connections and automatic failover.
Package sentinel provides a convenient interface with a redis sentinel which will automatically handle pooling connections and automatic failover.
Package util is a collection of helper functions for interacting with various parts of the radix.v2 package
Package util is a collection of helper functions for interacting with various parts of the radix.v2 package

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL