CacheToolsUtils 0.9.0

Cachetools Utilities

cachetools-utils

Classes to add key prefix and stats to cachetools classes and use redis and memcached as storage backends.

Usage

See below.

Documentation

This module provide the following cache wrappers suitable to use with cachetools:

PrefixedCache

Add a key prefix.

import CacheToolsUtils as ctu

base = cachetools.TTLCache(ttl=600)
foo_cache = ctu.PrefixedCache(base, "foo.")
bla_cache = ctu.PrefixedCache(base, "bla.")

@cachetools.cached(cache=foo_cache)
def foo(…):
    return …

@cachetools.cached(cache=bla_cache)
def bla(…):
    return …

StatsCache

Keep stats, cache hit rate shown with hits().

MemCached

Basic wrapper with JSON key encoding.

import pymemcache as pmc

mcbase = pmc.Client(server="localhost", serde=ctu.JsonSerde())
cache = ctu.MemCached(mcbase)

@cachetools.cached(cache=cache)
def poc(…):

PrefixedMemCached

Wrapper with a prefix.

pcache = ctu.PrefixedMemCached(mcbase, prefix="pic.")

StatsMemCached

Wrapper with stats actually taken from the MemCached server.

RedisCache

TTL'ed Redis wrapper, default ttl is 10 minutes.

import redis

rd_base = redis.Redis(…, ttl=60)
cache = ctu.RedisCache(rd_base)

PrefixedRedisCache

Wrapper with a prefix and a ttl.

StatsRedisCache

Wrapper with stats (call hits()) and a ttl.

License

This code is public domain.

Versions

0.9.0

Initial version extracted from another project.

TODO

• improve documentation
• add __version__