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 expiringdictIf you wish to download the source and install from GitHub:
git clone git@github.com:mailgun/expiringdict.git
python setup.py installor 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=expiringdictCreate 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"
cache.get("key")copy from dict or OrderedDict:
from expiringdict import ExpiringDict
my_dict=dict()
my_dict['test'] = 1
cache = ExpiringDict(max_len=100, max_age_seconds=10, items=my_dict)
assert cache['test'] == 1copy from another ExpiringDict, with or without new length and timeout:
from expiringdict import ExpiringDict
cache_hour = ExpiringDict(max_len=100, max_age_seconds=3600)
cache_hour['test'] = 1
cache_hour_copy = ExpiringDict(max_len=None, max_age_seconds=None, items=cache_hour)
cache_minute_copy = ExpiringDict(max_len=None, max_age_seconds=60, items=cache_hour)
assert cache_minute_copy['test'] == 1pickle :
import dill
from expiringdict import ExpiringDict
cache = ExpiringDict(max_len=100, max_age_seconds=10)
cache['test'] = 1
pickled_cache = dill.dumps(cache)
unpickled_cache = dill.loads(cache)
assert unpickled_cache['test'] == 1