U 9aP@s"GdddZGdddeZdS)c@seZdZdZd!ddZddZddZd d Zd d Zd dZ d"ddZ d#ddZ d$ddZ ddZ ddZddZd%ddZd&dd ZdS)' BaseCacheaMBaseclass for the cache systems. All the cache systems implement this API or a superset of it. :param default_timeout: the default timeout (in seconds) that is used if no timeout is specified on :meth:`set`. A timeout of 0 indicates that the cache never expires. ,cCs ||_dSNdefault_timeout)selfrr1/tmp/pip-unpacked-wheel-bx08cqbu/cachelib/base.py__init__ szBaseCache.__init__cCs|dkr|j}|Srr)rtimeoutrrr_normalize_timeout szBaseCache._normalize_timeoutcCsdS)zLook up key in the cache and return the value for it. :param key: the key to be looked up. :returns: The value if it exists and is readable, else ``None``. Nrrkeyrrrgetsz BaseCache.getcCsdS)zDelete `key` from the cache. :param key: the key to delete. :returns: Whether the key existed and has been deleted. :rtype: boolean Trr rrrdeleteszBaseCache.deletecsfdd|DS)a<Returns a list of values for the given keys. For each key an item in the list is created:: foo, bar = cache.get_many("foo", "bar") Has the same error handling as :meth:`get`. :param keys: The function accepts multiple keys as positional arguments. csg|]}|qSr)r).0krrr .sz&BaseCache.get_many..rrkeysrrrget_many#s zBaseCache.get_manycGstt||j|S)zLike :meth:`get_many` but return a dict:: d = cache.get_dict("foo", "bar") foo = d["foo"] bar = d["bar"] :param keys: The function accepts multiple keys as positional arguments. )dictziprrrrrget_dict0s zBaseCache.get_dictNcCsdS)akAdd a new key/value to the cache (overwrites value, if key already exists in the cache). :param key: the key to set :param value: the value for the key :param timeout: the cache timeout for the key in seconds (if not specified, it uses the default timeout). A timeout of 0 indicates that the cache never expires. :returns: ``True`` if key has been updated, ``False`` for backend errors. Pickling errors, however, will raise a subclass of ``pickle.PickleError``. :rtype: boolean Trrr valuer rrrset<sz BaseCache.setcCsdS)a Works like :meth:`set` but does not overwrite the values of already existing keys. :param key: the key to set :param value: the value for the key :param timeout: the cache timeout for the key in seconds (if not specified, it uses the default timeout). A timeout of 0 indicates that the cache never expires. :returns: Same as :meth:`set`, but also ``False`` for already existing keys. :rtype: boolean TrrrrraddLs z BaseCache.addcCs,d}|D]\}}||||s d}q |S)aSets multiple keys and values from a mapping. :param mapping: a mapping with the keys/values to set. :param timeout: the cache timeout for the key in seconds (if not specified, it uses the default timeout). A timeout of 0 indicates that the cache never expires. :returns: Whether all given keys have been set. :rtype: boolean TF)itemsr)rmappingr rvr rrrrset_many[s zBaseCache.set_manycstfdd|DS)zDeletes multiple keys at once. :param keys: The function accepts multiple keys as positional arguments. :returns: Whether all given keys have been deleted. :rtype: boolean c3s|]}|VqdSr)r)rr rrr ssz(BaseCache.delete_many..)allrrrr delete_manykszBaseCache.delete_manycCs tddS)a Checks if a key exists in the cache without returning it. This is a cheap operation that bypasses loading the actual data on the backend. This method is optional and may not be implemented on all caches. :param key: the key to check z%s doesn't have an efficient implementation of `has`. That means it is impossible to check whether a key exists without fully loading the key's data. Consider using `self.get` explicitly if you don't care about performance.N)NotImplementedErrorr rrrhasusz BaseCache.hascCsdS)zClears the cache. Keep in mind that not all caches support completely clearing the cache. :returns: Whether the cache has been cleared. :rtype: boolean TrrrrrclearszBaseCache.clearcCs&||p d|}|||r"|SdS)aHIncrements the value of a key by `delta`. If the key does not yet exist it is initialized with `delta`. For supporting caches this is an atomic operation. :param key: the key to increment. :param delta: the delta to add. :returns: The new value or ``None`` for backend errors. Nrrrr deltarrrrincs z BaseCache.inccCs&||p d|}|||r"|SdS)aLDecrements the value of a key by `delta`. If the key does not yet exist it is initialized with `-delta`. For supporting caches this is an atomic operation. :param key: the key to increment. :param delta: the delta to subtract. :returns: The new value or `None` for backend errors. r)Nr*r+rrrdecs z BaseCache.dec)r)N)N)N)r()r()__name__ __module__ __qualname____doc__r r rrrrrrr!r$r&r'r-r.rrrrrs        rc@seZdZdZddZdS) NullCachezA cache that doesn't cache. This can be useful for unit testing. :param default_timeout: a dummy parameter that is ignored but exists for API compatibility with other caches. cCsdS)NFrr rrrr&sz NullCache.hasN)r/r0r1r2r&rrrrr3sr3N)rr3rrrrs(