3 de9@s*ddlZGdddZGdddeZdS)Nc@sfeZdZdZd)edddZejeedddZe ej d d d Z e e d d d Z e ejej dddZe eje ej fdddZd*e ej ejeeje dddZd+e ej ejee dddZd,eje ej fejeejej dddZe ejej dddZe e d ddZe d d!d"Zd-e eejed$d%d&Zd.e eejed$d'd(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. ,)default_timeoutcCs ||_dS)N)r)selfrrD/var/www/agendate/envp3/lib/python3.6/site-packages/cachelib/base.py__init__ szBaseCache.__init__)timeoutreturncCs|dkr|j}|S)N)r)rr rrr_normalize_timeoutszBaseCache._normalize_timeout)keyr cCsdS)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``. Nr)rr rrrgetsz BaseCache.getcCsdS)zDelete `key` from the cache. :param key: the key to delete. :returns: Whether the key existed and has been deleted. :rtype: boolean Tr)rr rrrdeleteszBaseCache.delete)keysr csfdd|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|]}j|qSr)r ).0k)rrr 1sz&BaseCache.get_many..r)rrr)rrget_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. )dictzipr)rrrrrget_dict3s zBaseCache.get_dictN)r valuer r cCsdS)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 Tr)rr rr 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 Tr)rr rr rrraddQs z BaseCache.add)mappingr r cCs6g}x,|jD] \}}|j|||r|j|qW|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: A list containing all keys sucessfuly set :rtype: boolean )itemsrappend)rrr Zset_keysr rrrrset_many`s zBaseCache.set_manycGs*g}x |D]}|j|r |j|q W|S)zDeletes multiple keys at once. :param keys: The function accepts multiple keys as positional arguments. :returns: A list containing all sucessfuly deleted keys :rtype: boolean )rr)rrZ deleted_keysr rrr delete_manyrs   zBaseCache.delete_manycCs tddS)zChecks if a key exists in the cache without returning it. This is a cheap operation that bypasses loading the actual data on the backend. :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)NotImplementedError)rr rrrhassz BaseCache.has)r cCsdS)zClears the cache. Keep in mind that not all caches support completely clearing the cache. :returns: Whether the cache has been cleared. :rtype: boolean Tr)rrrrclearszBaseCache.clear)r deltar cCs&|j|p d|}|j||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. rN)r r)rr r#rrrrincs z BaseCache.inccCs&|j|p d|}|j||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. rN)r r)rr r#rrrrdecs z BaseCache.dec)r)N)N)N)r")r")__name__ __module__ __qualname____doc__intr_tOptionalr strAnyr boolrListrDictrrrrrr r!r$r%rrrrrs"      rc@s eZdZdZeedddZdS) 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. )r r cCsdS)NFr)rr rrrr sz NullCache.hasN)r&r'r(r)r-r/r rrrrr2sr2)typingr+rr2rrrrs.