Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A collection of cache helpers

Project Description

Useful cache helpers in one package!

Install

pip install cachelper

Helpers

In memory cache

memoize

Caching function return values in memory.

import cachelper

@cachelper.memoize()
def fibo(n):
    if n in (0, 1):
        return 1
    return fibo(n - 1) + fibo(n - 2)

fibo(10)

Cache with Redis/Memcached

Using the HelperMixin

HelperMixin can be used with any cache client classes that implement the following methods:

  • def get(self, key)
  • def set(self, key, value, timeout=None)
  • def delete(self, key)
  • def get_many(self, keys)
  • def set_many(self, mapping, timeout=None)

For example, RedisCache from werkzeug is one such class:

from redis import StrictRedis
from werkzeug.contrib.cache import RedisCache as _RedisCache

from cachelper import HelperMixin

class RedisCache(_RedisCache, HelperMixin):
    '''werkzeug.contrib.cache.RedisCache mixed with HelperMixin'''

    def get_many(self, keys):
        return super().get_many(*keys)

rds = StrictRedis()
cache = RedisCache(rds)

This mixin defines these methods: call, map, __call__. If your class already defines methods of the same name, the mixin methods may not work correctly.

cache decorator

Add cache by decorating a function or method.

@cache("key-{user_id}", timeout=300)
def get_name(user_id):
    # Fetch user name from database
    ...

The cache key template can also be a function which acts as a key factory:

def name_key(user_id):
    return "key-%s" % user_id

@cache(name_key, timeout=300)
def get_name(user_id):
    # Fetch user name from database
    ...

Just make sure the key factory function accepts the same parameters as the cached function and returns the key.

cached function calls

Sometimes we don’t want to cache all calls to a specific function. So the decorator is not suitable, we may cache the call instead the function in this case:

def get_name(user_id):
    # Fetch user name from database
    ...

user_id = 42
key = "key-{user_id}".format(user_id=user_id)
cache.call(lambda: get_name(user_id), key, timeout=300)

cached multiple calls

For most cache backends, it’s much faster to get or set caches in bulk.

def get_name(user_id):
    # Fetch user name from database
    ...

user_ids = [1, 2, 42, 1984]
names = cache.map("key-{user_id}", get_name, user_ids, timeout=300)
Release History

Release History

This version
History Node

0.3.0

History Node

0.2.0

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
cachelper-0.3.0.tar.gz (3.8 kB) Copy SHA256 Checksum SHA256 Source Sep 6, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting