U ڲg@sddlmZddlZddlZddlmZmZmZddlmZm Z m Z ddl m Z m Z mZe rhddlmZdZddd d d d d Zd ddddZGdddZGdddeZGdddeZGdddeZdS)) annotationsN)datetime timedeltatimezone) formatdate parsedate parsedate_tz) TYPE_CHECKINGAnyMapping) HTTPResponsez%a, %d %b %Y %H:%M:%S GMTrzdatetime | Noner)deltadatereturncCs|pttj}||SN)rnowrutc)r rr;/tmp/pip-unpacked-wheel-rew7nuve/cachecontrol/heuristics.py expire_aftersrstr)dtrcCstt|Sr)rcalendartimegm timetuple)rrrrdatetime_to_headersrc@s<eZdZdddddZdddddZdddd d Zd S) BaseHeuristicr str | NoneresponsercCsdS)a! Return a valid 1xx warning header value describing the cache adjustments. The response is provided too allow warnings like 113 http://tools.ietf.org/html/rfc7234#section-5.5.4 where we need to explicitly say response is over 24 hours old. z110 - "Response is Stale"rselfrrrrwarnings zBaseHeuristic.warningdict[str, str]cCsiS)zUpdate the response headers with any new headers. NOTE: This SHOULD always include some Warning header to signify that the response was cached by the client, not by way of the provided headers. rr rrrupdate_headers'szBaseHeuristic.update_headerscCs@||}|r<|j|||}|dk r<|jd|i|S)NWarning)r$headersupdater")r!rZupdated_headersZwarning_header_valuerrrapply0s   zBaseHeuristic.applyN)__name__ __module__ __qualname__r"r$r(rrrrrs  rc@s eZdZdZdddddZdS) OneDayCachezM Cache the response by providing an expires 1 day in the future. r r#rcCsZi}d|jkrVt|jd}ttddt|dddtjid}t||d<d|d <|S) Nexpiresr)daystzinfo)rpublic cache-control)r&rrrrrrr)r!rr&rr-rrrr$Bs  zOneDayCache.update_headersN)r)r*r+__doc__r$rrrrr,<sr,c@s@eZdZdZdddddZddd d d Zdd d d dZdS) ExpiresAfterz; Cache **all** requests for a defined time period. r None)kwrcKstf||_dSr)rr )r!r7rrr__init__UszExpiresAfter.__init__r r#rcCst|j}t|ddS)Nr2)r-r3)rr r)r!rr-rrrr$Xs zExpiresAfter.update_headersrcCsd}||jS)Nz:110 - Automatically cached for %s. Response might be stale)r )r!rtmplrrrr"\szExpiresAfter.warningN)r)r*r+r4r8r$r"rrrrr5Psr5c @sJeZdZdZdddddddd d d d h Zd ddddZd ddddZdS) LastModifieda If there is no Expires header already, fall back on Last-Modified using the heuristic from http://tools.ietf.org/html/rfc7234#section-4.2.2 to calculate a reasonable value. Firefox also does something like this per https://developer.mozilla.org/en-US/docs/Web/HTTP/Caching_FAQ http://lxr.mozilla.org/mozilla-release/source/netwerk/protocol/http/nsHttpResponseHead.cpp#397 Unlike mozilla we limit this to 24-hr. i,i-iiiiir r#)resprc Cs|j}d|kriSd|kr*|ddkr*iS|j|jkr:iSd|ksJd|krNiSt|d}|dk sftt|dd}t|d}|dkriSt}t d||}|t|}t dt |dd } | |kriS|| } dt t t | iS) Nr-r3r2rz last-modifiedr0r iQ)r&statuscacheable_by_default_statusesrAssertionErrorrrrtimemaxminstrftimeTIME_FMTgmtime) r!r?r&Z time_tuplerZ last_modifiedr current_ager freshness_lifetimer-rrrr$|s.    zLastModified.update_headersrcCsdSrr)r!r?rrrr"szLastModified.warningN)r)r*r+r4rBr$r"rrrrr:as  r:)N) __future__rrrDrrr email.utilsrrrtypingr r r urllib3r rHrrrr,r5r:rrrrs  !