B `@sddlZddlZddlZddlmZddlmZmZddlmZddl m Z ddl m Z m Z ddlmZmZmZmZmZmZmZddlmZmZdd lmZmZmZdd lmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,dd l-m.Z.dd l/m0Z0dd l1m2Z2m3Z3m4Z4y ddl5Z6Wne7k r>ddl6Z6YnXdgZ8e9dej:Z;e9dej:ZZ?Gddde>Z@d+ddZAd,ddZBGddde>ZCGddde>ZDGddde>ZEdd ZFd!d"ZGd#d$ZHd%d&ZId'd(ZJd)d*ZKdS)-N) b64encode)datetime timedelta)md5) ContentRange) CacheControlserialize_cache_control)PY2bytes_native_ string_types text_type url_quoteurlparse)Cookie make_cookie)parse_date_deltaserialize_date_deltatimedelta_to_seconds) CHARSET_RE SCHEME_RE converter date_header header_getter list_header parse_authparse_content_rangeparse_etag_response parse_intparse_int_safeserialize_authserialize_content_rangeserialize_etag_response serialize_int)ResponseHeaders) BaseRequest)status_generic_reasonsstatus_reasonswarn_deprecationResponsez(([a-z0-9]+)=(?:"([^"]*)"|([a-z0-9_.-]*))z^[a-z0-9_.-]+$s c @s4eZdZdZdZdZdZdZdZdZ dZ dddddde fddZ e d d Zd d Zd dZdddZddZddZeeeejdZddZddZeeeejdZZddZddZddZeeeeejdZd d!Zd"d#ZeeeejdZ d$d%Z!dd'd(Z"ee!e"e"Z#d)d*Z$d+d,Z%d-d.Z&ee$e%e&Z'Z(d/d0Z)ee)Z*d1d2Z+d3d4Z,d5d6Z-ee+e,e-e+jdZ.ee+e,e-d7Z/Z0d8d9Z1d:d;Z2dd?Z5d@dAZ6dBdCZ7dDdEZ8ee6e7e8e6jdZ9e:dFdGZ;e:dHdIZdJdKe?e@dLZAe>dMdNZBe:dOdPZCe>dQdRZDe>dSdRZEe>dTdUZFe>dVdWZGe=e>dXdYeHeIdZZJeKd[d\ZLeKd]d^ZMeKd_d`ZNe>dadbZOe=eOePeQdcZRedddeZSe>dfdgZTe>dhdiZUe=e>djdkeVe@dLZWe=e>dldmeXeYdnZZe>dodpZ[e=e>dqdre\e]Z^dsdtZ_dudvZ`dwdxZaee_e`eae_jdZbdydzZcd{d|Zdd}d~ZeeecedeeecjdZfddZgddZhddZieegeheiegjZjdddZkdddZldddZmddZndZoddZpddZqddZrddZseepeqerepjdZtdddZueddeuZvdddZwddZxdddZyezddZ{ddZ|ddZ}dZ~ddZddZdS)r)a Represents a WSGI response. If no arguments are passed, creates a :class:`~Response` that uses a variety of defaults. The defaults may be changed by sub-classing the :class:`~Response`. See the :ref:`sub-classing notes `. :cvar ~Response.body: If ``body`` is a ``text_type``, then it will be encoded using either ``charset`` when provided or ``default_encoding`` when ``charset`` is not provided if the ``content_type`` allows for a ``charset``. This argument is mutually exclusive with ``app_iter``. :vartype ~Response.body: bytes or text_type :cvar ~Response.status: Either an :class:`int` or a string that is an integer followed by the status text. If it is an integer, it will be converted to a proper status that also includes the status text. Any existing status text will be kept. Non-standard values are allowed. :vartype ~Response.status: int or str :cvar ~Response.headerlist: A list of HTTP headers for the response. :vartype ~Response.headerlist: list :cvar ~Response.app_iter: An iterator that is used as the body of the response. Should conform to the WSGI requirements and should provide bytes. This argument is mutually exclusive with ``body``. :vartype ~Response.app_iter: iterable :cvar ~Response.content_type: Sets the ``Content-Type`` header. If no ``content_type`` is provided, and there is no ``headerlist``, the ``default_content_type`` will be automatically set. If ``headerlist`` is provided then this value is ignored. :vartype ~Response.content_type: str or None :cvar conditional_response: Used to change the behavior of the :class:`~Response` to check the original request for conditional response headers. See :meth:`~Response.conditional_response_app` for more information. :vartype conditional_response: bool :cvar ~Response.charset: Adds a ``charset`` ``Content-Type`` parameter. If no ``charset`` is provided and the ``Content-Type`` is text, then the ``default_charset`` will automatically be added. Currently the only ``Content-Type``'s that allow for a ``charset`` are defined to be ``text/*``, ``application/xml``, and ``*/*+xml``. Any other ``Content-Type``'s will not have a ``charset`` added. If a ``headerlist`` is provided this value is ignored. :vartype ~Response.charset: str or None All other response attributes may be set on the response by providing them as keyword arguments. A :exc:`TypeError` will be raised for any unexpected keywords. .. _response_subclassing_notes: **Sub-classing notes:** * The ``default_content_type`` is used as the default for the ``Content-Type`` header that is returned on the response. It is ``text/html``. * The ``default_charset`` is used as the default character set to return on the ``Content-Type`` header, if the ``Content-Type`` allows for a ``charset`` parameter. Currently the only ``Content-Type``'s that allow for a ``charset`` are defined to be: ``text/*``, ``application/xml``, and ``*/*+xml``. Any other ``Content-Type``'s will not have a ``charset`` added. * The ``unicode_errors`` is set to ``strict``, and access on a :attr:`~Response.text` will raise an error if it fails to decode the :attr:`~Response.body`. * ``default_conditional_response`` is set to ``False``. This flag may be set to ``True`` so that all ``Response`` objects will attempt to check the original request for conditional response headers. See :meth:`~Response.conditional_response_app` for more information. * ``default_body_encoding`` is set to 'UTF-8' by default. It exists to allow users to get/set the ``Response`` object using ``.text``, even if no ``charset`` has been set for the ``Content-Type``. z text/htmlzUTF-8strictFNcKsx|dkr^|dkr^d|ks d|kr^d|kr4|d} n |d} tj| ddd}|dkr^d}|dkrt|dkrd}n|dk rtd|dkrd |_n||_d|_|dkrg|_n||_d} |t k r|} |jd d ko|jdd d k} |p|j }|dkrp| rp|rpd|k} | rd} | } | s:|t kr:|j r:|j } | r`|dksTt |r`|d| 7}|j d|f|dkr|j|_n t||_|dkr| rt|tr| p|j} | dkrtd|| }|g}|dk rdd|jD|jdd<|j dtt|fn|dkr,| s,dg}||_x@|D]4\}}t|j|sbtd||ft|||q0sz%Response.__init__..zContent-LengthzUnexpected keyword: %s=%r)popr,dumpsencode TypeError_statusstatus_headers _headerlist_markerdefault_content_typedefault_charset_content_type_has_charsetappenddefault_conditional_responseconditional_responsebool isinstancer charsetstrlen _app_iteritemshasattr __class__setattr)selfbodyr? headerlistapp_iter content_typerHrKkwr+encodingZ code_has_body has_charset new_charsetnamevaluer7r7r8__init__s~                  zResponse.__init__cCsg}|}t|t}|r(d}d}nd}d}||r`|dd\}}} dt|t| f}xn|} | stPy| |d\} } Wn tk rtd | YnX| } |t| d t| d fqbW|||d d } | | j pd }|r|| _ n|| _ | S)apReads a response from a file-like object (it must implement ``.read(size)`` and ``.readline()``). It will read up to the end of the response, not the end of the file. This reads the response as represented by ``str(resp)``; it may not read every valid HTTP response properly. Responses must have a ``Content-Length``.r.zHTTP/:sHTTP/Nz%s %szBad header line: %rzlatin-1r7)r?rUrVr) readlinestriprJr startswithsplitr ValueErrorrFreadcontent_lengthtextrT)clsfprUr?Zis_textZ_colonZ_httpZhttp_verZ status_numZ status_textline header_namer]rrTr7r7r8 from_fileCs@     zResponse.from_filecCs>t|j}t|jt||_|j|j|jdd||jdS)zMakes a copy of the response.N)r?rUrVrH)listrN iter_closerQr>rArH)rSrVr7r7r8copyws    z Response.copycCsd|jjtt||jfS)Nz<%s at 0x%x %s>)rQ__name__absidr?)rSr7r7r8__repr__szResponse.__repr__cCsP|jg}|s|j|tdj|j7}|sF|jrF|dtr<|jn|jg7}d|S)Nz%s: %sz )r?rTmap__mod__rUr rijoin)rSZ skip_bodypartsr7r7r8__str__s zResponse.__str__cCs|jS)z$ The status string. )r>)rSr7r7r8 _status__getszResponse._status__getc Csy t|}Wnttfk r$Yn X||_dStsJt|tr^|d}nt|tr^| d}t|t sxtdt |yt| dWntk rtdYnX||_ dS)Nasciiz3You must set status to a string or integer (not %s)rz&Invalid status code, integer required.)intrfr= status_coder rJbytesdecoder r<rLtyperer>)rSr]coder7r7r8 _status__sets(       zResponse._status__set)doccCst|jdS)z+ The status as an integer. r)rr>re)rSr7r7r8_status_code__getszResponse._status_code__getcCsFyd|t|f|_Wn*tk r@d|t|df|_YnXdS)Nz%d %sd)r'r>KeyErrorr&)rSrr7r7r8_status_code__setszResponse._status_code__setcCs|jS)z/ The list of response headers. )rA)rSr7r7r8_headerlist__getszResponse._headerlist__getcCs4d|_t|ts*t|dr"|}t|}||_dS)NrO)r@rJrprPrOrA)rSr]r7r7r8_headerlist__sets   zResponse._headerlist__setcCs g|_dS)N)rU)rSr7r7r8_headerlist__delszResponse._headerlist__delcCs|jdkrt|j|_|jS)z: The headers in a dictionary-like object. N)r@r$Z view_listrA)rSr7r7r8 _headers__gets zResponse._headers__getcCs"t|dr|}||_d|_dS)NrO)rPrOrUr@)rSr]r7r7r8 _headers__sets zResponse._headers__setcCs|j}t|tr$t|dkr$|dS|dkr4tdzd|}Wdt|Xt|trbt|||g|_t|dkrxn:|j dkrt||_ n$|j t|krt d|j t|f|S)z} The body of the response, as a :class:`bytes`. This will read in the entire app_iter if necessary. rarNzNo body has been setr0z@Content-Length is different from actual app_iter length (%r!=%r)) rNrJrprMAttributeErrorrzrqr _error_unicode_in_app_iterrhAssertionError)rSrVrTr7r7r8 _body__gets(      zResponse._body__getr0cCsTt|ts.t|trd}n dt|}t||jdk r>d|_|g|_t||_dS)NzAYou cannot set Response.body to a text object (use Response.text)z3You can only set the body to a binary type (not %s)) rJrr rr=rN content_md5rMrh)rSr]msgr7r7r8 _body__sets    zResponse._body__setcCst|jdS)aB Set/get the body of the response as JSON. .. note:: This will automatically :meth:`~bytes.decode` the :attr:`~Response.body` as ``UTF-8`` on get, and :meth:`~str.encode` the :meth:`json.dumps` as ``UTF-8`` before assigning to :attr:`~Response.body`. zUTF-8)r,loadsrTr)rSr7r7r8_json_body__get1s zResponse._json_body__getcCstj|ddd|_dS)N)r-r.)r/zUTF-8)r,r;r<rT)rSr]r7r7r8_json_body__set@szResponse._json_body__setcCs|`dS)N)rT)rSr7r7r8_json_body__delCszResponse._json_body__delcCs@|j}t|tr0t|dkr0|ddkr,dSdS|dkrsz!Response.write..)rJrr r=rrKr<rNrprqsumrhrFrM)rSrirrVZ new_app_iterr7r7r8writes$       zResponse.writecCs|jS)z Returns the ``app_iter`` of the response. If ``body`` was set, this will create an ``app_iter`` from that ``body`` (a single-item list). )rN)rSr7r7r8_app_iter__getszResponse._app_iter__getcCs|jdk rd|_||_dS)N)rNrh)rSr]r7r7r8_app_iter__sets zResponse._app_iter__setcCsg|_d|_dS)N)rNrh)rSr7r7r8_app_iter__delszResponse._app_iter__delZAllowz14.7ZVaryz14.44zContent-Lengthz14.17rzContent-Encodingz14.11zContent-Languagez14.12zContent-Locationz14.14z Content-MD5zContent-Dispositionz19.5.1z Accept-Rangesz14.5z Content-Rangez14.16zContentRange objectDatez14.18ZExpiresz14.21z Last-Modifiedz14.29ETagz14.19z Entity tagcCst|jddS)NT)strong)r _etag_raw)rSr7r7r8 etag_strongszResponse.etag_strongZLocationz14.30ZPragmaz14.32ZAgez14.6z Retry-Afterz14.37zHTTP date or delta secondsServerz14.38zWWW-Authenticatez14.47cCs0|jd}|sdSt|}|r,|dSdS)z Get/set the ``charset`` specified in ``Content-Type``. There is no checking to validate that a ``content_type`` actually allows for a ``charset`` parameter. z Content-TypeNra)headersgetrsearchgroup)rSheadermatchr7r7r8 _charset__gets   zResponse._charset__getcCsz|dkr|dS|jdd}|dkr2tdt|}|r`|d|||d}|d|7}||jd<dS)Nz Content-Typez:You cannot set the charset when no content-type is definedz ; charset=%s) _charset__delrrrrrstartend)rSrKrrr7r7r8 _charset__sets   zResponse._charset__setcCsV|jdd}|dkrdSt|}|rH|d|||d}||jd<dS)Nz Content-Type)rr:rrrr)rSrrr7r7r8r#s  zResponse._charset__delcCs$|jd}|sdS|dddS)a Get/set the ``Content-Type`` header. If no ``Content-Type`` header is set, this will return ``None``. .. versionchanged:: 1.7 Setting a new ``Content-Type`` will remove all ``Content-Type`` parameters and reset the ``charset`` to the default if the ``Content-Type`` is ``text/*`` or XML (``application/xml`` or ``*/*+xml``). To preserve all ``Content-Type`` parameters, you may use the following code: .. code-block:: python resp = Response() params = resp.content_type_params resp.content_type = 'application/something' resp.content_type_params = params z Content-TypeN;rar)rrre)rSrr7r7r8_content_type__get4s zResponse._content_type__getcCs|s|dStr(t|tr(|d}t|ts:td|}d|k}d}|sZ|jrZ|j}|rz|dksnt|rz|d|7}||j d<dS)Nzlatin-1z1content_type requires value to be of string_typeszcharset=z text/htmlz ; charset=z Content-Type) _content_type__delr rJr r<r r=rDrEr)rSr]rWrZr[r7r7r8_content_type__setOs$   zResponse._content_type__setcCs|jdddS)Nz Content-Type)rr:)rSr7r7r8rxszResponse._content_type__delcCsh|jdd}d|kriS|ddd}i}x4t|D]&}|dpT|dpTd||d<q:W|S)z A dictionary of all the parameters in the content type. (This is not a view, set to change, modifications of the dict will not be applied otherwise.) z Content-Typerwrrar`r2)rrre _PARAM_REfinditerr)rSparamsresultrr7r7r8_content_type_params__gets&z"Response._content_type_params__getcCs|s|dSg}xDt|D]4\}}t|sDd|dd}|d||fq"W|jdd ddd }|d |7}||jd<dS) Nz"%s""z\"z; %s=%sz Content-Typerwrrar) _content_type_params__delsortedrO _OK_PARAM_RErreplacerFrr:rerz)rSZ value_dictrr5r6ctr7r7r8_content_type_params__sets z"Response._content_type_params__setcCs$|jddddd|jd<dS)Nz Content-Typerwrrar)rrre)rSr7r7r8rsz"Response._content_type_params__delrw/c Cs| rtddd| r"|j|dd|s4t| tr4| }|spt| trp| jrd| rd| | jdd} | t}t |d}t ||||||||| d } |j d | fdS) a Set (add) a cookie for the response. Arguments are: ``name`` The cookie name. ``value`` The cookie value, which should be a string or ``None``. If ``value`` is ``None``, it's equivalent to calling the :meth:`webob.response.Response.unset_cookie` method for this cookie key (it effectively deletes the cookie on the client). ``max_age`` An integer representing a number of seconds, ``datetime.timedelta``, or ``None``. This value is used as the ``Max-Age`` of the generated cookie. If ``expires`` is not passed and this value is not ``None``, the ``max_age`` value will also influence the ``Expires`` value of the cookie (``Expires`` will be set to ``now`` + ``max_age``). If this value is ``None``, the cookie will not have a ``Max-Age`` value (unless ``expires`` is set). If both ``max_age`` and ``expires`` are set, this value takes precedence. ``path`` A string representing the cookie ``Path`` value. It defaults to ``/``. ``domain`` A string representing the cookie ``Domain``, or ``None``. If domain is ``None``, no ``Domain`` value will be sent in the cookie. ``secure`` A boolean. If it's ``True``, the ``secure`` flag will be sent in the cookie, if it's ``False``, the ``secure`` flag will not be sent in the cookie. ``httponly`` A boolean. If it's ``True``, the ``HttpOnly`` flag will be sent in the cookie, if it's ``False``, the ``HttpOnly`` flag will not be sent in the cookie. ``samesite`` A string representing the ``SameSite`` attribute of the cookie or ``None``. If samesite is ``None`` no ``SameSite`` value will be sent in the cookie. Should only be ``"strict"``, ``"lax"``, or ``"none"``. ``comment`` A string representing the cookie ``Comment`` value, or ``None``. If ``comment`` is ``None``, no ``Comment`` value will be sent in the cookie. ``expires`` A ``datetime.timedelta`` object representing an amount of time, ``datetime.datetime`` or ``None``. A non-``None`` value is used to generate the ``Expires`` value of the generated cookie. If ``max_age`` is not passed, but this value is not ``None``, it will influence the ``Max-Age`` header. If this value is ``None``, the ``Expires`` cookie value will be unset (unless ``max_age`` is set). If ``max_age`` is set, it will be used to generate the ``expires`` and this value is ignored. If a ``datetime.datetime`` is provided it has to either be timezone aware or be based on UTC. ``datetime.datetime`` objects that are local time are not supported. Timezone aware ``datetime.datetime`` objects are converted to UTC. This argument will be removed in future versions of WebOb (version 1.9). ``overwrite`` If this key is ``True``, before setting the cookie, unset any existing cookie. zVArgument "expires" will be removed in a future version of WebOb, please use "max_age".g?raF)r*N)tzinfozutf-8)max_agepathdomainsecurehttponlycommentsamesitez Set-Cookie) r( unset_cookierJrrr utcoffsetrutcnowr rrUrF) rSr\r]rrrrrrexpires overwritercookier7r7r8 set_cookies ]    zResponse.set_cookiecCs|j|d||ddS)z Delete a cookie from the client. Note that ``path`` and ``domain`` must match how the cookie was originally set. This sets the cookie to the empty string, and ``max_age=0`` so that it should expire immediately. N)rr)r)rSr\rrr7r7r8 delete_cookie'szResponse.delete_cookieTcCs|jd}|s|sdSt}x|D]}||q$Wt|trJ|d}||kr||=|jd=x6|D]}|j d| fqjWn|rt d|dS)zS Unset a cookie with the given name (remove it from the response). z Set-CookieNutf8z'No cookie has been set with the name %r) rgetallrloadrJr r<valuesrUrF serializer)rSr\r*existingcookiesrmr7r7r8r1s    zResponse.unset_cookiecsh|jdsSttrBx"|jdD]}jd|q(WSdd|jDfdd}|SdS)zMerge the cookies that were set on this response with the given ``resp`` object (which can be any WSGI application). If the ``resp`` is a :class:`webob.Response` object, then the other object will be modified in-place. z Set-CookiecSs g|]}|ddkr|qS)rz set-cookie)r3)r4hr7r7r8r9Ssz*Response.merge_cookies..csdfdd }||S)Ncs|||dS)N)exc_infor7)r?rr) c_headersstart_responser7r8repl_start_responseVs zEResponse.merge_cookies..repl_app..repl_start_response)Nr7)environrr)rresp)rr8repl_appUsz(Response.merge_cookies..repl_appN)rrrJr)raddrU)rSrrrr7)rrr8 merge_cookiesEs  zResponse.merge_cookiescCsx|jdd}|jdkr4tj||jdd|_||j_|jj|krrtj|dd}|jj|jj |j||j_|jS)z Get/set/modify the Cache-Control header (`HTTP spec section 14.9 `_). z cache-controlrwNresponse)Z updates_tor)r) rr_cache_control_objrparse_update_cache_control header_value propertiesclearupdate)rSr]Znew_objr7r7r8_cache_control__getbs   zResponse._cache_control__getcCs~|sd}t|trt|d}t|tr.t|}t|tr\|jdkrP||jd<dSt|d}|j}|j |j |j dS)Nrwrz Cache-Control) rJdictrr rLrrr cache_controlrrr)rSr]cacher7r7r8_cache_control__setss        zResponse._cache_control__setcCs i|_dS)N)r)rSr7r7r8_cache_control__delszResponse._cache_control__delcCs.t|}|s d|jkr*|jd=n ||jd<dS)Nz Cache-Control)rr)rSZ prop_dictr]r7r7r8rs   zResponse._update_cache_controlrcKs|dkrd}nt|tr t|}|j}|dkr0nx|s~d|_d|_d|_d|_d|_d|_ t |_ d|j krvt |_d|_n*|j||_t t|d|_ d|_x |D]\}}t|||qWdS)z Set expiration on this request. This sets the response to expire in the given seconds, and any other attributes are used for ``cache_control`` (e.g., ``private=True``). TrNz last-modifiedzno-cache)seconds)rJrrrno_storeno_cacheZmust_revalidaterZ post_checkZ pre_checkrrrr last_modifiedpragmarrrOrR)rSrrXrr\r]r7r7r8_cache_expiress0     zResponse._cache_expirescCs|jS)N)r)rSr7r7r8r0zResponse.gzipcCsz|dkstd||dkr(|dS|jdkr6dS|rNt|j|_d|_n"tt|j|_tt t |j|_d|_dS)zt Encode the content with the given encoding (only ``gzip`` and ``identity`` are supported). )identityrzUnknown encoding: %rrNr) rdecode_contentcontent_encoding gzip_app_iterrNrVrhrprrxrM)rSrYZlazyr7r7r8encode_contents    zResponse.encode_contentcCs|jpd}|dkrdS|dkr*td||dkrxddlm}ddlm}|dd ||jd }||_d|_|n@yt |j|_Wn&t j k rt |jd |_YnXd|_dS) Nr)rdeflatez)I don't know how to decode the content %srr)GzipFile)BytesIOrwrn)filenamemodefileobji) r rfrriorrTrgclosezlib decompresserror)rSr rrZgzip_fr7r7r8r s$      zResponse.decode_contentcCsP|dkr|j}t|}t|}|dd}t|}|d|_|rL||_dS)a Generate an etag for the response object using an MD5 hash of the body (the ``body`` parameter, or ``self.body`` if not given). Sets ``self.etag``. If ``set_content_md5`` is ``True``, sets ``self.content_md5`` as well. N r0=) rTrdigestrrr rcetagr)rSrTZset_content_md5Z md5_digestr7r7r8md5_etags    zResponse.md5_etagcCs"t|r|Stt||}|S)N)rrrurljoin _request_uri)rr]Z new_locationr7r7r8_make_location_absolutes z Response._make_location_absolutecsfddjDS)Ncs4g|],\}}|dkr ||fn||fqS)location)r3r)r4r5r6)rrSr7r8r9 sz,Response._abs_headerlist..)rA)rSrr7)rrSr8_abs_headerlist s zResponse._abs_headerlistcCsD|jr|||S||}||j||ddkr>t|jS|jS)z, WSGI application interface REQUEST_METHODHEAD)rHconditional_response_appr!r? EmptyResponserN)rSrrrUr7r7r8__call__s     zResponse.__call__)GETr#c Cst|}||}|dd}||jkrzd}|jrF|jrF|j|jk}n|jr^|jr^|j|jk}|rz|dt|t |j S|j r||j kr|j dkr|dkr|jdkr|jdk r|j |j}|dkr:t|j td|j }d tt|fd ttdd|jfd gt|}|d ||d kr4dS|gS||j|j} | dk r|jdk sdtd t|j|jfd t|fgt|d}|d||d krt | S| S||j||d krt |j S|j S)a Like the normal ``__call__`` interface, but checks conditional headers: * ``If-Modified-Since`` (``304 Not Modified``; only on ``GET``, ``HEAD``) * ``If-None-Match`` (``304 Not Modified``; only on ``GET``, ``HEAD``) * ``Range`` (``406 Partial Content``; only on ``GET``, ``HEAD``) r"r'Fz304 Not ModifiedN)r#r'z#Requested range not satisfiable: %szContent-Lengthz Content-Range)z Content-Typez text/plainz#416 Requested Range Not Satisfiabler#r7)zcontent-lengthz206 Partial Content)r%r!r _safe_methodsZ if_none_matchrZif_modified_sincerfilter_headersr%rNrangeZif_range content_rangerrhrqr rLrMrapp_iter_rangerstoprr?) rSrrreqrUmethodZ status304r,rTrVr7r7r8r$(s^                          z!Response.conditional_response_appcCs(|j}t|dr|||St|||S)z Return a new ``app_iter`` built from the response ``app_iter``, that serves up only the given ``start:stop`` range. r-)rNrPr- AppIterRange)rSrr.rVr7r7r8r-ms  zResponse.app_iter_range)F)r0) rwNrNFFNNFN)rN)T)r)rF)NF)rs __module__ __qualname____doc__rCrDrrGrrequestrrBr^ classmethodrorrrvr|r}rpropertyr?rrrZ status_intrrrrUrrrrrrTrrrr,r+rhas_bodyrrrriZ unicode_bodyZubodyrrrZ body_filerrrrrVrZallowvaryrrrr#rhr Zcontent_languagecontent_locationrcontent_dispositionZ accept_rangesrr!r,rdaterrrrr"rrr rrZagerr retry_afterserverrr Zwww_authenticaterrrrKrrrrWrrrZcontent_type_paramsrrrrrrrrrrrZ cache_expiresr r r staticmethodrr!r&r)r$r-r7r7r7r8r)<sX 4  $                             )  u   $    Ezcontent-lengthz content-typecsfdd|DS)Ncs g|]}|dkr|qS)r)r3)r4r)remove_headersr7r8r9ysz"filter_headers..r7)hlistrAr7)rAr8r*xsr*ccs x||}|sP|VqWdS)N)rg)r block_sizedatar7r7r8r|s  rc@sTeZdZdZdZddZddZeddd d Zd d Z d dZ ddZ ddZ dS)rwbFcCs||_|j|_dS)zH Represents a :class:`~Response` as a file like object. N)rr)rSrr7r7r8r^szResponseBodyFile.__init__cCs d|jS)Nz)r)rSr7r7r8rvszResponseBodyFile.__repr__cCs|jjS)N)rrK)rSr7r7r8rr0zResponseBodyFile.z:The encoding of the file (inherited from response.charset))rcCsx|D]}||qWdS)z< Write a sequence of lines to the response. N)r)rSseqitemr7r7r8 writeliness zResponseBodyFile.writelinescCs tddS)Nz Response bodies cannot be closed)NotImplementedError)rSr7r7r8rszResponseBodyFile.closecCsdS)Nr7)rSr7r7r8flushszResponseBodyFile.flushcCs"|jjs dStdd|jjDS)zS Provide the current location where we are going to start writing. rcSsg|] }t|qSr7)rM)r4rr7r7r8r9sz)ResponseBodyFile.tell..)rr8rrV)rSr7r7r8tellszResponseBodyFile.tellN) rsr2r3rclosedr^rvr7rYrIrrKrLr7r7r7r8rsrc@s<eZdZdZddZddZddZdd ZeZd d Z d S) r1zA Wraps an ``app_iter``, returning just a range of bytes. cCsX|dkstd||dks8|dkr,||ks8td|t||_d|_||_||_dS)Nrz Bad start: %rz Bad stop: %r)riterrV_posrr.)rSrVrr.r7r7r8r^s  zAppIterRange.__init__cCs|S)Nr7)rSr7r7r8__iter__szAppIterRange.__iter__cCs|j|j}}x|jD]}|jt|7_|j|kr:qq|j|krHdS|||jd}|dk r|j|kr|d||j}t|||kst|SqWtdS)Nr0)rr.rVrOrMr StopIteration)rSrr.rr7r7r8 _skip_starts   zAppIterRange._skip_startcCsx|j|jkr|S|j}|dk r0|j|kr0tt|j}|jt|7_|dks^|j|krb|S|d||jSdS)N)rOrrRr.rQnextrVrM)rSr.rr7r7r8rSs  zAppIterRange.nextcCst|jdS)N)rqrV)rSr7r7r8rszAppIterRange.closeN) rsr2r3r4r^rPrRrS__next__rr7r7r7r8r1s r1c@s6eZdZdZd ddZddZddZd d ZeZdS) r%z An empty WSGI response. An iterator that immediately stops. Optionally provides a close method to close an underlying ``app_iter`` it replaces. NcCs|dk rt|dr|j|_dS)Nr)rPr)rSrVr7r7r8r^szEmptyResponse.__init__cCs|S)Nr7)rSr7r7r8rPszEmptyResponse.__iter__cCsdS)Nrr7)rSr7r7r8__len__szEmptyResponse.__len__cCs tdS)N)rQ)rSr7r7r8rSszEmptyResponse.next)N) rsr2r3r4r^rPrUrSrTr7r7r7r8r%s  r%cCs2|dp0|dr|dp0|do0|dS)Nzapplication/xmlz application/z+xmlzimage/)rdendswith)rWr7r7r8_is_xmls     rWcCs|dpt|S)Nztext/)rdrW)rWr7r7r8rE s rEcCs|dd}|dr$||d7}n||dd|d7}|dr`|ddkr`|d d }n"|d r|dd kr|d d }tr|dd}|dd}n$t|ddd}t|ddd}|t|7}t|}d|kr||dd 7}n||7}|S)zeLike ``wsgiref.url.request_uri``, except eliminates ``:80`` ports. Returns the full request URI.zwsgi.url_schemez://Z HTTP_HOSTZ SERVER_NAMEr.Z SERVER_PORTz:80httpNz:443httpsZ SCRIPT_NAMErZ PATH_INFOrwzlatin-1ra)rrVr r r)rurl script_nameZ path_infoZ qpath_infor7r7r8rs&     rcCst|dr|dS)Nr)rPr)rNr7r7r8rq.s rqccsd}tdd@}tdtjtj tjd}tVx<|D]4}|t|7}t||d@}||}|r8|Vq8W| }|r|Vt d||d@VdS)Nrr0l z<2L) rcrc32 compressobjDEFLATED MAX_WBITS DEF_MEM_LEVEL _gzip_headerrMcompressrKstructpack)rVsizecrcrerHrr7r7r8r 2s     r cCsDt|}t|dkr0|ddd|dd}td||fdS)N2z...iz>An item of the app_iter (%s) was text, causing a text body: %r)reprrMr=)rVrTZ app_iter_reprr7r7r8rJs  r)r@)rC)Lrerfrbase64rrrhashlibrZwebob.byterangerZwebob.cachecontrolrrZ webob.compatr r r r r rrZ webob.cookiesrrZwebob.datetime_utilsrrrZwebob.descriptorsrrrrrrrrrrrr r!r"r#Z webob.headersr$Z webob.requestr%Z webob.utilr&r'r(Z simplejsonr, ImportError__all__compileIrrrdobjectrBr)r*rrr1r%rWrErrqr rr7r7r7r8sZ   $ D   F  *8