NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →

PackageTrack. Know what changed before it breaks something.

About Terms of Service Privacy Policy

PyPI · #1336 most downloaded on PyPI

cachelib

0.17.08.0M downloads/mopallets-eco/cachelib ↗New releases in your daily digest, changelog included.

A collection of cache libraries in the same API interface.

Last release 1 months ago
24 Aug 2026
Ships unpredictably
gaps range from 8 days to 2.1 years
Nearly every release is documented
notes for 25 of 26 stable releases
Nothing withdrawn
no release was ever pulled
8 years old
26 releases · first in 2018

Release timeline

26 releases since 2018

20182020202220242026

Releases

0.17.024 Aug 2026Breaking3 sources agree
…add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all depe…
This is CacheLib's 0.17.0 feature release. A feature release may include new features, remove previously deprecated code, add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all dependencies and control upgrades. Test with warnings treated as errors to be able to adapt to deprecation warnings early.

PyPI: https://pypi.org/project/CacheLib/0.17.0/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.17.0
Milestone: https://github.com/pallets-eco/cachelib/milestone/4?closed=1

Timeout now also accepts a datetime.timedelta in addition to int. #510

Float timeouts are deprecated and now rounded up to whole seconds, so
backends with integer-second APIs (e.g. memcached) no longer fail with
a confusing TypeError. Passing a float will raise a TypeError
in a future release; timeouts of any other unsupported type raise
TypeError immediately. #510

Add memcache_client_lib parameter to MemcachedCache to select which
memcache client library to use (pylibmc, google, memcache, or
libmc). When not set, the library is auto-detected as before. #511

Full Changelog: 0.16.1...0.17.0

20182026

One column per quarter.

Open source →

▸▾0.16.121 Aug 2026Breaking

This is CacheLib's 0.16.1 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to t…

This is CacheLib's 0.16.1 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to the latest feature release.

PyPI: https://pypi.org/project/CacheLib/0.16.1/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.16.1

Add check_connection parameter to allow users to control whether
the constructor will attempt to ping the client on init. #508

Full Changelog: 0.16.0...0.16.1

Open source →

Additional notes2 sources agree

Released 2026-08-21

Add check_connection parameter to allow users to control whether the constructor will attempt to ping the client on init. 508

Open source →

▸▾0.16.020 Aug 2026Breaking3 sources agree

…add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all depe…

This is CacheLib's 0.16.0 feature release. A feature release may include new features, remove previously deprecated code, add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all dependencies and control upgrades. Test with warnings treated as errors to be able to adapt to deprecation warnings early.

PyPI: https://pypi.org/project/CacheLib/0.16.0/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.16.0
Milestone: https://github.com/pallets-eco/cachelib/milestone/3?closed=1

Change FileSystemCache default hash method to hashlib.sha256
because hashlib.md5 is not available in FIPs builds. #500
Ping backends servers on init to ensure they are reachable. #503
Fix Memcached with python-memcached client returned None
instead of True when flush_all was successful. #504
Add ignore_delete_many_errors parameter to all cache backends to allow
users to control whether delete_many() raises a RuntimeError if any key fails to delete. #505

Full Changelog: 0.15.4...0.16.0

Open source →

▸▾0.15.48 Aug 2026Breaking

This is CacheLib's 0.15.4 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to t…

This is CacheLib's 0.15.4 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to the latest feature release.

PyPI: https://pypi.org/project/CacheLib/0.15.4/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.15.4

Fix dumps in RedisCache to not use pickle for integers, so they remain compatible with the native INCRBY/ DECRBY operations used by inc / dec. #497

Full Changelog: 0.15.3...0.15.4

Open source →

Additional notes2 sources agree

Released 2026-08-08

Fix dumps in RedisCache to not use pickle for integers, so they remain compatible with the native INCRBY/ DECRBY operations used by inc/dec. 497

Open source →

▸▾0.15.38 Aug 2026Breaking

This is CacheLib's 0.15.3 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to t…

This is CacheLib's 0.15.3 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to the latest feature release.

PyPI: https://pypi.org/project/CacheLib/0.15.3/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.15.3

Fix MemcachedCache inc and dec methods double normalizing keys. #495

Full Changelog: 0.15.2...0.15.3

Open source →

Additional notes2 sources agree

Released 2026-08-08

Fix MemcachedCache inc and dec methods double normalizing keys. 495

Open source →

▸▾0.15.27 Aug 2026Breaking

This is CacheLib's 0.15.2 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to t…

