+ Nj%^RIHt^RIHt^RIt^RIHt^RI H t ^RI H t RR/RRllt !R R ] ]]P],3,4t!R R ] ]]P],3,]4t!R R]4t^RIHtR#)) annotationsN)cleandoc)ImmutableDictMixin) CallbackDictdocc ,V^8dQhRRRRRRRRR R/#) keystremptyt.Anytypetype[t.Any] | Nonerz str | Nonereturn)formats"g/data/cameron/venvs/serve_omidlab/lib/python3.14/site-packages/werkzeug/datastructures/cache_control.py __annotate__r s4** **"4*>H* *caaaVfRS R2.pS\JdVPR4M`SfVPR4MVPRSP R24SeVPRS: R24VPR 4R PV4p\ VVV3R lVV3R lV3R l\ V4R7#)aReturn a new property object for a cache header. Useful if you want to add support for a cache extension in a subclass. :param key: The attribute name present in the parsed cache-control header dict. :param empty: The value to use if the key is present without a value. :param type: The type to convert the string value to instead of a string. If conversion raises a ``ValueError``, the returned value is ``None``. :param doc: The docstring for the property. If not given, it is generated based on the other params. .. versionchanged:: 3.1 Added the ``doc`` param. .. versionchanged:: 2.0 Renamed from ``cache_property``. zThe ``z `` attribute.z"A ``bool``, either present or not.z A ``str``,zA ``z``,z``z`` if present with no value,zor ``None`` if not present. c*<VPSSS4#N)_get_cache_value)xr r rs&r(cache_control_property..1s!$$S%6rc*<VPSVS4#r)_set_cache_value)rvr rs&&rrr2sQ''Q5rc&<VPS4#r)_del_cache_value)rr s&rrr3s!$$S)r)r)boolappend__name__joinpropertyr)r r rrpartssfff$ rcache_control_propertyr) s& {#m,- 4< LL= >| \* tDMM?#67  r%*FGH LL6 7hhuo 65) SM  rca]tRt^8t$Rt]!RR]4tR]R&]!RR] 4t R]R&]!R R]4t R]R &]!R R] 4t R]R &RR V3Rlllt RRltRRltRRltRRltRRltRRlt]!]4tRtV;t#) _CacheControladSubclass of a dict that stores values for a Cache-Control header. It has accessors for all the cache-control directives specified in RFC 2616. The class does not differentiate between request and response directives. Because the cache-control directives in the HTTP header use dashes the python descriptors use underscores for that. To get a header of the :class:`CacheControl` object again you can convert the object into a string or call the :meth:`to_header` method. If you plan to subclass it and add your own items have a look at the sourcecode for that class. .. versionchanged:: 3.1 Dict values are always ``str | None``. Setting properties will convert the value to a string. Setting a non-bool property to ``False`` is equivalent to setting it to ``None``. Getting typed properties will return ``None`` if conversion raises ``ValueError``, rather than the string. .. versionchanged:: 2.1 Setting int properties such as ``max_age`` will convert the value to an int. .. versionchanged:: 0.4 Setting ``no_cache`` or ``private`` to ``True`` will set the implicit value ``"*"``. zno-storeNr#no_storezmax-age int | Nonemax_agez no-transform no_transformzstale-if-errorstale_if_errorc V^8dQhRRRR/#)r valueszBcabc.Mapping[str, t.Any] | cabc.Iterable[tuple[str, t.Any]] | None on_updatez+cabc.Callable[[_CacheControl], None] | Noner)rs"rr_CacheControl.__annotate__Zs++R+?+rc 8<\SV`W4VRJVnR#r)super__init__provided)selfr2r3 __class__s&&&rr7_CacheControl.__init__Zs +d* rc(V^8dQhRRRRRRRR/#)r r r r r rrrr)rs"rrr4bs,$,> rc V\JdW9#W9dR#W,;pfV#Ve V!V4pV#V# \dR#i;i+Used internally by the accessor properties.N)r# ValueError)r9r r rvalues&&&& rr_CacheControl._get_cache_valuebs` 4<;  ?Y E 'L   U  u   s6 AAc(V^8dQhRRRRRRRR/#) r r r rAr rrrNoner)rs"rrr4ws,###$#,># #rc V\Jd#V'dRW&R#VPVR4R#VeVRJdVPVR4R#VRJdRW&R#Ve V!V4p\V4W&R#)r?NFT)r#popr )r9r rArs&&&&rr_CacheControl._set_cache_valuewsd 4<  d# ]eun HHS$  d]DIU E DIrc V^8dQhRRRR/#)r r r rrDr)rs"rrr4sCDrc W9dWR#R#r>r)r9r s&&rr"_CacheControl._del_cache_values ;  rcV^8dQhRR/#r rr r)rs"rrr4s&&3&rc .\P!V4#)z6Convert the stored values into a cache control header.)http dump_headerr9s&r to_header_CacheControl.to_headers%%rcV^8dQhRR/#rLr)rs"rrr4s   rc "VP4#r)rQrPs&r__str___CacheControl.__str__s~~rcV^8dQhRR/#rLr)rs"rrr4s33#3rc RPR\VP4444pR\V4P RV R2#)rc36"TFwrV RV: 2xK R#5i)=Nr).0kr s& r )_CacheControl.__repr__..sH3G41QCq,3Gs<>)r&sorteditemsrr%)r9kv_strs& r__repr___CacheControl.__repr__sAH6$**,3GHH4:&&'q22r)r8)rN)r% __module__ __qualname____firstlineno____doc__r)r#r,__annotations__intr.r/r0r7rrr"rQrUrd staticmethodcache_property__static_attributes__ __classcell__)r:s@rr+r+8s8,JdCHdC0D#FGZF/dKL$K!78H$PS!TNJT++*#& & 3""89Nrr+c]tRt^t$Rt]!RR]4tR]R&]!RR] 4t R]R &]!R R] 4t R ]R &]!R R]4t R]R&Rt R#)RequestCacheControlaA cache control for requests. This is immutable and gives access to all the request-relevant cache control headers. To get a header of the :class:`RequestCacheControl` object again you can convert the object into a string or call the :meth:`to_header` method. If you plan to subclass it and add your own items have a look at the sourcecode for that class. .. versionchanged:: 3.1 Dict values are always ``str | None``. Setting properties will convert the value to a string. Setting a non-bool property to ``False`` is equivalent to setting it to ``None``. Getting typed properties will return ``None`` if conversion raises ``ValueError``, rather than the string. .. versionchanged:: 3.1 ``max_age`` is ``None`` if present without a value, rather than ``-1``. .. versionchanged:: 3.1 ``no_cache`` is a boolean, it is ``True`` instead of ``"*"`` when present. .. versionchanged:: 3.1 ``max_stale`` is ``True`` if present without a value, rather than ``"*"``. .. versionchanged:: 3.1 ``no_transform`` is a boolean. Previously it was mistakenly always ``None``. .. versionchanged:: 3.1 ``min_fresh`` is ``None`` if present without a value, rather than ``"*"``. .. versionchanged:: 2.1 Setting int properties such as ``max_age`` will convert the value to an int. .. versionadded:: 0.5 Response-only properties are not present on this request class. no-cacheNr#no_cachez max-staleTzint | t.Literal[True] | None max_stalez min-freshr- min_freshzonly-if-cachedonly_if_cachedr)r%rfrgrhrir)r#rsrjrkrtrurvrnrrrrqrqsa)V,JdCHdC.D  /I+ 3;cJIzJ12BD$ONDOrrqc*]tRt^t$Rt]!RRR4tR]R&]!RR]4t R]R&]!R RR4t R]R &]!R R]4t R]R &]!R R]4t R]R &]!RR] 4tR]R&]!RR]4tR]R&]!RR]4tR]R&]!RR] 4tR]R&RtR#)ResponseCacheControlaA cache control for responses. Unlike :class:`RequestCacheControl` this is mutable and gives access to response-relevant cache control headers. To get a header of the :class:`ResponseCacheControl` object again you can convert the object into a string or call the :meth:`to_header` method. If you plan to subclass it and add your own items have a look at the sourcecode for that class. .. versionchanged:: 3.1 Dict values are always ``str | None``. Setting properties will convert the value to a string. Setting a non-bool property to ``False`` is equivalent to setting it to ``None``. Getting typed properties will return ``None`` if conversion raises ``ValueError``, rather than the string. .. versionchanged:: 3.1 ``no_cache`` is ``True`` if present without a value, rather than ``"*"``. .. versionchanged:: 3.1 ``private`` is ``True`` if present without a value, rather than ``"*"``. .. versionchanged:: 3.1 ``no_transform`` is a boolean. Previously it was mistakenly always ``None``. .. versionchanged:: 3.1 Added the ``must_understand``, ``stale_while_revalidate``, and ``stale_if_error`` properties. .. versionchanged:: 2.1.1 ``s_maxage`` converts the value to an int. .. versionchanged:: 2.1 Setting int properties such as ``max_age`` will convert the value to an int. .. versionadded:: 0.5 Request-only properties are not present on this response class. rrTNzstr | t.Literal[True] | Nonerspublicr#privatezmust-revalidatemust_revalidatezproxy-revalidateproxy_revalidatezs-maxager-s_maxage immutablezmust-understandmust_understandzstale-while-revalidatestale_while_revalidater)r%rfrgrhrir)rsrjr#ryrzr{r|rkr}r~rrrnrrrrxrxs)V.DD$.H**(D$?FD?,B4-G )33DdDQOTQ34FdSdS1*dCHHjH,[$EItE23DdDQOTQ)? $*Jrrx)rN) __future__rcollections.abcabccabctypingtinspectrmixinsr structuresrr)r Optionalr+rqrxrNrrrrs|"&$*KO*Zb:Lajjo!56b:J3P,S!**S/-ABM3Pl:=:|r