Skip to main content

Python client for Redis key-value store, extended to support additional features from YugaByteDB

Project description

The Python interface to the Redis key-value store, extended to support additional features from YugaByteDB.

This has been forked from https://github.com/andymccurdy/redis-py and is intended to be used against the YEDIS API end point of YugaByteDB. This client also supports additional commands (such as the time-series related commands) for use against YugaByte DB that are not part of the official Redis API.

Please refer to YugaByte DB docs for reference.

Installation

yedis requires a running YugaByteDB instance listening on the YEDIS end point, or a normal Redis server. See YugaByteDB quickstart or Redis’s quickstart for installation instructions.

To install yedis, simply:

$ sudo pip install yedis

or alternatively (you really should be using pip though):

$ sudo easy_install yedis

or from source:

$ sudo python setup.py install

Getting Started

>>> import redis
>>> r = redis.StrictRedis(host='localhost', port=6379, db=0)
>>> r.set('foo', 'bar')
True
>>> r.get('foo')
'bar'

By default, all responses are returned as bytes in Python 3 and str in Python 2. The user is responsible for decoding to Python 3 strings or Python 2 unicode objects.

If all string responses from a client should be decoded, the user can specify decode_responses=True to StrictRedis.__init__. In this case, any Redis command that returns a string type will be decoded with the encoding specified.

API Reference

Please refer to YugaByte API Refernce for details on the commmands that Yugabyte’s YEDIS end point supports. For other use cases, the official Redis command documentation does a great job of explaining each command in detail.

yedis is forked off redis-py, please refer to https://github.com/andymccurdy/redis-py for the details of the implementation and limitations.

Author

yedis is based on a fork of redis-py, extended to support the additional commands for use against YugaByteDB’s YEDIS API end point.

redis-py is developed and maintained by Andy McCurdy (sedrik@gmail.com). It can be found here: http://github.com/andymccurdy/redis-py

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

yedis-2.10.6.0.tar.gz (79.0 kB view hashes)

Uploaded Source

Built Distributions

yedis-2.10.6.0-py2.py3-none-any.whl (138.4 kB view hashes)

Uploaded Python 2 Python 3

yedis-2.10.6.0-py2.7.egg (331.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page