/pyapp.redis

Redis Extension

Primary LanguagePythonOtherNOASSERTION

pyApp - Redis

Let us handle the boring stuff!

This extension provides a Redis client factory to allow configuration to be configured via pyApp settings.

The extension also provides checks to confirm the settings are correct and that the application is able to connect to the redis instance.

It is strongly recommended to install the hiredis companion package to improve the performance of the redis client.

Installation

Install using pip:

pip install pyapp-redis

Install using pipenv:

pipenv install pyapp-redis

Add the REDIS block into your runtime settings file:

REDIS = {
    "default": {
        "url": "redis://user:pass@host:port/1",
    },
}

Note

The URL is a defined by Redis client see the documentation. In addition to the url any argument that can be provided to Redis.from_url can be provided.

Usage

The following example creates a Redis client instance:

from pyapp_ext.redis import get_client

# Get connection
redis = get_client()

redis.set("foo")

API

pyapp_ext.redis.get_client(default: str = None) -> Redis

Get named Redis client instance