Skip to main content

Extensible memoizing collections and decorators

Project description

Latest PyPI version CI build status Documentation build status Test coverage Libraries.io SourceRank License Code style: black

This module provides various memoizing collections and decorators, including variants of the Python Standard Library’s @lru_cache function decorator.

from cachetools import cached, LRUCache, TTLCache

# speed up calculating Fibonacci numbers with dynamic programming
@cached(cache={})
def fib(n):
    return n if n < 2 else fib(n - 1) + fib(n - 2)

# cache least recently used Python Enhancement Proposals
@cached(cache=LRUCache(maxsize=32))
def get_pep(num):
    url = 'http://www.python.org/dev/peps/pep-%04d/' % num
    with urllib.request.urlopen(url) as s:
        return s.read()

# cache weather data for no longer than ten minutes
@cached(cache=TTLCache(maxsize=1024, ttl=600))
def get_weather(place):
    return owm.weather_at_place(place).get_weather()

For the purpose of this module, a cache is a mutable mapping of a fixed maximum size. When the cache is full, i.e. by adding another item the cache would exceed its maximum size, the cache must choose which item(s) to discard based on a suitable cache algorithm.

This module provides multiple cache classes based on different cache algorithms, as well as decorators for easily memoizing function and method calls.

Installation

cachetools is available from PyPI and can be installed by running:

pip install cachetools

Typing stubs for this package are provided by typeshed and can be installed by running:

pip install types-cachetools

Project Resources

License

Copyright (c) 2014-2025 Thomas Kemmer.

Licensed under the MIT License.

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

cachetools-5.5.2.tar.gz (28.4 kB view details)

Uploaded Source

Built Distribution

cachetools-5.5.2-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file cachetools-5.5.2.tar.gz.

File metadata

  • Download URL: cachetools-5.5.2.tar.gz
  • Upload date:
  • Size: 28.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cachetools-5.5.2.tar.gz
Algorithm Hash digest
SHA256 1a661caa9175d26759571b2e19580f9d6393969e5dfca11fdb1f947a23e640d4
MD5 bc4019928cf73ca154ff5416280282bb
BLAKE2b-256 6c813747dad6b14fa2cf53fcf10548cf5aea6913e96fab41a3c198676f8948a5

See more details on using hashes here.

File details

Details for the file cachetools-5.5.2-py3-none-any.whl.

File metadata

  • Download URL: cachetools-5.5.2-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.3

File hashes

Hashes for cachetools-5.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d26a22bcc62eb95c3beabd9f1ee5e820d3d2704fe2967cbe350e20c8ffcd3f0a
MD5 636aa302dbfae97f06c895b1c2c69c76
BLAKE2b-256 727620fa66124dbe6be5cafeb312ece67de6b61dd91a0247d1ea13db4ebb33c2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page