Skip to main content

Cache decorator for global or instance level memoize.

Project description

VERSION: 0.1.2


Function decorator that helps to cache/memoize the result of a function/method.

This package contains following decorators.

  • cache: cache the result of the function globally.

  • instance_cache: cache the result of a method in the instance (self)

  • clear_instance_cache: clear the method results cached on the instance.

And one function.

  • clear_cache: clear the global function cache.

Tested on python 2.7 and python 3.4.

For quick start, check the tutorial section of this page. Check for detail examples.


pip install cachez


Apache License version 2


  • To cache the result of the a function globally, decorate the function with cache.

def foo(x, y):
  • To clear the global cache, call clear_cache().

  • To cache the result of the method in the instance, decorate the method with instance_cache. To clear the method cache on the instance, decorate your clear method with clear_instance_cache.

class Foo(object):
    def bar(a, b):

    def clear():
  • To persist the function return value, use persisted decorator. This decorator takes input parameter which specify when the cache will expire. The default value for cache expiration is set to 1 day.

class Foo(object):
    def default_persist_for_1_day(x):

    def persist_return_value_for_5_seconds(y):
  • The default persist folder is set to ~/.cachez. You could customize it by calling set_persist_folder.

To file issue, please visit:

Contact author:


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

cachez-0.1.2.tar.gz (11.2 kB view hashes)

Uploaded source

Built Distribution

cachez-0.1.2-py2.py3-none-any.whl (8.4 kB view hashes)

Uploaded 3 6

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page