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-2026 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-7.0.6.tar.gz (37.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cachetools-7.0.6-py3-none-any.whl (14.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: cachetools-7.0.6.tar.gz
  • Upload date:
  • Size: 37.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for cachetools-7.0.6.tar.gz
Algorithm Hash digest
SHA256 e5d524d36d65703a87243a26ff08ad84f73352adbeafb1cde81e207b456aaf24
MD5 d67d90d1c08cadc8fcee3fac9f513f73
BLAKE2b-256 767b1755ed2c6bfabd1d98b37ae73152f8dcf94aa40fee119d163c19ed484704

See more details on using hashes here.

File details

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

File metadata

  • Download URL: cachetools-7.0.6-py3-none-any.whl
  • Upload date:
  • Size: 14.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for cachetools-7.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 4e94956cfdd3086f12042cdd29318f5ced3893014f7d0d059bf3ead3f85b7f8b
MD5 206e4d845046474a6cf57b257c9b4309
BLAKE2b-256 fec4cf76242a5da1410917107ff14551764aa405a5fd10cd10cf9a5ca8fa77f4

See more details on using hashes here.

Supported by

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