/redpipe

Making Redis pipelines easier to use in python.

Primary LanguagePythonMIT LicenseMIT

RedPipe

Pain-Free redis pipelining in python.

BuildStatus CoverageStatus Version Python Documentation Status

RedPipe is a wrapper around the pipeline component of redis-py. It makes it easy to reduce network round trips when talking to Redis.

For more general information about redis pipelining, see the official redis documentation.

Use RedPipe to build pipelined redis calls in a modular reusable way. Rewrite your existing application calls via redis-py into efficient batches with only minimal changes.

Requirements

The redpipe module requires Python 2.7 or higher.

Installation

To install, use pip:

$ pip install redpipe

or from source:

$ python setup.py install

Quick Start

To use redpipe, You need to bind your redis client instance to RedPipe. Use the standard redis-py client.

client = redis.Redis()
redpipe.connect_redis(client)

You only need to do this setup once during application bootstrapping.

Using RedPipe is easy. We can pipeline multiple calls to redis and assign the results to variables. This makes pipeline code look and feel similar to the regular interface of redis-py.

with redpipe.pipeline() as pipe:
    foo = pipe.incr('foo')
    bar = pipe.incr('bar)
    pipe.execute()
print([foo, bar])

Documentation

Find RedPipe documentation on Read the Docs.