հj%ddlmZddlmZddlZddlmZddl m Z ddl m Z dd ddZ Gd d e eejefZGd d e eejefeZGd deZddlmZy)) annotationsN)cleandoc)ImmutableDictMixin) CallbackDictdoccn|ddg}tur|jdn[|jdn|jdjd|jdd|jd d j|}t fd fd fd t |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``. 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*|jSN)_get_cache_value)xemptykeytypes [/var/www/mission/venv/lib/python3.12/site-packages/werkzeug/datastructures/cache_control.pyz(cache_control_property..1s!$$S%6c*|j|Sr )_set_cache_value)rvrrs rrz(cache_control_property..2sQ''Q5rc&|jSr )_del_cache_value)rrs rrz(cache_control_property..3s!$$S)rr)boolappend__name__joinpropertyr)rrrr partss``` rcache_control_propertyr! s& {#m,- 4< LL= >| \* tDMM?#67  r%*FGH LL6 7hhuo 65) SM  rc eZdZUdZeddeZded<eddeZ ded<ed deZ ded <ed deZ ded < d dfd Z ddZ ddZddZddZddZddZeeZxZS) _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-storeNrno_storezmax-age int | Nonemax_agez no-transform no_transformzstale-if-errorstale_if_errorc8t||||du|_yr )super__init__provided)selfvalues on_update __class__s rr+z_CacheControl.__init__Zs +d* rcr|tur||vS||vry||x}|S| ||}|S|S#t$rYywxYw+Used internally by the accessor properties.N)r ValueError)r-rrrvalues rrz_CacheControl._get_cache_valuebsf 4<$;  d?#Y E 'L   U  u   s * 66c|tur|rd||<y|j|dy||dur|j|dy|durd||<y|||}t|||<y)r3NFT)rpopstr)r-rr5rs rrz_CacheControl._set_cache_valuewsj 4< S d# ]eun HHS$  d]DIU E DIrc||vr||=yyr2)r-rs rrz_CacheControl._del_cache_values $;S  rc,tj|S)z6Convert the stored values into a cache control header.)http dump_headerr-s r to_headerz_CacheControl.to_headers%%rc"|jSr )r?r>s r__str__z_CacheControl.__str__s~~rcdjdt|jD}dt|jd|dS)Nr c30K|]\}}|d|yw)=Nr:).0krs r z)_CacheControl.__repr__..sH41aQCq,Hs<>)rsorteditemsrr)r-kv_strs r__repr__z_CacheControl.__repr__sAH6$**,3GHH4:&&'q22r)r:N)r.zBcabc.Mapping[str, t.Any] | cabc.Iterable[tuple[str, t.Any]] | Noner/z+cabc.Callable[[_CacheControl], None] | None)rr8rt.Anyrtype[t.Any] | NonereturnrN)rr8r5rNrrOrPNone)rr8rPrQ)rPr8)r __module__ __qualname____doc__r!rr$__annotations__intr&r'r(r+rrrr?rArM staticmethodcache_property __classcell__)r0s@rr#r#8s8,JdCHdC0D#FGZF/dKL$K!78H$PS!TNJTVXAE+R+?+$,> *##$#,># #& & 3""89Nrr#ceZdZUdZeddeZded<eddeZ ded <ed deZ d ed <ed deZ ded<y)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-cacheNrno_cachez max-staleTzint | t.Literal[True] | None max_stalez min-freshr% min_freshzonly-if-cachedonly_if_cached) rrRrSrTr!rr]rUrVr^r_r`r:rrr[r[sa)V,JdCHdC.D  /I+ 3;cJIzJ12BD$ONDOrr[c eZdZUdZedddZded<eddeZded<ed ddZ ded <ed deZ ded <ed deZ ded <edde Z ded<eddeZded<eddeZded<edde Zded<y)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]publicrprivatezmust-revalidatemust_revalidatezproxy-revalidateproxy_revalidatezs-maxager%s_maxage immutablezmust-understandmust_understandzstale-while-revalidatestale_while_revalidate)rrRrSrTr!r]rUrrcrdrerfrVrgrhrirjr:rrrbrbs)V.DD$.H**(D$?FD?,B4-G )33DdDQOTQ34FdSdS1*dCHHjH,[$EItE23DdDQOTQ)? $*Jrrb)r<) rr8rrNrrOr z str | NonerPrN) __future__rcollections.abcabccabctypingtinspectrmixinsr structuresrr!r8Optionalr#r[rbr<r:rrrws"&$LP* **"4*>H* *Zb:Lajjo!56b:J3P,S!**S/-ABM3Pl:=:|r