a 0h%@sddlmZddlmZddlZddlmZddl m Z ddl m Z dddd d d d d d dZ Gddde eejefZGddde eejefeZGdddeZddlmZdS)) annotationsN)cleandoc)ImmutableDictMixin) CallbackDictdocstrt.Anytype[t.Any] | Nonez str | None)keyemptytyperreturncs|durddg}tur*|dnLdur>|dn|djddurl|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 rS/var/www/auris/lib/python3.9/site-packages/werkzeug/datastructures/cache_control.py1z(cache_control_property..cs||Sr)_set_cache_value)rv)r rrrr2rcs |Sr)_del_cache_valuer)r rrr3rr)boolappend__name__joinpropertyr)r r rrpartsrrrcache_control_property s"      r#cseZdZUdZeddeZded<eddeZ ded<ed deZ ded <ed deZ ded <d'dddfdd Z dddddddZ dddddddZdddddZdd d!d"Zdd d#d$Zdd 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_errorrzBcabc.Mapping[str, t.Any] | cabc.Iterable[tuple[str, t.Any]] | Nonez+cabc.Callable[[_CacheControl], None] | None)values on_updatecst|||du|_dSr)super__init__provided)selfr*r+ __class__rrr-Zsz_CacheControl.__init__r r r )r r rrcCs^|tur||vS||vrdS||}dur0|S|durZz ||}WntyXYdS0|S+Used internally by the accessor properties.N)r ValueError)r/r r rvaluerrrrbs  z_CacheControl._get_cache_valueNone)r r5rrcCst|tur$|rd||<qp||dnL|dus4|durB||dn.|durTd||<n|durd||}t|||<dS)r3NFT)rpopr )r/r r5rrrrrws  z_CacheControl._set_cache_value)r rcCs||vr||=dSr2r)r/r rrrrsz_CacheControl._del_cache_value)rcCs t|S)z6Convert the stored values into a cache control header.)httpZ dump_headerr/rrr to_headersz_CacheControl.to_headercCs|Sr)r:r9rrr__str__sz_CacheControl.__str__cCs4dddt|D}dt|jd|dS)Nrcss |]\}}|d|VqdS)=Nr).0krrrr rz)_CacheControl.__repr__..<>)r sorteditemsrr)r/Zkv_strrrr__repr__sz_CacheControl.__repr__)rN)r __module__ __qualname____doc__r#rr%__annotations__intr'r(r)r-rrrr:r;rD staticmethodZcache_property __classcell__rrr0rr$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) rrErFrGr#rrNrHrIrOrPrQrrrrrLs + rLc@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. rMTNzstr | t.Literal[True] | NonerNpublicrprivatezmust-revalidatemust_revalidatezproxy-revalidateproxy_revalidatezs-maxager&s_maxage immutablezmust-understandmust_understandzstale-while-revalidatestale_while_revalidate)rrErFrGr#rNrHrrSrTrUrVrIrWrXrYrZrrrrrRs +  rR)r8) __future__rcollections.abcabcZcabctypingtinspectrZmixinsr structuresrr#r Optionalr$rLrRr8rrrrs     -e 6>