darts.util.lru Simple dictionary with LRU behavior
Download

darts.util.lru Ranking & Summary

darts.util.lru Tags

Python dictionary LRU Python dictionary LRU behavior

darts.util.lru Description

Simple dictionary with LRU behavior darts.util.lru is a simple dictionary with LRU behavior.LRU Dictionaries >>> from darts.lib.utils.lru import LRUDictAn LRUDict is basically a simple dictionary, which has a defined maximum capacity, that may be supplied at construction time, or modified at run-time via the capacity property:>>> cache = LRUDict(1)>>> cache.capacity1The minimum capacity value is 1, and LRU dicts will complain, if someone attempts to use a value smaller than that:>>> cache.capacity = -1 #doctest: +ELLIPSISTraceback (most recent call last):...ValueError: -1 is not a valid capacity>>> LRUDict(-1) #doctest: +ELLIPSISTraceback (most recent call last):...ValueError: -1 is not a valid capacityLRU dictionaries can never contain more elements than their capacity value indicates, so:>>> cache = "First">>> cache = "Second">>> len(cache)1In order to ensure this behaviour, the dictionary will evict entries if it needs to make room for new ones. So:>>> 1 in cacheFalse>>> 2 in cacheTrueThe capacity can be adjusted at run-time. Growing the capacity does not affect the number of elements present in an LRU dictionary:>>> cache.capacity = 3>>> len(cache)1>>> cache = "First">>> cache = "Third">>> len(cache)3but shrinking does:>>> cache.capacity = 2>>> len(cache)2>>> sorted(list(cache.iterkeys()))Note, that the entry with key 2 was evicted, because it was the oldest entry at the time of the modification of capacity. The new oldest entry is the one with key 1, which can be seen, when we try to add another entry to the dict:>>> cache = "Fourth">>> sorted(list(cache.iterkeys()))The following operations affect an entry's priority:- `get`- `__getitem__`- `__setitem__`- `__contains__`Calling any of these operations on an existing key will boost the key's priority, making it more unlikely to get evicted, when the dictionary needs to make room for new entries. There is a special peek operation, which returns the current value associated to a key without boosting the priority of the entry:>>> cache.peek(3)'Third'>>> cache = "Fifth">>> sorted(list(cache.iterkeys()))As you can see, even though we accessed the entry with key 3 as the last one, the entry is now gone, because it did not get a priority boost from the call to peek.The class LRUDict supports a subset of the standard Python dict interface. In particular, we can iterate over the key, values, and items of an LRU dict:>>> sorted()>>> sorted()>>> sorted()>>> sorted(list(cache))Note, that there is no guaranteed order; in particular, the elements are not generated in priority order or somesuch. Similar to regular dict`s, an LRU dict's `__iter__ is actually any alias for iterkeys.Furthermore, we can remove all elements from the dict: >>> cache.clear() >>> sorted(list(cache.iterkeys())) []Thread-safetyInstances of class LRUDict are not thread safe. Worse: even concurrent read-only access is not thread-safe and has to be synchronized by the client application.Auto-loading Caches >>> from darts.lib.utils.lru import AutoLRUCacheLet's first define a load function:>>> def load_resource(key):... if key < 10:... print "Loading %r" % (key,)... return "R(%s)" % (key,)and a cache:>>> cache = AutoLRUCache(load_resource, capacity=3)>>> cache.load(1)Loading 1'R(1)'>>> cache.load(1)'R(1)'As you can see, the first time, an actual element is loaded, the load function provided to the constructor is called, in order to provide the actual resource value. On subsequent calls to load, the cached value is returned.Internally, the AutoLRUCache class uses an LRUDict to cache values, so:>>> cache.load(2)Loading 2'R(2)'>>> cache.load(3)Loading 3'R(3)'>>> cache.load(4)Loading 4'R(4)'>>> cache.load(1)Loading 1'R(1)'Note the "Loading 1" line in the last example. The cache has been initialized with a capacity of 3, so the value of key 1 had to be evicted when the one for key 4 was loaded. When we tried to obtain 1 again, the cache had to properly reload it, calling the loader function.If there is actually no resource for a given key value, the loader function must return None. It follows, that None is never a valid resource value to be associated with some key in an AutoLRUCache. >>> cache.load(11, 'Oops') 'Oops'Thread-safetyInstances of class AutoLRUCache are fully thread safe. Be warned, though, that the loader function is called outside of any synchronization scope the class may internally use, and has to provide its own synchronization if required.The cache class actually tries to minimize the number of invocations of the loader by making sure, that no two concurrent threads will try to load the same key value (though any number of concurrent threads might be busy loading the resources associated with different keys). Requirements: · Python

darts.util.lru Related Software