h@4SrSSKrSSKJr SSKJr SSKJr SSKJ r SSK J r J r SSK JrJrJrJr SS KJr SS KJr SS KJr SS KJr \"S 5rSrSrSrSrS"SjrS#Sjr Sr!Sr"Sr#Sr$S"Sjr%Sr&Sr'Sr(Sr)Sr*Sr+S$Sjr,S#S jr-S!r.g)%a This module contains helper functions for controlling caching. It does so by managing the "Vary" header of responses. It includes functions to patch the header of response objects directly and decorators that change functions to do that header-patching themselves. For information on the Vary header, see RFC 9110 Section 12.5.5. Essentially, the "Vary" HTTP header defines which headers a cache should take into account when building its cache key. Requests with the same path but different header content for headers named in "Vary" need to get different cache keys to prevent delivery of wrong content. An example: i18n middleware would need to distinguish caches by the "Accept-language" header. N) defaultdict)md5)settings)caches) HttpResponseHttpResponseNotModified) http_date parse_etagsparse_http_date_safe quote_etag) log_response)_lazy_re_compile)get_current_timezone_name) get_languagez\s*,\s*c ^SnSn[[5nURS5(aR[R UR S5H,nU"U5upgUS:XaXFR U5 M(XtU'M. SU;a$SU;a[[US5US5US'SU;a SU;aUS OSU;a SU;aUS UR5H6upURS S 5nUS:XaXFR U 5 M2XU'M8 /n UR5Hcupk[U [5(a2S U ;aS 1n U RU Vs/sH os"Xg5PM sn5 MLU RU"Xk55 Me S RU 5nX@R S'g s snf)a Patch the Cache-Control header by adding all keyword arguments to it. The transformation is as follows: * All keyword parameter names are turned to lowercase, and underscores are converted to hyphens. * If the value of a parameter is True (exactly True, not just a true value), only the parameter name is added to the header. * All other parameters are added with their value, after applying str() to it. cURSS5n[U5S:aUSR5US4$USR5S4$)N=rTsplitlenlowersts D/var/www/html/env/lib/python3.13/site-packages/django/utils/cache.pydictitem%patch_cache_control..dictitem/sJ GGCO q6A:aDJJL!A$' 'aDJJL$' 'c:USSLaUS$US<SUS<3$)NrTrr)rs r dictvalue&patch_cache_control..dictvalue6s) Q44<Q4KdAaD) )r Cache-Controlzno-cachemax-agemax_ageprivatepublic_-T, N)rsetget cc_delim_rerheadersaddminintitemsreplace isinstanceextendappendjoin) responsekwargsrr"ccfield directivevaluekv directivesvaluess rpatch_cache_controlrC"s(* S B||O$$ &&x'7'7'HIE' IJ& !!%( %9 JB9.ByM 2F94EFyB8v- yM RI/ xL IIc3'  " M  a yM JXXZ fc " "v~   Ouy:O P   i : ;( : B(*_% PsF* cURS5(dg[S[RURS555n[ US5$![ [[4a gf=f)z{ Return the max-age from the response Cache-Control header as an integer, or None if it wasn't found or wasn't an integer. r$Nc38# UHn[U5v M g7fN) _to_tuple).0els r get_max_age..ns T" " Tsr%) has_headerdictr.rr/r2 ValueError TypeErrorKeyError)r9r;s r get_max_agerQgsr    / /  + 1 1(2B2B?2S T B 2i=!!  8 ,   s AA10A1cUR(dIUR(a8[[URSS9R 55UR S'U$)NFusedforsecurityETag) streamingcontentr r hexdigestr/r9s rset_response_etagrZwsH   ("2"2#-   % 8 B B D$   OrcD[SS9n[SURUUS9 U$)Ni)statuszPrecondition Failed: %s)r9request)rr path)r]r9s r_precondition_failedr_s+3'H!   Orc[5nU(a=SH&nX1;dM URUURU'M( URUlU$)N)r$zContent-LocationDaterUExpiresz Last-ModifiedVary)rr/cookies)r]r9 new_responseheaders r _not_modifiedrgsR*,L F!/7/?/?/G $$V, " (//  rc U(aSURs=::aS:dU$ U$[URRSS55nURRS5nU=(a [ U5n[URRSS55nURRS5nU=(a [ U5nU(a[ X5(d [ U5$U(d"U(a[X%5(d [ U5$U(a6[X5(d&URS;a [X5$[ U5$U(d2U(a+[X'5(dURS;a [X5$U$) Ni, HTTP_IF_MATCHHTTP_IF_UNMODIFIED_SINCEHTTP_IF_NONE_MATCHHTTP_IF_MODIFIED_SINCE)GETHEAD) status_coder METAr-r _if_match_passesr__if_unmodified_since_passes_if_none_match_passesmethodrg_if_modified_since_passes)r]etag last_modifiedr9if_match_etagsif_unmodified_sinceif_none_match_etagsif_modified_sinces rget_conditional_responser~sR 4 4:s:;!!1!1/2!FGN!,,**+EF-2F3&gll&6&67KR&PQ (()AB)U.BCT.U .tDD#G,,  +MOO#G,,#8#S#S >>_ , 3 3'0 0 )-KK NNo -W// OrcXU(dgUS/:XagURS5(agX;$)zE Test the If-Match comparison as defined in RFC 9110 Section 13.1.1. F*TW/) startswith target_etagetagss rrsrss7  3%    % %##rcU=(a X:*$)zP Test the If-Unmodified-Since comparison as defined in RFC 9110 Section 13.1.4. r!)ryr{s rrtrts  A]AArc^U(dgUS/:XagURS5nSU5nX;$)zJ Test the If-None-Match comparison as defined in RFC 9110 Section 13.1.2. TrFrc3B# UHoRS5v M g7f)rNstrip)rHrxs rrJ(_if_none_match_passes..s4edD!!esrrs rrurus=  3%"''- 4e4''rc&U(+=(d X:$)zN Test the If-Modified-Since comparison as defined in RFC 9110 Section 13.1.3. r!)ryr}s rrwrws   A AArcUc[RnUS:aSnURS5(d.[[R"5U-5UR S'[ XS9 g)z Add HTTP caching headers to the given HttpResponse: Expires and Cache-Control. Each header is only added if it isn't already set. cache_timeout is in seconds. The CACHE_MIDDLEWARE_SECONDS setting is used by default. Nrrb)r&)rCACHE_MIDDLEWARE_SECONDSrLr timer/rC)r9 cache_timeouts rpatch_response_headersrs[ 99 q   y ) )&/ m0K&L#8rc2[USS9 [USSSSS9 g)zK Add headers to a response to indicate that a page should never be cached. )rT)no_cacheno_storemust_revalidater'N)rrCrYs radd_never_cache_headersr!s!8264$drcURS5(a#[RURS5nO/nUVs1sHo3R 5iM nnUVs/sHnUR 5U;dMUPM nnX&- nSU;aSURS'gSR U5URS'gs snfs snf)a Add (or update) the "Vary" header in the given HttpResponse object. newheaders is a list of header names that should be in "Vary". If headers contains an asterisk, then "Vary" header will consist of a single asterisk '*'. Otherwise, existing headers in "Vary" aren't removed. rcrr+N)rLr.rr/rr8)r9 newheaders vary_headersrfexisting_headers newheaderadditional_headerss rpatch_vary_headersr+s6"""(()9)9&)AB  5AB\6 \B$#I ?? $4 4 # &L l#& #'99\#: CsB<C;CcURS5(dg[RURS5nUVs1sHo3R 5iM nnUR 5U;$s snf)zJ Check to see if the response has a given header name in its Vary header. rcF)rLr.rr/r)r9 header_queryrrfrs rhas_vary_headerrGsg   v & &$$X%5%5f%=>L5AB\6 \B    #3 33CsA,c[R(aUS[US[55-- n[R(aUS[ 5-- nU$)zCIf necessary, add the current locale or time zone to the cache key.z.%s LANGUAGE_CODE)rUSE_I18NgetattrrUSE_TZr)r] cache_keys r_i18n_cache_key_suffixrRsG UWWo|~NNN U6888 rc d[SS9nUHBnURRU5nUcM#URUR 55 MD [UR 5R S5SS9nSU<SU<SUR 5<SUR 5<3n[X5$)z=Return a cache key from the headers given in the header list.FrSasciiz"views.decorators.cache.cache_page..)rrrr-updateencodebuild_absolute_urirXr) r]rv headerlist key_prefixctxrfr>urlrs r_generate_cache_keyr^s e $C   (   JJu||~ & g((*11':E RC   I "' 55rc[UR5RS5SS9nSU<SUR5<3n[ X5$)z(Return a cache key for the header cache.rFrSz$views.decorators.cache.cache_header.r)rrrrXr)rr]rrs r_generate_cache_header_keyrosB g((*11':E RC I "' 55rcUc[Rn[X5nUc[[RnUR U5nUb [ XXQ5$g)aI Return a cache key based on the request URL and query. It can be used in the request phase because it pulls the list of headers to take into account from the global URL registry and uses those to build a cache key to check against. If there isn't a headerlist stored, return None, indicating that the page needs to be rebuilt. N)rCACHE_MIDDLEWARE_KEY_PREFIXrrCACHE_MIDDLEWARE_ALIASr-r)r]rrvcacherrs r get_cache_keyrysX99 *:?I }x6679%J"7JKKrcUc[RnUc[Rn[X05nUc[[R nUR S5(a[Rn/n[RURS5HFnUR5RSS5nUS:wd U(aM2URSU-5 MH UR5 URXWU5 [!XR"Xs5$URU/U5 [!XR"/U5$)a Learn what headers to take into account for some request URL from the response object. Store those headers in a global URL registry so that later access to that URL will know what headers to take into account without building the response object itself. The headers are named in the Vary header of the response, but we want to prevent response generation. The list of headers to use for cache key generation is stored in the same cache as the pages themselves. If the cache ages some data out of the cache, this just means that we have to build the response once to get at the Vary header and so at the list of headers to use for the cache key. rcr*r)ACCEPT_LANGUAGEHTTP_)rrrrrrrLrr.rr/upperr4r7sortr,rrv) r]r9rrrris_accept_language_redundantrrfs rlearn_cache_keyrs99  99 *:?I }x6676""'/'8'8$  !''(8(8(@AF\\^++C5F**2N2N!!'F"23B  )7"7NNJSS  )R/"7NNB KKrcURSS5n[U5S:XaUSR5US4$USR5S4$)NrrrTrrs rrGrGsJ QA 1v{tzz|QqT!! Q4::< rrF)NNN)NroN)/__doc__r collectionsrhashlibr django.confrdjango.core.cacher django.httprrdjango.utils.httpr r r r django.utils.logr django.utils.regex_helperrdjango.utils.timezonerdjango.utils.translationrr.rCrQrZr_rgr~rsrtrurwrrrrrrrrrrGr!rrrs" # $=VV)6;1z* B+J  4/d$*B(&B9&;84 6"6,&LRr