U 'e@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 rr6lib/python3.8/site-packages/cachecontrol/heuristics.py expire_aftersrstr)dtrcCstt|Sr)rcalendartimegmZ 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. rrrrrupdate_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)ZdaysZtzinfo)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 r4rrr__init__RszExpiresAfter.__init__r r"rcCst|j}t|ddS)Nr/)r,r0)rr r)r rr,rrrr#Us zExpiresAfter.update_headersrcCsd}||jS)Nz:110 - Automatically cached for %s. Response might be stale)r )r rZtmplrrrr!YszExpiresAfter.warningN)r(r)r*r1r5r#r!rrrrr2Msr2c @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,r0r/rz last-modifiedr.r iQ)r%statuscacheable_by_default_statusesrAssertionErrorrrrtimemaxminstrftimeTIME_FMTgmtime) r r;r%Z time_tuplerZ last_modifiedrZ current_ager Zfreshness_lifetimer,rrrr#ys.    zLastModified.update_headersrcCsdSrr)r r;rrrr!szLastModified.warningN)r(r)r*r1r>r#r!rrrrr6^s  r6)N)Z __future__rrr@rrrZ email.utilsrrrtypingr r r Zurllib3r rDrrrr+r2r6rrrrs  !