3 []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_TYPEzThe 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. )renviron)selfrH/tmp/pip-build-w1as9q70/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_DATENzThe 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|jjdd|_dS)N_parsed_content_typer)hasattrr rgetr)rrrr_parse_content_type]s z1CommonRequestDescriptorsMixin._parse_content_typecCs|j|jdjS)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 rlower)rrrrmimetypecsz&CommonRequestDescriptorsMixin.mimetypecCs|j|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|jjddS)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%rrrrrs8  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&|jjd}|r"|jddjSdS)z0The mimetype (content type without charset etc.)z content-type;rN)headersrsplitstrip)rctrrrr"s z'CommonResponseDescriptorsMixin.mimetypecCst||j|jd<dS)Nz Content-Type)rcharsetr2)rvaluerrrr"scs,fdd}tjjddd}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<dS)Nz Content-Type)r r"r2)d)rrr on_updateszACommonResponseDescriptorsMixin.mimetype_params..on_updatez content-typerr#)r r2rr)rr9r8r)rrr$s z.CommonResponseDescriptorsMixin.mimetype_paramsLocationzThe 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.z Content-TypezThe 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.zContent-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.)DatezThe 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.ZExpireszThe 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>|jjd}|dkrdS|jr6tjtt|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. z retry-afterN)seconds)r2risdigitrutcnowrr.r )rr7rrr retry_afters  z*CommonResponseDescriptorsMixin.retry_aftercCsH|dkrd|jkr|jd=dSt|tr2t|}nt|}||jd<dS)Nz retry-afterz Retry-After)r2 isinstancerr str)rr7rrrr? s   cs&fdd}fdd}t|||dS)Ncs fdd}tjj|S)Ncs0| rjkrj=n|r,|jj<dS)N)r2Z to_header)Z header_set)namerrrr9s zMCommonResponseDescriptorsMixin._set_property..fget..on_update)rr2r)rr9)rB)rrfgetsz:CommonResponseDescriptorsMixin._set_property..fgetcs6|s|j=n$t|tr$||j<nt||j<dS)N)r2r@rr)rr7)rBrrfset s    z:CommonResponseDescriptorsMixin._set_property..fset)r)r/)rBrrCrDr)rBr _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)r/r"setterr$rlocationr rZager*r.rArcontent_locationr+r,r r r-expiresZ last_modifiedr?rEvaryZcontent_languageZallowrrrrr0s|    r0N)rr_compatrZdatastructuresrhttprrr r r r r rutilsrrrrZwsgirobjectrr0rrrrs$                 l