This is CacheLib's 0.15.2 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to the latest feature release.

PyPI: https://pypi.org/project/CacheLib/0.15.2/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.15.2

Fix libmc in MemcachedCache no reserve nor blocking. #493

Full Changelog: 0.15.1...0.15.2

Open source →

Additional notes2 sources agree

Released 2026-08-07

Fix libmc in MemcachedCache no reserve nor blocking. 493

Open source →

▸▾0.15.17 Aug 2026Breaking

This is CacheLib's 0.15.1 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to t…

This is CacheLib's 0.15.1 fix release, which fixes bugs but does not otherwise change behavior and should not result in breaking changes compared to the latest feature release.

PyPI: https://pypi.org/project/CacheLib/0.15.1/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.15.1

Add JSONSerializer serializer and use the same base class for DynamoDB serialization. #490
Fix MemcachedCache libmc client not being created correctly #491

Full Changelog: 0.15.0...0.15.1

Open source →

Additional notes2 sources agree

Released 2026-08-07

Add JSONSerializer serializer and use the same base class for DynamoDB serialization. 490
Fix MemcachedCache libmc client not being created correctly 491

Open source →

▸▾0.15.030 Jul 2026Breaking3 sources agree

…add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all depe…

This is CacheLib's 0.15.0 feature release. A feature release may include new features, remove previously deprecated code, add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all dependencies and control upgrades. Test with warnings treated as errors to be able to adapt to deprecation warnings early.

PyPI: https://pypi.org/project/CacheLib/0.15.0/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.15.0
Milestone: https://github.com/pallets-eco/cachelib/milestone/2?closed=1

Make SimpleCache thread-safe using a threading.RLock. #446
Make pylibmc and libmc clients thread-safe by using ClientPool. #287
Drop support for Python 3.8, 3.9 and 3.10. #477
Add support for optional dependencies in pyproject.toml to allow users to
install the dependencies for specific cache backends as needed. #432

Full Changelog: 0.14.0...0.15.0

Open source →

▸▾0.14.09 May 2026Breaking

…add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all depe…

This is the CacheLib 0.14.0 feature and fix release. A feature release may include new features, remove previously deprecated code, add new deprecations, or introduce potentially breaking changes. We encourage everyone to upgrade, and to use a tool such as pip-tools to pin all dependencies and control upgrades. Test with warnings treated as errors to be able to adapt to deprecation warnings early.

PyPI: https://pypi.org/project/CacheLib/0.14.0/
Changes: https://cachelib.readthedocs.io/en/stable/changes/#version-0.14.0
Milestone: https://github.com/pallets-eco/cachelib/milestone/1?closed=1

Features

Add valkey backend based on redis. #441

Issues

Replace deprecated datetime.utcnow() with datetime.now(). #421
Fix FileSystemCache permission errors on Network Attached Storage (NAS) when trying to perform operations on files that are open in other processes. #424
Fix serializer returning an unbound variable error instead of None when a pickle error is raised during serialization. #448
Fix add() in SimpleCache treating expired keys as still valid, preventing them from being overwritten until explicitly deleted. #449
Fix delete_many() in RedisCache and MemcachedCache incorrectly reporting failed deletions due to comparing normalized keys against non-normalized keys. #443

Documentation

Add quickstart example. #430
Add installation page. #431

Code Changes

remove ruff's UP038 and pin boto3. #445
refresh project layout. #420

Full Changelog: 0.13.0...0.14.0

Open source →

Additional notes2 sources agree

Released 2026-05-09

Improve typing and refresh project to use pyproject and pallets workflows 420
Replace deprecated datetime.utcnow() with datetime.now() 421
Fix FileSystemCache permission errors on Network Attached Storage (NAS) when trying to perform operations on files that are open in other processes 424
Fix delete_many() in RedisCache and MemcachedCache incorrectly reporting failed deletions due to comparing normalized keys against non-normalized keys 443
Fix serializer returning an unbound variable error instead of None when a pickle error is raised during serialization 448
Fix add() in SimpleCache treating expired keys as still valid, preventing them from being overwritten until explicitly deleted 449
Add valkey backend 441

Open source →

▸▾0.13.013 Apr 2024

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2024-04-13

default ~hashlib.md5 may not be available in FIPS builds. We now do not access it at import time on FileSystemCache so developers have time to change the default. ~hashlib.md5 will be lazy loaded when a new default is not provided

Open source →

▸▾0.12.011 Feb 2024

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2024-02-11

