sg>~dZddlmZddlmZ ddlmZddlmZm Z m Z ddl m Z Gd d eZ y #e$rdZY%wxYw) -Django-compatible disk and file backed cache.)wraps) BaseCache)DEFAULT_TIMEOUTi,)ENOVAL args_to_key full_name) FanoutCacheceZdZdZfdZedZdZddZdZ e dddd fd Z d d Z dd Z e dddd fd Ze dd fdZ d!dZd"dZd#dZd#dZddZdZd$dZdZdZdZdZdZdZe fdZde ddddfdZxZS)% DjangoCacherct|||jdd}|jdd}|jdi}t|||fi||_y)zInitialize DjangoCache instance. :param str directory: cache directory :param dict params: cache parameters SHARDSDATABASE_TIMEOUTg{Gz?OPTIONSN)super__init__getr _cache)self directoryparamsshardstimeoutoptions __class__s H/var/www/html/venv/lib/python3.12/site-packages/diskcache/djangocache.pyrzDjangoCache.__init__sX  Ha(**/7**Y+!)VWHH c.|jjS)zCache directory.)rrrs rrzDjangoCache.directory!s{{$$$rc8|jj|S)zReturn Cache with given `name` in subdirectory. :param str name: subdirectory name for Cache :return: Cache with given name )rcachernames rr#zDjangoCache.cache&{{  &&rNc<|jj||S)zReturn Deque with given `name` in subdirectory. :param str name: subdirectory name for Deque :param maxlen: max length (default None, no max) :return: Deque with given name )maxlen)rdeque)rr%r(s rr)zDjangoCache.deque/s{{  f 55rc8|jj|S)zReturn Index with given `name` in subdirectory. :param str name: subdirectory name for Index :return: Index with given name )rindexr$s rr+zDjangoCache.index9r&rFTc|j||}|j|}|jj||||||S)aSet a value in the cache if the key does not already exist. If timeout is given, that timeout will be used for the key; otherwise the default cache timeout will be used. Return True if the value was stored, False otherwise. :param key: key for item :param value: value for item :param float timeout: seconds until the item expires (default 300 seconds) :param int version: key version number (default None, cache parameter) :param bool read: read value as bytes from file (default False) :param str tag: text to associate with key (default None) :param bool retry: retry if database timeout occurs (default True) :return: True if item was added versionr)make_keyget_backend_timeoutraddrkeyvaluerr.readtagretrys rr2zDjangoCache.addBsF8mmCm1**7*;{{sE7D#uEErch|j||}|jj||||||S)aFetch a given key from the cache. If the key does not exist, return default, which itself defaults to None. :param key: key for item :param default: return value if key is missing (default None) :param int version: key version number (default None, cache parameter) :param bool read: if True, return file handle to value (default False) :param float expire_time: if True, return expire_time in tuple (default False) :param tag: if True, return tag in tuple (default False) :param bool retry: retry if database timeout occurs (default False) :return: value for item if key is found else default r-)r0rr)rr4defaultr.r6 expire_timer7r8s rrzDjangoCache.getbs34mmCm1{{sGT;UKKrc^|j||}|jj|S)aReturn file handle corresponding to `key` from Cache. :param key: Python key to retrieve :param int version: key version number (default None, cache parameter) :return: file open for reading in binary mode :raises KeyError: if key is not found r-)r0rr6rr4r.s rr6zDjangoCache.reads+mmCm1{{$$rc|j||}|j|}|jj||||||S)aSet a value in the cache. If timeout is given, that timeout will be used for the key; otherwise the default cache timeout will be used. :param key: key for item :param value: value for item :param float timeout: seconds until the item expires (default 300 seconds) :param int version: key version number (default None, cache parameter) :param bool read: read value as bytes from file (default False) :param str tag: text to associate with key (default None) :param bool retry: retry if database timeout occurs (default True) :return: True if item was set r-r/)r0r1rsetr3s rr?zDjangoCache.setsF2mmCm1**7*;{{sE7D#uEErc|j||}|j|}|jj|||S)aTouch a key in the cache. If timeout is given, that timeout will be used for the key; otherwise the default cache timeout will be used. :param key: key for item :param float timeout: seconds until the item expires (default 300 seconds) :param int version: key version number (default None, cache parameter) :param bool retry: retry if database timeout occurs (default True) :return: True if key was touched r-r/)r0r1rtouch)rr4rr.r8s rrAzDjangoCache.touchsBmmCm1**7*;{{  gu55rcf|j||}|jj|||||S)aRemove corresponding item for `key` from cache and return value. If `key` is missing, return `default`. Operation is atomic. Concurrent operations will be serialized. :param key: key for item :param default: return value if key is missing (default None) :param int version: key version number (default None, cache parameter) :param float expire_time: if True, return expire_time in tuple (default False) :param tag: if True, return tag in tuple (default False) :param bool retry: retry if database timeout occurs (default True) :return: value for item if key is found else default r-)r0rpop)rr4r:r.r;r7r8s rrCzDjangoCache.pops12mmCm1{{sG[#uEErc`|j||}|jj||S)aDelete a key from the cache, failing silently. :param key: key for item :param int version: key version number (default None, cache parameter) :param bool retry: retry if database timeout occurs (default True) :return: True if item was deleted r-)r0rdelete)rr4r.r8s rrEzDjangoCache.deletes-mmCm1{{!!#u--rc|j||} |jj||||S#t$rt d|zdwxYw)aIncrement value by delta for item with key. If key is missing and default is None then raise KeyError. Else if key is missing and default is not None then use default for value. Operation is atomic. All concurrent increment operations will be counted individually. Assumes value may be stored in a SQLite column. Most builds that target machines with 64-bit pointer widths will support 64-bit signed integers. :param key: key for item :param int delta: amount to increment (default 1) :param int version: key version number (default None, cache parameter) :param int default: value if key is missing (default None) :param bool retry: retry if database timeout occurs (default True) :return: new value for item on success else None :raises ValueError: if key is not found and default is None r-zKey '%s' not foundN)r0rincrKeyError ValueErrorrr4deltar.r:r8s rrGzDjangoCache.incrs[.mmCm1 C;;##C? ? C1C78d B Cs 3A c.|j|| |||S)aDecrement value by delta for item with key. If key is missing and default is None then raise KeyError. Else if key is missing and default is not None then use default for value. Operation is atomic. All concurrent decrement operations will be counted individually. Unlike Memcached, negative values are supported. Value may be decremented below zero. Assumes value may be stored in a SQLite column. Most builds that target machines with 64-bit pointer widths will support 64-bit signed integers. :param key: key for item :param int delta: amount to decrement (default 1) :param int version: key version number (default None, cache parameter) :param int default: value if key is missing (default None) :param bool retry: retry if database timeout occurs (default True) :return: new value for item on success else None :raises ValueError: if key is not found and default is None )rGrJs rdecrzDjangoCache.decrs4yyufgw>>rcD|j||}||jvS)zReturns True if the key is in the cache and has not expired. :param key: key for item :param int version: key version number (default None, cache parameter) :return: True if key is found r-)r0rr=s rhas_keyzDjangoCache.has_keys%mmCm1dkk!!rc6|jjS)zSRemove expired items from cache. :return: count of items removed )rexpirer!s rrQzDjangoCache.expire&s {{!!##rc<|jj||S)zReturn cache statistics hits and misses. :param bool enable: enable collecting statistics (default True) :param bool reset: reset hits and misses to 0 (default False) :return: (hits, misses) )enablereset)rstats)rrSrTs rrUzDjangoCache.stats.s{{  e <.decorator..wrappers,g++T.decorator..__cache_key__s"4vufEEr)r rrj) rnrjrqrorrr%rr7rrsr.s ` @@r decoratorz&DjangoCache.memoize..decoratorsG)-IdO%D7D 4[   0 F%2G !Nr)callable TypeError)rr%rr.rsr7rrrts``````` rmemoizezDjangoCache.memoizers,^ D>56 6" " Hr)N)NNFFFF)NNFFT)NT)rNNT)TF) __name__ __module__ __qualname____doc__rpropertyrr#r)r+rr2rr6r?rArCrErGrMrOrQrUrWrYr[r]r_rar1rw __classcell__)rs@rr r s7 I%%'6'   FF  L: %    F:"1$d6( F8 .C:?8 "$='%&"# +: 4  Vrr N)r{ functoolsrdjango.core.cache.backends.baserr ImportErrorcorerr r fanoutr r rfrrrsE35? 10w)wOs 2<<