`Tc@sdZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z m Z ddl m Z ddl mZmZddlmZmZmZmZmZmZmZmZmZmZdd lmZmZdd lmZm Z dd l!m"Z"m#Z#m$Z$m%Z%d Z&e'e'e'dd Z)dZ*ddZ+dZ,e-dZ.dZ/dddZ0dddZ1dddZ2dddZ3dde-dZ4de5fdYZ6de5fdYZ7ede5fdYZ8d d!Z9ed"e5fd#YZ:d$Z;dd+d'Z<dd,d(Z=ed)e5fd*YZ>dS(-s werkzeug.wsgi ~~~~~~~~~~~~~ This module implements WSGI related helpers. :copyright: (c) 2014 by the Werkzeug Team, see AUTHORS for more details. :license: BSD, see LICENSE for more details. iN(tchain(tadler32(ttimetmktime(tdatetime(tpartialtupdate_wrapper( t iteritemst text_typet string_typestimplements_iteratortmake_literal_wrappert to_unicodetto_bytestwsgi_get_bytesttry_coerce_nativetPY2(t _empty_streamt _encode_idna(tis_resource_modifiedt http_date(t uri_to_irit url_quotet url_parseturl_joincstfdS(s Marks a function as responder. Decorate a function with it and it will automatically call the return value as WSGI application. Example:: @responder def application(environ, start_response): return Response('Hello World!') cs||dS(Ni((ta(tf(sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyt(s(R(R((RsS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyt responders cCs|ddt||g}|j}|rBtdj|dS|tt|jddjd|d|s|tt|jddjd|st |}|r|d|qqntdj|S(sA handy helper function that recreates the full URL as IRI for the current request or parts of it. Here an example: >>> from werkzeug.test import create_environ >>> env = create_environ("/?param=foo", "http://localhost/script") >>> get_current_url(env) 'http://localhost/script/?param=foo' >>> get_current_url(env, root_only=True) 'http://localhost/script/' >>> get_current_url(env, host_only=True) 'http://localhost/' >>> get_current_url(env, strip_querystring=True) 'http://localhost/script/' This optionally it verifies that the host is in a list of trusted hosts. If the host is not in there it will raise a :exc:`~werkzeug.exceptions.SecurityError`. Note that the string returned might contain unicode characters as the representation is an IRI not an URI. If you need an ASCII only representation you can use the :func:`~werkzeug.urls.iri_to_uri` function: >>> from werkzeug.urls import iri_to_uri >>> iri_to_uri(get_current_url(env)) 'http://localhost/script/?param=foo' :param environ: the WSGI environment to get the current URL from. :param root_only: set `True` if you only want the root URL. :param strip_querystring: set to `True` if you don't want the querystring. :param host_only: set to `True` if the host URL should be returned. :param trusted_hosts: a list of trusted hosts, see :func:`host_is_trusted` for more information. swsgi.url_schemes://tt/t SCRIPT_NAMEt PATH_INFOt?( tget_hosttappendRtjoinRRtgettrstriptlstriptget_query_string(tenviront root_onlytstrip_querystringt host_onlyt trusted_hoststtmptcattqs((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pytget_current_url+s$ + + cCs|s tSt|tr%|g}nd}||}xo|D]g}|jdri|d}t}nt}||}||krtS|rA|jd|rAtSqAWtS(shChecks if a host is trusted against a list. This also takes care of port normalization. .. versionadded:: 0.9 :param hostname: the hostname to check :param trusted_list: a list of hostnames to check against. If a hostname starts with a dot it will match against all subdomains as well. cSs/d|kr%|jddd}nt|S(Nt:ii(trsplitR(thostname((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyt _normalizeos t.i(tFalset isinstanceR t startswithtTruetendswith(R4t trusted_listR5treft suffix_match((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pythost_is_trusted^s"         cCsd|kr,|djddj}nXd|krE|d}n?|d}|d|dfddfkr|d |d7}n|dk rt||sd dlm}|d|qn|S(sReturn the real host for the given WSGI environment. This takes care of the `X-Forwarded-Host` header. Optionally it verifies that the host is in a list of trusted hosts. If the host is not in there it will raise a :exc:`~werkzeug.exceptions.SecurityError`. :param environ: the WSGI environment to get the host of. :param trusted_hosts: a list of trusted hosts, see :func:`host_is_trusted` for more information. tHTTP_X_FORWARDED_HOSTt,it HTTP_HOSTt SERVER_NAMEswsgi.url_schemet SERVER_PORTthttpst443thttpt80R2i(t SecurityErrorsHost "%s" is not trusted(shttpsRF(shttpRHN(tsplittstriptNoneR?twerkzeug.exceptionsRI(R)R-trvRI((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyR"s      cCsS|jd}|dk rOytdt|SWqOttfk rKqOXndS(sReturns the content length from the WSGI environment as integer. If it's not available `None` is returned. .. versionadded:: 0.9 :param environ: the WSGI environ to fetch the content length from. tCONTENT_LENGTHiN(R%RLtmaxtintt ValueErrort TypeError(R)tcontent_length((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pytget_content_lengths  cCsR|d}t|}|jdr)|S|dkrE|rAtpD|St||S(sqReturns the input stream from the WSGI environment and wraps it in the most sensible way possible. The stream returned is not the raw WSGI stream in most cases but one that is safe to read from without taking into account the content length. .. versionadded:: 0.9 :param environ: the WSGI environ to fetch the stream from. :param safe: indicates weather the function should use an empty stream as safe fallback or just return the original WSGI input stream if it can't wrap it safely. The default is to return an empty string in those cases. s wsgi.inputswsgi.input_terminatedN(RUR%RLRt LimitedStream(R)t safe_fallbacktstreamRT((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pytget_input_streams   cCs.t|jdd}tt|ddS(sNReturns the `QUERY_STRING` from the WSGI environment. This also takes care about the WSGI decoding dance on Python 3 environments as a native string. The string returned will be restricted to ASCII characters. .. versionadded:: 0.9 :param environ: the WSGI environment object to get the query string from. t QUERY_STRINGRtsafes :&%=+$!*'(),(RR%RR(R)R0((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyR(s sutf-8treplacecCs.t|jdd}t|||dtS(sReturns the `PATH_INFO` from the WSGI environment and properly decodes it. This also takes care about the WSGI decoding dance on Python 3 environments. if the `charset` is set to `None` a bytestring is returned. .. versionadded:: 0.9 :param environ: the WSGI environment object to get the path from. :param charset: the charset for the path info, or `None` if no decoding should be performed. :param errors: the decoding error handling. R Rtallow_none_charset(RR%R R:(R)tcharsetterrorstpath((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyt get_path_infos cCs.t|jdd}t|||dtS(sReturns the `SCRIPT_NAME` from the WSGI environment and properly decodes it. This also takes care about the WSGI decoding dance on Python 3 environments. if the `charset` is set to `None` a bytestring is returned. .. versionadded:: 0.9 :param environ: the WSGI environment object to get the path from. :param charset: the charset for the path, or `None` if no decoding should be performed. :param errors: the decoding error handling. RRR](RR%R R:(R)R^R_R`((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pytget_script_names cCs|jd}|sdS|jdd}|}|jd}||krm|dt|t|7}nd|krd|d<|||d>> env = {'SCRIPT_NAME': '/foo', 'PATH_INFO': '/a/b'} >>> pop_path_info(env) 'a' >>> env['SCRIPT_NAME'] '/foo/a' >>> pop_path_info(env) 'b' >>> env['SCRIPT_NAME'] '/foo/a/b' .. versionadded:: 0.5 .. versionchanged:: 0.9 The path is now decoded and a charset and encoding parameter can be provided. :param environ: the WSGI environment that is modified. R RRRiR]N(R%RLR'tlenRRJR R:(R)R^R_R`t script_nametold_pathRNtsegment((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyt pop_path_infos" !   cCsQ|jddjdjdd}|rMtt|d||dtSdS(s-Returns the next segment on the `PATH_INFO` or `None` if there is none. Works like :func:`pop_path_info` without modifying the environment: >>> env = {'SCRIPT_NAME': '/foo', 'PATH_INFO': '/a/b'} >>> peek_path_info(env) 'a' >>> peek_path_info(env) 'a' If the `charset` is set to `None` a bytestring is returned. .. versionadded:: 0.5 .. versionchanged:: 0.9 The path is now decoded and a charset and encoding parameter can be provided. :param environ: the WSGI environment that is checked. R RRiiR]N(R%R'RJR RR:(R)R^R_tsegments((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pytpeek_path_info6s'cCsCd}t|||}t|tr?t|dt}nt|||}t|d \}} } tt||d \} } } ||| } || | } |rxC|| fD]}|dkrdSqWn|d ko|| ksdS| | krdS| jd} | j | s(dSd| t | j dS( sExtracts the path info from the given URL (or WSGI environment) and path. The path info returned is a unicode string, not a bytestring suitable for a WSGI environment. The URLs might also be IRIs. If the path info could not be determined, `None` is returned. Some examples: >>> extract_path_info('http://example.com/app', '/app/hello') u'/hello' >>> extract_path_info('http://example.com/app', ... 'https://example.com/app/hello') u'/hello' >>> extract_path_info('http://example.com/app', ... 'https://example.com/app/hello', ... collapse_http_schemes=False) is None True Instead of providing a base URL you can also pass a WSGI environment. .. versionadded:: 0.6 :param environ_or_baseurl: a WSGI environment dict, a base URL or base IRI. This is the root of the application. :param path_or_url: an absolute path from the server root, a relative path (in which case it's the path info) or a full URL. Also accepts IRIs and unicode parameters. :param charset: the charset for byte data in URLs :param errors: the error handling on decode :param collapse_http_schemes: if set to `False` the algorithm does not assume that http and https on the same server point to the same resource. cSs|jdddjdd}t|dkr||\}}|dkrX|dksp|dkr|d krd}qn|d }d}|dk r|d|7}n|S( Nu@iiu:iuhttpu80uhttpsu443i(RJRcRL(tschemetnetloctpartstport((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pyt_normalize_netlocws"    R*iuhttpuhttpsu/(uhttpuhttpsN(uhttpuhttps( RR8tdictR1R:RRRLR&R9RcR'(tenviron_or_baseurlt path_or_urlR^R_tcollapse_http_schemesRnR`tbase_irit base_schemet base_netloct base_patht cur_schemet cur_netloctcur_pathRj((sS/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/werkzeug/wsgi.pytextract_path_infoQs.&   "     tSharedDataMiddlewarecBsbeZdZd edddZdZdZdZdZ d Z d Z d Z RS(s) A WSGI middleware that provides static content for development environments or simple server setups. Usage is quite simple:: import os from werkzeug.wsgi import SharedDataMiddleware app = SharedDataMiddleware(app, { '/shared': os.path.join(os.path.dirname(__file__), 'shared') }) The contents of the folder ``./shared`` will now be available on ``http://example.com/shared/``. This is pretty useful during development because a standalone media server is not required. One can also mount files on the root folder and still continue to use the application because the shared data middleware forwards all unhandled requests to the application, even if the requests are below one of the shared folders. If `pkg_resources` is available you can also tell the middleware to serve files from package data:: app = SharedDataMiddleware(app, { '/shared': ('myapplication', 'shared_files') }) This will then serve the ``shared_files`` folder in the `myapplication` Python package. The optional `disallow` parameter can be a list of :func:`~fnmatch.fnmatch` rules for files that are not accessible from the web. If `cache` is set to `False` no caching headers are sent. Currently the middleware does not support non ASCII filenames. If the encoding on the file system happens to be the encoding of the URI it may work but this could also be by accident. We strongly suggest using ASCII only file names for static files. The middleware will guess the mimetype using the Python `mimetype` module. If it's unable to figure out the charset it will fall back to `fallback_mimetype`. .. versionchanged:: 0.5 The cache timeout is configurable now. .. versionadded:: 0.6 The `fallback_mimetype` parameter was added. :param app: the application to wrap. If you don't want to wrap an application you can pass it :exc:`NotFound`. :param exports: a dict of exported files and folders. :param disallow: a list of :func:`~fnmatch.fnmatch` rules. :param fallback_mimetype: the fallback mimetype for unknown files. :param cache: enable or disable caching headers. :Param cache_timeout: the cache timeout in seconds for the headers. i<i s text/plainc s||_i|_||_||_xt|D]\}}t|tr^|j|} nUt|trt j j |r|j |} q|j |} ntd|| |j| sP     F" 2 %   " 4W . $ F4