ՋgK6ddlZGddZGddeZy)Nc eZdZdZddefdZdejedefdZde dejfdZ de de fd Z d e dejejfd Zd e dej e ejffd Z dde dejdejedeje fdZdde dejdejede fdZ ddej e ejfdejedejejfdZd e dejejfdZde de fdZde fdZdde dedejefdZdde dedejefdZy ) 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_timeoutc||_yNr)selfrs @/var/www/html/venv/lib/python3.12/site-packages/cachelib/base.py__init__zBaseCache.__init__ s .timeoutreturnc"| |j}|Srr)r r s r _normalize_timeoutzBaseCache._normalize_timeouts ?**Gr keycy)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 rs r getz BaseCache.gets r cy)zDelete `key` from the cache. :param key: the key to delete. :returns: Whether the key existed and has been deleted. :rtype: boolean Trrs r deletezBaseCache.deleter keyscJ|Dcgc]}|j|c}Scc}w)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. )r)r rks r get_manyzBaseCache.get_many&s &** ***s cFtt||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)r rs r get_dictzBaseCache.get_dict3s!CmdmmT2344r Nvaluecy)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 Trr rr!r s r setz BaseCache.set?s r cy)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 Trr#s r addz BaseCache.addQsr mappingcg}|jD]*\}}|j|||s|j|,|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 successfully set :rtype: boolean )itemsr$append)r r'r set_keysrr!s r set_manyzBaseCache.set_many`sE!--/ %JCxxUG,$ %r c^g}|D]%}|j|s|j|'|S)zDeletes multiple keys at once. :param keys: The function accepts multiple keys as positional arguments. :returns: A list containing all successfully deleted keys :rtype: boolean )rr*)r r deleted_keysrs r delete_manyzBaseCache.delete_manyrs:  )C{{3##C( )r ctd)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.)NotImplementedErrorrs r hasz BaseCache.hass " >  r cy)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)r s r clearzBaseCache.clearrr deltac^|j|xsd|z}|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. rNrr$r rr5r!s r incz BaseCache.inc3##!u,e,u6$6r c^|j|xsd|z }|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. rNr7r8s r decz BaseCache.decr:r )i,r))__name__ __module__ __qualname____doc__intr _tOptionalrstrAnyrboolrListrDictr r$r&r,r/r2r4r9r<rr r rrs//"++c*:s srvv#$ +c +bggbffo + 5c 5bggc266k&: 5DH!vv02 C0@ T $ s 266 BKK4D PT  JNwwsBFF{+68kk#6F $     s  t  t 7s 73 7r{{3/? 7 7s 73 7r{{3/? 7r rc eZdZdZdedefdZy) 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. rrcy)NFrrs r r2z NullCache.hassr N)r>r?r@rArErGr2rr r rKrKs str rK)typingrCrrKrr r rNs!j7j7Z r