U (Q^9/@sddlmZddlmZddlmZddlmZddlmZddlmZddlm Z dd lm Z dd lm Z dd lm Z dd lm Z dd lmZddlmZddlmZddlmZddlmZddlmZGdddeZGdddeZdS))datetime) timedelta) string_types) CallbackDict)dump_age) dump_header)dump_options_header) http_date) parse_age) parse_date)parse_options_header)parse_set_header)cached_property)environ_property)get_content_type)header_property)get_content_lengthc@seZdZdZedddZeddZedddZed d dZ ed d dZ ed de ddZ edde ddZddZeddZeddZeddZdS)CommonRequestDescriptorsMixinzA mixin for :class:`BaseRequest` subclasses. Request objects that mix this class in will automatically get descriptors for a couple of HTTP headers with automatic type conversion. .. versionadded:: 0.5 CONTENT_TYPEThe Content-Type entity-header field indicates the media type of the entity-body sent to the recipient or, in the case of the HEAD method, the media type that would have been sent had the request been a GET.doccCs t|jS)zThe Content-Length entity-header field indicates the size of the entity-body in bytes or, in the case of the HEAD method, the size of the entity-body that would have been sent had the request been a GET. )renvironselfrJ/tmp/pip-install-bd4o36v9/Werkzeug/werkzeug/wrappers/common_descriptors.pycontent_length%sz,CommonRequestDescriptorsMixin.content_lengthZHTTP_CONTENT_ENCODINGaThe Content-Encoding entity-header field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type header field. .. versionadded:: 0.9ZHTTP_CONTENT_MD5aThe Content-MD5 entity-header field, as defined in RFC 1864, is an MD5 digest of the entity-body for the purpose of providing an end-to-end message integrity check (MIC) of the entity-body. (Note: a MIC is good for detecting accidental modification of the entity-body in transit, but is not proof against malicious attacks.) .. versionadded:: 0.9Z HTTP_REFERERzThe Referer[sic] request-header field allows the client to specify, for the server's benefit, the address (URI) of the resource from which the Request-URI was obtained (the "referrer", although the header field is misspelled).Z HTTP_DATENThe Date general-header field represents the date and time at which the message was originated, having the same semantics as orig-date in RFC 822.ZHTTP_MAX_FORWARDSzThe Max-Forwards request-header field provides a mechanism with the TRACE and OPTIONS methods to limit the number of proxies or gateways that can forward the request to the next inbound server.cCs"t|dst|jdd|_dS)N_parsed_content_typer)hasattrr rgetr rrrr_parse_content_type]s  z1CommonRequestDescriptorsMixin._parse_content_typecCs||jdS)zLike :attr:`content_type`, but without parameters (eg, without charset, type etc.) and always lowercase. For example if the content type is ``text/HTML; charset=utf-8`` the mimetype would be ``'text/html'``. r)r$r lowerrrrrmimetypecsz&CommonRequestDescriptorsMixin.mimetypecCs||jdS)zThe mimetype parameters as dict. For example if the content type is ``text/html; charset=utf-8`` the params would be ``{'charset': 'utf-8'}``. )r$r rrrrmimetype_paramsmsz-CommonRequestDescriptorsMixin.mimetype_paramscCst|jddS)ajThe Pragma general-header field is used to include implementation-specific directives that might apply to any recipient along the request/response chain. All pragma directives specify optional behavior from the viewpoint of the protocol; however, some systems MAY require that behavior be consistent with the directives. Z HTTP_PRAGMAr!)rrr#rrrrpragmavsz$CommonRequestDescriptorsMixin.pragma)__name__ __module__ __qualname____doc__r content_typerrcontent_encoding content_md5Zreferrerr dateintZ max_forwardsr$propertyr&r(r)rrrrrsL      rc@seZdZdZeddZejddZeddZeddd Z ed d e e d d Z ed dd Z edd eedd Zeddd Zeddd Zeddd Zedd eedd Zedd eedd Zedd eedd ZeddZejddZd(d d!Zed"d#d Zed$d%d Zed&d'd Z[d S))CommonResponseDescriptorsMixinzA mixin for :class:`BaseResponse` subclasses. Response objects that mix this class in will automatically get descriptors for a couple of HTTP headers with automatic type conversion. cCs&|jd}|r"|ddSdS)z0The mimetype (content type without charset etc.) content-type;rN)headersr#splitstrip)rctrrrr&s z'CommonResponseDescriptorsMixin.mimetypecCst||j|jd<dSN Content-Type)rcharsetr7rvaluerrrr&scs,fdd}tjddd}t||S)zThe mimetype parameters as dict. For example if the content type is ``text/html; charset=utf-8`` the params would be ``{'charset': 'utf-8'}``. .. versionadded:: 0.5 cstj|jd<dSr;)r r&r7)drrr on_updateszACommonResponseDescriptorsMixin.mimetype_params..on_updater5r!r')r r7r#r)rrAr@rrrr(s z.CommonResponseDescriptorsMixin.mimetype_paramsZLocationzThe Location response-header field is used to redirect the recipient to a location other than the Request-URI for completion of the request or identification of a new resource.rZAgeNa The Age response-header field conveys the sender's estimate of the amount of time since the response (or its revalidation) was generated at the origin server. Age values are non-negative decimal integers, representing time in seconds.r<rzContent-LengthaThe Content-Length entity-header field indicates the size of the entity-body, in decimal number of OCTETs, sent to the recipient or, in the case of the HEAD method, the size of the entity-body that would have been sent had the request been a GET.zContent-LocationzThe Content-Location entity-header field MAY be used to supply the resource location for the entity enclosed in the message when that entity is accessible from a location separate from the requested resource's URI.zContent-EncodingabThe Content-Encoding entity-header field is used as a modifier to the media-type. When present, its value indicates what additional content codings have been applied to the entity-body, and thus what decoding mechanisms must be applied in order to obtain the media-type referenced by the Content-Type header field.z Content-MD5alThe Content-MD5 entity-header field, as defined in RFC 1864, is an MD5 digest of the entity-body for the purpose of providing an end-to-end message integrity check (MIC) of the entity-body. (Note: a MIC is good for detecting accidental modification of the entity-body in transit, but is not proof against malicious attacks.)DaterZExpireszThe Expires entity-header field gives the date/time after which the response is considered stale. A stale cache entry may not normally be returned by a cache.z Last-ModifiedzThe Last-Modified entity-header field indicates the date and time at which the origin server believes the variant was last modified.cCs>|jd}|dkrdS|r6ttt|dSt|S)aThe Retry-After response-header field can be used with a 503 (Service Unavailable) response to indicate how long the service is expected to be unavailable to the requesting client. Time in seconds until expiration or date. retry-afterN)seconds)r7r#isdigitrutcnowrr2r r>rrr retry_afters  z*CommonResponseDescriptorsMixin.retry_aftercCsH|dkrd|jkr|jd=dSt|tr2t|}nt|}||jd<dS)NrCz Retry-After)r7 isinstancerr strr>rrrrG s   cs&fdd}fdd}t|||dS)Ncs fdd}tj|S)Ncs.|sjkrj=n|r*|j<dSN)r7Z to_header)Z header_set)namerrrrAs zMCommonResponseDescriptorsMixin._set_property..fget..on_update)rr7r#)rrArKrrfgetsz:CommonResponseDescriptorsMixin._set_property..fgetcs6|s|j=n$t|tr$||j<nt||j<dSrJ)r7rHrrr>rLrrfset s    z:CommonResponseDescriptorsMixin._set_property..fsetr)r3)rKrrMrNrrLr _set_propertys z,CommonResponseDescriptorsMixin._set_propertyZVaryzThe Vary field value indicates the set of request-header fields that fully determines, while the response is fresh, whether a cache is permitted to use the response to reply to a subsequent request without revalidation.zContent-LanguagezThe Content-Language entity-header field describes the natural language(s) of the intended audience for the enclosed entity. Note that this might not be equivalent to all the languages used within the entity-body.ZAllowaRThe Allow entity-header field lists the set of methods supported by the resource identified by the Request-URI. The purpose of this field is strictly to inform the recipient of valid methods associated with the resource. An Allow header field MUST be present in a 405 (Method Not Allowed) response.)N)r*r+r,r-r3r&setterr(rlocationr rZager.r2rIrcontent_locationr/r0r r r1expiresZ last_modifiedrGrOvaryZcontent_languageZallowrrrrr4s             r4N)rr_compatrZdatastructuresrhttprrr r r r r rutilsrrrrZwsgirobjectrr4rrrrs$                 l