Skip to main content

A convenience wrapper for the official Python redis package

Project description

Py-Redis

A convenience wrapper for the official Python Redis package. Supports the Python context manager protocol and takes care of (de-)serializing data to JSON, as well as helper methods to work on multiple keys.

Object Creation

from pyredis import RedisConnection

# pass everything you would pass to redis.Redis()
redis_args = {
    'host': 'localhost',
    # 'password': 'my$ecureRed1s',
    # 'port': 1234,
}

with RedisConnection(**redis_args) as my_redis:
    my_redis.set('key', 'value')

Redis Get and Set

# redis set
with RedisConnection(**redis_args) as my_redis:
    my_redis.set('a_sting', 'my_sting value')
    my_redis.set('a_list', [1, 4, 3, 2])
    my_redis.set('a_dict', {'key_1': 'val_1', 'key_2': 'val_2'})

# redis get
with RedisConnection(**redis_args) as my_redis:
    data = my_redis.get('a_dict')
    # data is already converted to a dict
    print(type(data))

Handle Lists and Dictionaries

from pprint import pprint

# get multiple keys / data
with RedisConnection(**redis_args) as my_redis:
    # get all keys that start with a_
    pattern = 'a_'
    keys = my_redis.get_key_pattern(pattern)
    print(f"list of all keys that start with {pattern}: {keys}")
    data = my_redis.get_data_for_keys(keys)
    print(f"data of all keys that start with {pattern}: {data}")

    # or retrieve the data as a key: data dictionary for a specific pattern
    print('data as key: data dictionary for a pattern:')
    data = my_redis.get_keys('a_')
    pprint(data)

# set all entries of a dictionary to redis
data = {'a': 12, 'b': 'myvalue'}
with RedisConnection(**redis_args) as my_redis:
    # yo can continue working with the keys
    keys = my_redis.set_dict(data)
    print(my_redis.get('a'))
    print(my_redis.get(keys[1]))

Fallback

# you can always work directly on the redis.Redis() object, 
# as you would with the official package,
# by using the RedisConnection.R attribute
with RedisConnection(**redis_args) as my_redis:
    print('access redis client through object...')
    print(my_redis.R.get('a_dict'))

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

py-redis-1.1.1.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

py_redis-1.1.1-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file py-redis-1.1.1.tar.gz.

File metadata

  • Download URL: py-redis-1.1.1.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for py-redis-1.1.1.tar.gz
Algorithm Hash digest
SHA256 f64cfa44dcd69af19348234ba96a2a943e3793248dcbdb267bdefb1751f4002f
MD5 5644c31589cf9ed4b46a984d6b402c71
BLAKE2b-256 17dcf3972b4358680575e5027d2276c5ffc7b592480e212a9c1a02c06bc16bbc

See more details on using hashes here.

File details

Details for the file py_redis-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: py_redis-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 4.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.7

File hashes

Hashes for py_redis-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 c6ec84fc8251398236f1c0b98f6ad09dc61667c29664efb7d44e95dc5763782e
MD5 49a6df1ac7b48e46edfd06718c4c194c
BLAKE2b-256 58bd2c4313dfe3b09e253d64231c3386baca9db6952de7e71996e165428d6e45

See more details on using hashes here.

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