Skip to main content

A caching package with options for timed caching and caching aware rate limiting

Project description


To install memorize, simply use pip:

$ pip install memorize

or install directly from source to include latest changes:

$ pip install git+

or clone and then install:

$ git clone
$ cd memorize
$ python3 install


This class extends the functools.lru_cache functionality to add timed caching and caching aware rate limiting (e.g. if call results are returned from the cache then that particular call does not affect the rate limit)

  • Since a dictionary is used to cache results, the positional and keyword arguments to the function must be hashable (NOT lists, dicts, sets, or any other object that does not define hash())

  • It is very important to use the parenthesis even if empty: @memorize() NOT @memorize

  • When rate limiting, both the calls and period arguments must be provided otherwise an error is raised

Default Settings:
  • timeout = None (can be int or float)

  • maxsize = None (can be int)

  • typed = False (can be True)

  • calls = None (can be int)

  • period = None (can be int or float)

  • aware = False (can be True)

from memorize import memorize

# If you want to use all default settings
def fib(n):
    if n < 2:
        return n
        return fib(n-2) + fib(n-1)

# With memorization fib(20) will be run 21 times instead of 21891 times
# without memorization

# If you want to cache a maximum of 128 calls, cached by different types,
# each for 10 seconds use:
@memorize(timeout=10, maxsize=128, typed=True)

# If you want to implement caching aware rate limiting then use the following:
# This will limit to no more than 10 calls for every 5 second period and if a
# result is returned from the cache it does not count towards the 10 calls.
@memorize(calls=10, period=5, aware=True)


Please read the CONTRIBUTING document before making changes that you would like adopted in the code.

Code of Conduct

Everyone interacting in the memorize project’s codebase, issue trackers, chat rooms, and mailing lists is expected to follow the PyPA Code of Conduct.:octocat:

ETH 0xaD1F09626b9B8e701D5f0F4a237193Df73d3C445
BTC 199zsVqCusefv8yjdYQhUQZmLCyh75dqNV
LTC LUBqs7VxC43ttPsQuM1jaZFmshKTAU1Rs9

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

memorize-0.1.1.tar.gz (7.2 kB view hashes)

Uploaded source

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