skip to navigation
skip to content

Not Logged In

expiringdict 1.1

Dictionary with auto-expiring values for caching purposes

Latest Version: 1.1.3


expiringdict is a Python caching library. The core of the library is ExpiringDict class which is an ordered dictionary with auto-expiring values for caching purposes. Expiration happens on any access, object is locked during cleanup from expired values. ExpiringDict can not store more than max_len elements - the oldest will be deleted.

Note: Iteration over dict and also keys() do not remove expired values!


If you wish to install from PyPi:

pip install expiringdict

If you wish to download the source and install from GitHub:

git clone
python install

or to install with test dependencies (Nose, Mock, coverage) run from the directory above:

pip install -e expiringdict[test]

To run tests with coverage:

nosetests --with-coverage --cover-package=expiringdict


Create a dictionary with capacity for 100 elements and elements expiring in 10 seconds:

from expiringdict import ExpiringDict
cache = ExpiringDict(max_len=100, max_age_seconds=10)

put and get a value there:

cache["key"] = "value"
File Type Py Version Uploaded on Size
expiringdict-1.1.tar.gz (md5) Source 2014-02-20 2KB
  • Downloads (All Versions):
  • 248 downloads in the last day
  • 1844 downloads in the last week
  • 7905 downloads in the last month