o j%@sddlmZddlmZddlZddlmZddl m Z ddl m Z dddddZ Gddde eejefZGddde eejefeZGdddeZddlmZdS)) annotationsN)cleandoc)ImmutableDictMixin) CallbackDictdockeystremptyt.Anytypetype[t.Any] | Noner str | Nonereturncs|dur@ddg}tur|dn&dur|dn |djddur6|dd |d d |}tfd d fdd fdd t|dS)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. cs|SN)_get_cache_valuexr r r /root/aizidognhua/tmp/workspace/projects/ec89d86c-575f-41c9-af57-ac45cbdbf775/venv/lib/python3.10/site-packages/werkzeug/datastructures/cache_control.py1z(cache_control_property..cs||Sr)_set_cache_value)rv)r r rrr2rcs |Sr)_del_cache_valuer)r rrr3s r)boolappend__name__joinpropertyr)r r r rpartsrrrcache_control_property s"      r$cseZdZUdZeddeZded<eddeZ ded<ed deZ ded <ed deZ ded < d)d*fdd Z d+ddZ d,dd Zd-d!d"Zd.d#d$Zd.d%d&Zd.d'd(ZeeZZS)/ _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_errorrvaluesBcabc.Mapping[str, t.Any] | cabc.Iterable[tuple[str, t.Any]] | None on_update+cabc.Callable[[_CacheControl], None] | Nonecst|||du|_dSr)super__init__provided)selfr+r- __class__rrr0Zsz_CacheControl.__init__r r r r r rrcCs`|tur||vS||vrdS||}dur|S|dur.z||}W|Sty-YdSw|S+Used internally by the accessor properties.N)r ValueError)r2r r r valuerrrrbs  z_CacheControl._get_cache_valuer8NonecCs||tur|r d||<dS||ddS|dus|dur$||ddS|dur.d||<dS|dur6||}t|||<dS)r6NFT)rpopr )r2r r8r rrrrws  z_CacheControl._set_cache_valuecCs||vr ||=dSdSr5r)r2r rrrrs z_CacheControl._del_cache_valuecCs t|S)z6Convert the stored values into a cache control header.)http dump_headerr2rrr to_headers z_CacheControl.to_headercCs|Sr)r>r=rrr__str__sz_CacheControl.__str__cCs4dddt|D}dt|jd|dS)Nrcss"|] \}}|d|VqdS)=Nr).0krrrr s z)_CacheControl.__repr__..<>)r!sorteditemsr r )r2kv_strrrr__repr__sz_CacheControl.__repr__)rN)r+r,r-r.)r r r r r rrr )r r r8r r rrr9)r r rr9)rr )r __module__ __qualname____doc__r$rr&__annotations__intr(r)r*r0rrrr>r?rI staticmethodcache_property __classcell__rrr3rr%8s       r%c@sbeZdZUdZeddeZded<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-cacheNrno_cachez max-staleTzint | t.Literal[True] | None max_stalez min-freshr' min_freshzonly-if-cachedonly_if_cached) r rJrKrLr$rrTrMrNrUrVrWrrrrrRs + rRc@seZdZUdZedddZded<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. rSTNzstr | t.Literal[True] | NonerTpublicrprivatezmust-revalidatemust_revalidatezproxy-revalidateproxy_revalidatezs-maxager's_maxage immutablezmust-understandmust_understandzstale-while-revalidatestale_while_revalidate)r rJrKrLr$rTrMrrYrZr[r\rNr]r^r_r`rrrrrXs" +  rX)r;) r r r r r rrrrr ) __future__rcollections.abcabccabctypingtinspectrmixinsr structuresrr$r Optionalr%rRrXr;rrrrs    - e6>