memorised is a python module containing handy python-memcached
decorators and utils.
Specifically the memorise decorator allows you to quickly and simply
add memcache caching to any function or method.
Install memorised using pip:
pip install memorised
Or using the supplied setup.py:
python setup.py install
To cache a simple unbound function, just include the @memorise() tag to the
function definition (the paranthesis are needed as the decorator needs to be
initialised at the time of binding to handle memorise specific arguements):
from memorised.decorators import memorise
@memorise()
def myfunction():
return 'hello world'
You can do the same for simple instance and class methods, however for most instance methods, e.g. when caching results for database models, you probably want to include some form of identity to single out a method call on one instance from another instance. You can do this by providing a list of one or more parent keys, these are the names of attributes in the parent instance that you want to be appended to the memcache key:
class MyModel:
id = 1
@memorise(parent_keys=['id'])
def get_stats():
return blah()
For other usage examples see the unittests in tests.py.