/h%ddlmZddlmZddlZddlmZddl m Z ddl m Z ddddZ Gdde eejefZGdde eejefeZGddeZddlmZdS)) annotationsN)cleandoc)ImmutableDictMixin) CallbackDictdockeystremptyt.Anytypetype[t.Any] | Noner str | Nonereturnc|ddg}tur|dnf|dn|djd|dd |d d |}t fd fd fdt |S)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``. NzThe ``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. c2|SN)_get_cache_value)xr r rs X/var/www/html/venv/lib/python3.11/site-packages/werkzeug/datastructures/cache_control.pyz(cache_control_property..1s!$$S%66c2||Sr)_set_cache_value)rvr rs rrz(cache_control_property..2sQ''Q55rc.|Sr)_del_cache_value)rr s rrz(cache_control_property..3s!$$S))rr)boolappend__name__joinpropertyr)r r rr partss``` rcache_control_propertyr& s & {,#,,,- 4<< LL= > > > >| \**** 6DM666777  G%GGGHHH LL6 7 7 7hhuoo 66666655555)))) SMM    rceZdZUdZeddeZded<eddeZ ded<ed deZ ded <ed deZ ded < d"d#fd Z d$dZ d%dZd&dZd'dZd'd Zd'd!ZeeZxZS)( _CacheControlaSubclass 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_errorvaluesBcabc.Mapping[str, t.Any] | cabc.Iterable[tuple[str, t.Any]] | None on_update+cabc.Callable[[_CacheControl], None] | Nonec^t|||du|_dSr)super__init__provided)selfr/r1 __class__s rr5z_CacheControl.__init__Zs/ +++d* rr r r r rrrc|tur||vS||vrdS||x}|S| ||}n#t$rYdSwxYw|S+Used internally by the accessor properties.N)r ValueError)r7r r rvalues rrz_CacheControl._get_cache_valuebs| 4<<$;  d??4#Y E 'L   U    tt  s / ==r=Nonec|tur!|rd||<dS||ddS||dur||ddS|durd||<dS| ||}t|||<dS)r;NFT)r popr )r7r r=rs rrz_CacheControl._set_cache_valuews 4<< $ S d##### ]eunn HHS$      d]]DIIIU E DIIIrc||vr||=dSdSr:r.)r7r s rrz_CacheControl._del_cache_values $;;S  ;rc*tj|S)z6Convert the stored values into a cache control header.)http dump_headerr7s r to_headerz_CacheControl.to_headers%%%rc*|Sr)rFrEs r__str__z_CacheControl.__str__s~~rcddt|D}dt|jd|dS)Nrc3*K|]\}}|d|VdS)=Nr.).0krs r z)_CacheControl.__repr__..s0HH41aQ,,,,HHHHHHr<>)r#sorteditemsrr")r7kv_strs r__repr__z_CacheControl.__repr__sTHH6$**,,3G3GHHHHH24::&222222r)r.N)r/r0r1r2)r r r r rrrr )r r r=r rrrr>)r r rr>)rr )r" __module__ __qualname____doc__r&r r)__annotations__intr+r,r-r5rrrrFrHrT staticmethodcache_property __classcell__)r8s@rr(r(8sZ8,+JdCCHCCCC00D#FFGFFFF//dKKLKKKK!7!78H$PS!T!TNTTTTVXAE+++++++*####& &&&&    3333"\"899NNNNNrr(ceZdZUdZeddeZded<eddeZ ded <ed deZ d ed <ed deZ ded<dS)RequestCacheControla A 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_cached) r"rUrVrWr&r r`rXrYrarbrcr.rrr^r^s))V,+JdCCHCCCC.D.D  //I 32;cJJIJJJJ112BD$OONOOOOOOrr^cXeZdZUdZedddZded<eddeZded<ed ddZ ded <ed deZ ded <ed deZ ded <edde Z ded<eddeZded<eddeZded<edde Zded<dS)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. r_TNzstr | t.Literal[True] | Noner`publicr privatezmust-revalidatemust_revalidatezproxy-revalidateproxy_revalidatezs-maxager*s_maxage immutablezmust-understandmust_understandzstale-while-revalidatestale_while_revalidate)r"rUrVrWr&r`rXr rfrgrhrirYrjrkrlrmr.rrrerest))V.D-CD$..H*)(D$??F????,B,B4--G323DdDQQOQQQQ334FdSSSSSS11*dCHHHHHHH,,[$EEIEEEE223DdDQQOQQQQ)?)? $**rre)rC) r r r r rrr rrr ) __future__rcollections.abcabccabctypingtinspectrmixinsr structuresrr&r Optionalr(r^rerCr.rrrzs_""""""&&&&&&$$$$$$LP******Zb:b:b:b:b:Lajo!56b:b:b:J3P3P3P3P3P,S!*S/-ABM3P3P3Pl:::::=:::|r