NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #127 most downloaded on PyPI
Extensible memoizing collections and decorators
Latest stable
8.0.2
Last release today
18 Nov 2026
Release timing varies
gaps range from 9 days to 2 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
13 years old
91 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Document how to use shared caches with @cachedmethod.
Document how to use shared caches with @cachedmethod.
Fix pickling/unpickling of cache keys.
Fix Python 3.8 compatibility issue.
Fix Python 3.8 compatibility issue.
Use time.monotonic as default timer if available.
Improve documentation regarding thread safety.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Drop Python 3.3 support (breaking change).
Officially support Python 3.7.
Drop Python 3.3 support (breaking change).
Remove missing cache constructor parameter (breaking change).
Remove self from @cachedmethod key arguments (breaking change).
Add support for maxsize=None in cachetools.func decorators.
Deprecate missing cache constructor parameter.
Deprecate missing cache constructor parameter.
Handle overridden getsizeof() method in subclasses.
Fix Python 2.7 RRCache pickling issues.
Various documentation improvements.
Documentation: Update import paths for key functions (courtesy of slavkoja).
Officially support Python 3.6.
Move documentation to RTD.
Documentation: Update import paths for key functions (courtesy of slavkoja).
Drop Python 3.2 support (breaking change).
Drop Python 3.2 support (breaking change).
Drop support for deprecated features (breaking change).
Move key functions to separate package (breaking change).
Accept non-integer maxsize in Cache.__repr__().
Reimplement LRUCache and TTLCache using collections.OrderedDict. Note that this will break pickle compatibility with previous versions.
Reimplement LRUCache and TTLCache using collections.OrderedDict. Note that this will break pickle compatibility with previous versions.
Fix TTLCache not calling __missing__() of derived classes.
Handle ValueError in Cache.__missing__() for consistency with caching decorators.
Improve how TTLCache handles expired items.
Use Counter.most_common() for LFUCache.popitem().
Refactor Cache base class. Note that this will break pickle compatibility with previous versions.
Refactor Cache base class. Note that this will break pickle compatibility with previous versions.
Clean up LRUCache and TTLCache implementations.
Document pending removal of deprecated features.
Refactor LRUCache and TTLCache implementations. Note that this will break pickle compatibility with previous versions.
Document pending removal of deprecated features.
Minor documentation improvements.
- Fix pickle tests.
Fix pickle tests.
Fix pickling of large LRUCache and TTLCache instances.
Fix pickling of large LRUCache and TTLCache instances.
- Improve key functions. - Improve documentation. - Improve unit test coverage.
Improve key functions.
Improve documentation.
Improve unit test coverage.
Deprecate @cachedmethod typed argument.
Add @cached function decorator.
Add hashkey and typedkey functions.
Add key and lock arguments to @cachedmethod.
Set __wrapped__ attributes for Python versions < 3.2.
Move functools compatible decorators to cachetools.func.
Deprecate @cachedmethod typed argument.
Deprecate cache attribute for @cachedmethod wrappers.
Deprecate getsizeof and lock arguments for cachetools.func decorator.
Clear cache statistics when calling clear_cache().
Clear cache statistics when calling clear_cache().
Allow simple cache instances to be pickled.
Allow simple cache instances to be pickled.
Refactor Cache.getsizeof and Cache.missing default implementation.
Code cleanup for improved PEP 8 conformance.
Code cleanup for improved PEP 8 conformance.
Add documentation and unit tests for using @cachedmethod with generic mutable mappings.
Improve documentation.
Provide RRCache.choice property.
Provide RRCache.choice property.
Improve documentation.
Use a NestedTimer for TTLCache.
Use a NestedTimer for TTLCache.
- Deprecate Cache.getsize().
Deprecate Cache.getsize().
Ignore ValueError raised on cache insertion in decorators.
Ignore ValueError raised on cache insertion in decorators.
Add Cache.getsize().
Add Cache.__missing__().
Feature freeze for v1.0.
- Fix MANIFEST.in.
Fix MANIFEST.in.
Deprecate TTLCache.ExpiredError.
Deprecate TTLCache.ExpiredError.
Add choice argument to RRCache constructor.
Refactor LFUCache, LRUCache and TTLCache.
Use custom NullContext implementation for unsynchronized function decorators.
Raise TTLCache.ExpiredError for expired TTLCache items.
Raise TTLCache.ExpiredError for expired TTLCache items.
Support unsynchronized function decorators.
Allow @cachedmethod.cache() to return None.
No formatting of KeyError arguments.
No formatting of KeyError arguments.
Update README.rst.
Do not delete expired items in TTLCache.__getitem__().
Do not delete expired items in TTLCache.__getitem__().
Add @ttl_cache function decorator.
Fix public getsizeof() usage.
Remove @cachedmethod lock parameter.
Add TTLCache.
Add Cache base class.
Remove @cachedmethod lock parameter.
Add proper locking for cache_clear() and cache_info().
Add proper locking for cache_clear() and cache_info().
Report size in cache_info().
- Remove @cache decorator. - Add size, getsizeof members. - Add @cachedmethod decorator.
Remove @cache decorator.
Add size, getsizeof members.
Add @cachedmethod decorator.
- Add @cache decorator. - Update documentation.
Add @cache decorator.
Update documentation.
- Initial release.
Initial release.
Nothing published for this version
One column per quarter.