Vh7dZddlZddlZddlmZddlmZddlmZddl m Z GddeZ Gd d e Z Gd d eZeZd ZdZdZGddZe dZdZy)zBase Cache class.N) sync_to_async)ImproperlyConfigured) import_string)_lazy_re_compilec eZdZy)InvalidCacheBackendErrorN__name__ __module__ __qualname__O/home/dcms/DCMS/lib/python3.12/site-packages/django/core/cache/backends/base.pyrr rrc eZdZy)CacheKeyWarningNr r rrrrrrrc eZdZy)InvalidCacheKeyNr r rrrrrrrc|d|d|S)z Default function to generate keys. Construct the key used by all other methods. By default, prepend the `key_prefix`. KEY_FUNCTION can be used to specify an alternate function with custom key making behavior. :r )key key_prefixversions rdefault_key_funcr!s$Wc 22rcB|t|r|St|StS)z] Function to decide which key function to use. Default to ``default_key_func``. )callablerr)key_funcs r get_key_funcr,s(  H O * * rcfeZdZeZdZefdZd(dZdZ d(dZ edfdZ edfdZ d)d Z d)d Zedfd Zedfd Zedfd ZedfdZd(dZd(dZd(dZd(dZedfdZedfdZd(dZd(dZd*dZd*dZd*dZd*dZdZedfdZ edfdZ!d(dZ"d(dZ#d Z$d!Z%d*d"Z&d*d#Z'd*d$Z(d*d%Z)d&Z*d'Z+y)+ BaseCachec|jd|jdd}| t|}||_|jdi}|jd|jdd} t||_|jd|jdd } t||_|jd d |_|jd d |_t|jd|_ y#ttf$rd}YwxYw#ttf$r d|_YwxYw#ttf$r d |_YwxYw)NtimeoutTIMEOUTi,OPTIONS max_entries MAX_ENTRIEScull_frequencyCULL_FREQUENCY KEY_PREFIXVERSION KEY_FUNCTION) getint ValueError TypeErrordefault_timeout _max_entries_cull_frequencyrrrr)selfparamsr#optionsr&r(s r__init__zBaseCache.__init__=s:**Y 9c(BC   g, '**Y+jj M30OP  $ #K 0D  $4gkkBRTU6VW %#&~#6D !**\26zz)Q/ $VZZ%?@ ' *  I& $ #D  $ I& %#$D  %s5 C>-D D1>DDD.-D.1E  E cr|tk(r |j}n|dk(rd}|dStj|zS)zj Return the timeout value usable by this backend based upon the provided timeout. rN)DEFAULT_TIMEOUTr4time)r7r#s rget_backend_timeoutzBaseCache.get_backend_timeoutWs= o %**G \GtADIIK',AArNcX| |j}|j||j|S)ap Construct the key used by all other methods. By default, use the key_func to generate a key (which, by default, prepends the `key_prefix' and 'version'). A different key function can be provided at the time of cache construction; alternatively, you can subclass the cache backend to provide custom key making behavior. )rrrr7rrs rmake_keyzBaseCache.make_keycs) ?llG}}S$//7;;rcXt|D]}tj|ty)z Warn about keys that would not be portable to the memcached backend. This encourages (but does not force) writing backend-portable cache code. N)memcache_key_warningswarningswarnr)r7rwarnings r validate_keyzBaseCache.validate_keyps& -S1 4G MM'? 3 4rcN|j||}|j||S)z!Helper to make and validate keys.r)rBrHrAs rmake_and_validate_keyzBaseCache.make_and_validate_keyys'mmCm1 # rctd)z Set a value in the cache if the key does not already exist. If timeout is given, use that timeout for the key; otherwise use the default cache timeout. Return True if the value was stored, False otherwise. z4subclasses of BaseCache must provide an add() methodNotImplementedErrorr7rvaluer#rs raddz BaseCache.adds" B  rc^Kt|jd||||d{S7wNT)thread_sensitive)rrQrOs raaddzBaseCache.aadd3C]488dC     $-+-ctd)z Fetch a given key from the cache. If the key does not exist, return default, which itself defaults to None. z3subclasses of BaseCache must provide a get() methodrMr7rdefaultrs rr0z BaseCache.get ""WXXrc\Kt|jd|||d{S7wrS)rr0rYs ragetzBaseCache.agets1C]488dC '    #,*,ctd)z Set a value in the cache. If timeout is given, use that timeout for the key; otherwise use the default cache timeout. z3subclasses of BaseCache must provide a set() methodrMrOs rsetz BaseCache.setr[rc^Kt|jd||||d{S7wrS)rr`rOs rasetzBaseCache.asetrVrWctd)z Update the key's expiry time using timeout. Return True if successful or False if the key does not exist. z5subclasses of BaseCache must provide a touch() methodrMr7rr#rs rtouchzBaseCache.touchs " C  rc\Kt|jd|||d{S7wrS)rrerds ratouchzBaseCache.atouchs1E]4::E '    r^ctd)zh Delete a key from the cache and return whether it succeeded, failing silently. z6subclasses of BaseCache must provide a delete() methodrMrAs rdeletezBaseCache.deletes " D  rcZKt|jd||d{S7wrS)rrirAs radeletezBaseCache.adeletes&F]4;;FsGTTTTs "+)+c|i}|D]4}|j||j|}||jus0|||<6|S)a. Fetch a bunch of keys from the cache. For certain backends (memcached, pgsql) this can be *much* faster when fetching multiple values. Return a dict mapping each key in keys to its value. If the given key is missing, it will be missing from the response dict. rJr0 _missing_keyr7keysrdkvals rget_manyzBaseCache.get_manysP  A((1d//(AC$+++! rcKi}|D]<}|j||j|d{}||jus8|||<>|S7w)zSee get_many().rJNr]rnros r aget_manyzBaseCache.aget_manys[  A !T%6%6 HHC$+++! Is)A AA  A c|j||j|}||jur;t|r|}|j|||||j|||S|S)aU Fetch a given key from the cache. If the key does not exist, add the key and set it to the default value. The default value can also be any callable. If timeout is given, use that timeout for the key; otherwise use the default cache timeout. Return the value of the key stored or retrieved. rJr#r)r0rnrrQr7rrZr#rrss r get_or_setzBaseCache.get_or_setskhhsD--wh? $## # !) HHS'7GH D88C'8: : rcK|j||j|d{}||jurKt|r|}|j||||d{|j|||d{S|S7_7$7 w)zSee get_or_set().rJNry)r]rnrrUrzs r aget_or_setzBaseCache.aget_or_setsIIc4#4#4gIFF $## # !)))C'7)K K K3AA A G LBs3"B BB B B cV|j||j||juS)M Return True if the key is in the cache and has not expired. rJrmrAs rhas_keyzBaseCache.has_keys, HHS$++WH =TEVEV V rcrK|j||j|d{|juS7wNrJrvrAs rahas_keyzBaseCache.ahas_keys7))C!2!2G)D D$$ % Ds "757c|j||j|}||jurtd|z||z}|j||||S)zs Add delta to value in the cache. If the key does not exist, raise a ValueError exception. rJKey '%s' not found)r0rnr2r`r7rdeltarrP new_values rincrzBaseCache.incrs^ d//A D%% %1C78 8EM  i1rcK|j||j|d{}||jurtd|z||z}|j|||d{|S7C7w)z See incr().rJNr)r]rnr2rbrs raincrzBaseCache.aincrsuiiT%6%6iHH D%% %1C78 8EM iiYi888 I 9s!"A,A(!&5d -  rr!z[\x00-\x20\x7f]c#Kt|tkDrd|dtdtj|rd|yyw)Nz4Cache key will cause errors if used with memcached: z (longer than )zMCache key contains characters that will cause errors if used with memcached: )lenMEMCACHE_MAX_KEY_LENGTHmemcached_error_chars_research)rs rrDrDsO 3x))#&'> @  &&s+  " ,sAA)__doc__r>rE asgiref.syncrdjango.core.exceptionsrdjango.utils.module_loadingrdjango.utils.regex_helperrrRuntimeWarningrr2rrr=rrrr!rrDr rrrsz &756 3  n  j (3 L L ^ ,,>?  r