XfKDddlZGddZGddeZdS)Nc veZdZdZddefdZdejedefdZde dej fd Z de de fd Z d e dejej fd Zd e deje ej ffd Z dde dej dejedeje fdZdde dej dejede fdZ ddeje ej fdejedejej fdZd e dejej fdZde de fdZde fdZdde dedejefdZdde dedejefdZdS) 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||_dSNr)selfrs A/var/www/piapp/venv/lib/python3.11/site-packages/cachelib/base.py__init__zBaseCache.__init__ s.timeoutreturnc||j}|Srr )r rs r _normalize_timeoutzBaseCache._normalize_timeouts ?*Gr keycdS)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 tr cdS)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.delete tr keysc fd|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. c:g|]}|Sr)r).0kr s r z&BaseCache.get_many..1s#*** ***r rr rs` r get_manyzBaseCache.get_many&s+***T****r cLtt||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 s r get_dictzBaseCache.get_dict3s%CmdmT233444r NvaluecdS)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&rs r setz BaseCache.set?s tr cdS)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.addQs tr mappingcg}|D]1\}}||||r||2|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,rset_keysrr&s r set_manyzBaseCache.set_many`sT!--// % %JCxxUG,, %$$$r chg}|D],}||r||-|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_manyrsG  ) )C{{3 )##C(((r c td)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 cdS)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 deltacj||pd|z}|||r|ndS)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 rr;r&s r incz BaseCache.inc:##!u,e,,6uu$6r cj||pd|z }|||r|ndS)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. rNr=r>s r decz BaseCache.decr@r )rr)r:)__name__ __module__ __qualname____doc__intr _tOptionalrstrAnyrboolrListr!Dictr%r)r+r1r4r7r9r?rBrr r rrs//////"+c*:s srv#$ +c +bgbfo + + + + 5c 5bgc26k&: 5 5 5 5DH!v02 C0@ T $  s 26 BK4D PT     JNwsBF{+68k#6F $        s  t     t 7 7s 73 7r{3/? 7 7 7 7 7 7s 73 7r{3/? 7 7 7 7 7 7r rc"eZdZdZdedefdZdS) 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. rrcdS)NFrrs r r7z NullCache.hassur N)rCrDrErFrJrLr7rr r rPrPs@ str rP)typingrHrrPrr r rSsvj7j7j7j7j7j7j7j7Z r