Bh@ndZddlZddlZddlmZddlmZddlmZm Z dZ dZ d dZ dd Z d Zd Zd Zy)a~ This module manages placeholder caching. We use a cache-versioning strategy in which each (placeholder x lang x site_id) manages its own version. The actual cache includes additional keys appropriate for the placeholders get_vary_cache_on(). Invalidation of a placeholder's cache simply increments the version number for the (placeholder x lang) pair, which renders any cache entries for that placeholder under that version inaccessible. Those cache entries will simply expire and will be purged according to the policy of the cache backend in-use. The cache entries themselves may include additional sub-keys, according to the list of VARY header-names as returned by placeholder.get_vary_cache_on() and the current HTTPRequest object. The vary-on header-names are also stored with the version. This enables us to check for cache hits without re-computing placeholder.get_vary_cache_on(). N)now)get_cms_setting)get_header_nameget_timezone_namectd}|d|jdt|d|}t|dkDrCdj |t j |jdj}|S) u[ Returns the version key for the given «placeholder», «lang» and «site_id». Invalidating this (via clear_placeholder_cache by replacing the stored value with a new value) will effectively make all "sub-caches" relating to this (placeholder x lang) inaccessible. Sub-caches include caches per TZ and per VARY header. CACHE_PREFIXz|placeholder_cache_version|id:|lang:|site:{prefix}|{hash}utf-8prefixhash) rpkstrlenformathashlibsha1encode hexdigest) placeholderlangsite_idrkeys E/home/dcms/DCMS/lib/python3.12/site-packages/cms/cache/placeholder.py"_get_placeholder_cache_version_keyrs^ ,F H2;>>2B&T SYZaYb cC 3x#~&&cjj12<<>'  Jcddlm}t|||}|j|}|r |\}}||fSt t j dz}g}t |||||||fS)u Gets the (placeholder x lang)'s current version and vary-on header-names list, if present, otherwise resets to («timestamp», []). rcache@B)django.core.cacher"rgetinttime_set_placeholder_cache_version)rrrr"rcachedversion vary_on_lists r_get_placeholder_cache_versionr,5ss ( ,[$ HC YYs^F & L  diikG+, &{D'7LY L  rcddlm}t|||}|r|dkr tt jdz}|g}|j |||f|y)zP Sets the (placeholder x lang)'s version and vary-on header-names list. rr!r#N)r$r"rr&r'set)rrrr*r+durationr"rs rr(r(GsS( ,[$ HC gkdiikG+,  IIcG\*H5rc ltd}t|||\}}t}|d|jd|d|d|d| } |s;|j |}|j |t } t|||||| g} |D]A} |jjt| xsd} | j| dz| zC| }| r|d d j| zz }t|d kDrCd j|tj |j#d j% }|S)u Returns the fully-addressed cache key for the given placeholder and the request. The kwarg «soft» should be set to True if getting the cache key to then read from the cache. If instead the key retrieval is to support a cache write, let «soft» be False. rz|render_placeholder|id:r r z|tz:z|v:_:|r r r r)rr,rrget_vary_cache_onget_cache_expirationrr(METAr%rappendjoinrrrrrr)rrrrequestsoftrr*r+tzmain_keyr0 sub_key_listrvalue cache_keys r_get_placeholder_cache_keyrAXsT^ ,F:;gVG\  B00@tfFSZR[[_`b_ccfgnfopH  #44W= 33GSUC&{D'7LZbcL/   !56=#C#I-./IS388L111  9~%,,i..w78BBD- rcddlm}t||||}tt dd|j |t }|j|||t|||\}} t||||| |y)zM Sets the (correct) placeholder cache with the rendered placeholder. rr!CACHE_DURATIONScontent)r0N) r$r"rAminrr6rr/r,r() rrrrDr:r"rr0r*r+s rset_placeholder_cacherFsv( $[$ IC?#45i@+BbBbcjlolqBrsH IIc7H%:;gVG\";gw _ghrcTddlm}t||||d}|j|}|S)z[ Returns the placeholder from cache respecting the placeholder's VARY headers. rr!T)r;)r$r"rAr%)rrrr:r"rrDs rget_placeholder_cacherHs+ ( $[$t TCiinG Nrcbttjdz}t||||gy)z Invalidates all existing cache entries for (placeholder x lang x site_id). We don't need to re-store the vary_on_list, because the cache is now effectively empty. r#N)r&r'r()rrrr*s rclear_placeholder_cacherJs) $))+'(G";gwKr)NN)F)__doc__rr'django.utils.timezonercms.utils.confrcms.utils.helpersrrrr,r(rArFrHrJrrrPsA$ %*@2!$6".b i Lr