RedisCache now supports callables as keys
Added MongoDB as a cache backend

Open source →

▸▾0.11.010 Feb 2024

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2024-02-10

Drop python 3.7 support
Add python 3.11 support

Open source →

▸▾0.10.231 Jan 2023

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2023-01-31

Fix broken release

Open source →

▸▾0.10.122 Jan 2023

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2023-01-22

Fix logging pollution due to DynamoDB logging handler

Open source →

▸▾0.10.010 Jan 2023

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2023-01-22

Improve error message when FileSystemCache methods are called with non-string keys. 170
Added DynamoDb as a cache backend 209

Open source →

▸▾0.9.026 Jun 2022

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2022-06-26

Add separate internal read/write clients to RedisCache to improve compatibility with flask-caching. 159
Fix bug where cache entries would expire immediately when RedisCache.add was called without timeout. 157
Improve FileSystemCache.set compatibility with Windows systems. 158

Open source →

▸▾0.8.014 Jun 2022

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2022-06-13

Remove deprecated RedisCache.load_object and RedisCache.dump_object. 147

Open source →

▸▾0.7.014 May 2022

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2022-05-14

FileSystemCache now stores universal expiration timestamps using python's struct module. 126
Drop support for Python 3.6. 134

Open source →

▸▾0.6.018 Jan 2022

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2022-01-18

A custom hash_method may now be provided to FileSystemCache for hashing keys. 107
Fix PermissionError issue with FileSystemCache on Windows. 111

Open source →

▸▾0.5.031 Dec 2021

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2021-12-31

Cache types now have configurable serializers. 63

Open source →

▸▾0.4.14 Oct 2021

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2021-10-04

Fix break in RedisCache when a host object was passed in RedisCache.host instead of a string. 82

Open source →

▸▾0.4.04 Oct 2021

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2021-10-03

All cache types now implement BaseCache interface both in behavior and method return types. Thus, code written for one cache type should work with any other cache type. 71
Add type information for static typing tools. 48
FileNotFound exceptions will not be logged anymore in FileSystemCache methods in order to avoid polluting application log files. 69

Open source →

▸▾0.3.012 Aug 2021

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2021-08-12

Optimize FileSystemCache pruning. 52
Fix a bug in FileSystemCache where entries would not be removed when the total was over the threshold, and the entry count would be lost. 52
FileSystemCache logs system-related exceptions. 51
Removal of expired entries in FileSystemCache is only triggered if the number of entries is over the threshold when calling set. get has still return None and False respectively for expired entries, but will not remove the files. All removals happen at pruning time or explicitly with clear and delete. 53

Open source →

▸▾0.2.025 Jun 2021

https://cachelib.readthedocs.io/en/stable/changes/

https://cachelib.readthedocs.io/en/stable/changes/

Open source →

Additional notes2 sources agree

Released 2021-06-25

Support for Python 2 has been dropped. Only Python 3.6 and above are supported.
Fix FileSystemCache.set incorrectly considering value overrides on existing keys as new cache entries. 18
SimpleCache and FileSystemCache first remove expired entries, followed by older entries, when cleaning up. 26
Fix problem where file count was not being updated in FileSystemCache.get and FileSystemCache.has after removals. 20
When attempting to access non-existent entries with Memcached, these will now be initialized with a given value delta. 31

Open source →

▸▾0.1.120 Jun 2020

Fix FileSystemCache on Windows #12

Fix FileSystemCache on Windows #12

Open source →

Additional notes

Released 2020-06-20

Fix FileSystemCache on Windows.

Open source →

Additional notes

Released 2020-06-20

Fix FileSystemCache on Windows.

Contents

Changes
Version 0.17.0
Version 0.16.1
Version 0.16.0
Version 0.15.4
Version 0.15.3
Version 0.15.2
Version 0.15.1
Version 0.15.0
Version 0.14.0
Version 0.13.0
Version 0.12.0
Version 0.11.0
Version 0.10.2
Version 0.10.1
Version 0.10.0
Version 0.9.0
Version 0.8.0
Version 0.7.0
Version 0.6.0
Version 0.5.0
Version 0.4.1
Version 0.4.0
Version 0.3.0
Version 0.2.0
Version 0.1.1

Navigation

Overview
Previous: BSD-3-Clause License

Quick search

© Copyright 2018 Pallets. Created using Sphinx 9.1.0.

Open source →

▸▾0.128 Nov 2018

Nothing published for this version

Your coding agent can read these notes before it upgrades. Set up the MCP server →