7ec@sFdZdgZddlZddlZddlmZmZmZmZddl Z ej dZ ej dZ de fdYZd Zd Zd dd YZd ddYZdddYZdd dYZdd!dYZdZdZdZdZdZdZdZdZdS("s" Middleware to check for obedience to the WSGI specification. Some of the things this checks: * Signature of the application and start_response (including that keyword arguments are not used). * Environment checks: - Environment is a dictionary (and not a subclass). - That all the required keys are in the environment: REQUEST_METHOD, SERVER_NAME, SERVER_PORT, wsgi.version, wsgi.input, wsgi.errors, wsgi.multithread, wsgi.multiprocess, wsgi.run_once - That HTTP_CONTENT_TYPE and HTTP_CONTENT_LENGTH are not in the environment (these headers should appear as CONTENT_LENGTH and CONTENT_TYPE). - Warns if QUERY_STRING is missing, as the cgi module acts unpredictably in that case. - That CGI-style variables (that don't contain a .) have (non-unicode) string values - That wsgi.version is a tuple - That wsgi.url_scheme is 'http' or 'https' (@@: is this too restrictive?) - Warns if the REQUEST_METHOD is not known (@@: probably too restrictive). - That SCRIPT_NAME and PATH_INFO are empty or start with / - That at least one of SCRIPT_NAME or PATH_INFO are set. - That CONTENT_LENGTH is a positive integer. - That SCRIPT_NAME is not '/' (it should be '', and PATH_INFO should be '/'). - That wsgi.input has the methods read, readline, readlines, and __iter__ - That wsgi.errors has the methods flush, write, writelines * The status is a string, contains a space, starts with an integer, and that integer is in range (> 100). * That the headers is a list (not a subclass, not another kind of sequence). * That the items of the headers are tuples of strings. * That there is no 'status' header (that is used in CGI, but not in WSGI). * That the headers don't contain newlines or colons, end in _ or -, or contain characters codes below 037. * That Content-Type is given if there is content (CGI often has a default content type, but WSGI does not). * That no Content-Type is given when there is no content (@@: is this too restrictive?) * That the exc_info argument to start_response is a tuple or None. * That all calls to the writer are with strings, and no other methods on the writer are accessed. * That wsgi.input is used properly: - .read() is called with zero or one argument - That it returns a string - That readline, readlines, and __iter__ return strings - That .close() is not called - No other methods are provided * That wsgi.errors is used properly: - .write() and .writelines() is called with a string - That .close() is not called, and no other methods are provided. * The response iterator: - That it is not a string (it should be a list of a single string; a string will work, but perform horribly). - That .next() returns a string - That the iterator is not iterated over until start_response has been called (that can signal either a server or application error). - That .close() is called (doesn't raise exception, only prints to sys.stderr, because we only know it isn't called when the object is garbage collected). t validatoriN(tDictTypet StringTypet TupleTypetListTypes^[a-zA-Z][a-zA-Z0-9\-_]*$s [\000-\037]t WSGIWarningcBseZdZRS(s: Raised in response to WSGI-spec-related warnings (t__name__t __module__t__doc__(((s(/usr/lib64/python2.7/wsgiref/validate.pyRzscGs|st|ndS(N(tAssertionError(tcondtargs((s(/usr/lib64/python2.7/wsgiref/validate.pytassert_scsfd}|S(s When applied between a WSGI server and a WSGI application, this middleware will check for WSGI compliancy on a number of levels. This middleware does not modify the request or response in any way, but will raise an AssertionError if anything seems off (except for a failure to close the application iterator, which will be printed to stderr -- there's no way to raise an exception at that point). cstt|dkdt| d|\}t|gfd}t|d|dThe application must return an iterator, if only an empty list( R R t check_environt InputWrappert ErrorWrapperRtFalsetcheck_iteratortIteratorWrapper(R RtenvironRtiterator(t application(RRs(/usr/lib64/python2.7/wsgiref/validate.pytlint_apps   ((R$R%((R$s(/usr/lib64/python2.7/wsgiref/validate.pyRs )RcBs>eZdZdZdZdZdZdZRS(cCs ||_dS(N(tinput(tselft wsgi_input((s(/usr/lib64/python2.7/wsgiref/validate.pyt__init__scGsHtt|dk|jj|}tt|tdk|S(Nit(R R R&treadttype(R'R tv((s(/usr/lib64/python2.7/wsgiref/validate.pyR+scCs/|jj}tt|tdk|S(NR*(R&treadlineR R,(R'R-((s(/usr/lib64/python2.7/wsgiref/validate.pyR.scGsutt|dk|jj|}tt|tgkx*|D]"}tt|tdkqKW|S(NiR*(R R R&t readlinesR,(R'R tlinestline((s(/usr/lib64/python2.7/wsgiref/validate.pyR/s   ccs&x|j}|sdS|VqWdS(N(R.(R'R1((s(/usr/lib64/python2.7/wsgiref/validate.pyt__iter__s  cCstdddS(Nis input.close() must not be called(R (R'((s(/usr/lib64/python2.7/wsgiref/validate.pytcloses(RRR)R+R.R/R2R3(((s(/usr/lib64/python2.7/wsgiref/validate.pyRs      RcBs5eZdZdZdZdZdZRS(cCs ||_dS(N(terrors(R't wsgi_errors((s(/usr/lib64/python2.7/wsgiref/validate.pyR)scCs0tt|tdk|jj|dS(NR*(R R,R4twrite(R'ts((s(/usr/lib64/python2.7/wsgiref/validate.pyR6scCs|jjdS(N(R4tflush(R'((s(/usr/lib64/python2.7/wsgiref/validate.pyR8scCs"x|D]}|j|qWdS(N(R6(R'tseqR1((s(/usr/lib64/python2.7/wsgiref/validate.pyt writeliness cCstdddS(Nis!errors.close() must not be called(R (R'((s(/usr/lib64/python2.7/wsgiref/validate.pyR3s(RRR)R6R8R:R3(((s(/usr/lib64/python2.7/wsgiref/validate.pyRs     RcBseZdZdZRS(cCs ||_dS(N(twriter(R't wsgi_writer((s(/usr/lib64/python2.7/wsgiref/validate.pyR)scCs-tt|tdk|j|dS(NR*(R R,R;(R'R7((s(/usr/lib64/python2.7/wsgiref/validate.pyt__call__s(RRR)R=(((s(/usr/lib64/python2.7/wsgiref/validate.pyRs tPartialIteratorWrappercBseZdZdZRS(cCs ||_dS(N(R#(R't wsgi_iterator((s(/usr/lib64/python2.7/wsgiref/validate.pyR)scCst|jdS(N(R!R#R(R'((s(/usr/lib64/python2.7/wsgiref/validate.pyR2s(RRR)R2(((s(/usr/lib64/python2.7/wsgiref/validate.pyR>s R!cBs5eZdZdZdZdZdZRS(cCs.||_t||_t|_||_dS(N(toriginal_iteratortiterR#Rtclosedtcheck_start_response(R'R?RC((s(/usr/lib64/python2.7/wsgiref/validate.pyR)s  cCs|S(N((R'((s(/usr/lib64/python2.7/wsgiref/validate.pyR2 scCsOt|j d|jj}|jdk rKt|jdd|_n|S(NsIterator read after closedsjThe application returns and we started iterating over its body, but start_response has not yet been called(R RBR#tnextRCR(R'R-((s(/usr/lib64/python2.7/wsgiref/validate.pyRD s   cCs/t|_t|jdr+|jjndS(NR3(tTrueRBthasattrR@R3(R'((s(/usr/lib64/python2.7/wsgiref/validate.pyR3s cCs0|jstjjdnt|jddS(Ns/Iterator garbage collected without being closed(RBtsyststderrR6R (R'((s(/usr/lib64/python2.7/wsgiref/validate.pyt__del__s     (RRR)R2RDR3RI(((s(/usr/lib64/python2.7/wsgiref/validate.pyR!s    c Cstt|tkdt||fxCdddddddd d g D] }t||kd |fqKWx5d d gD]'}t||kd||dfq|Wd|krtjdtnx^|jD]P}d|krqntt||tkd|t||||fqWtt|dtkd|dft|dd,kd|dt |dt |d|dd-krtjd!|dtnt|j d" p|d"j d#d$|d"t|j d% p |d%j d#d&|d%|j d'rPtt |d'd(kd)|d'n|j d"sutd%|kd*nt|j d"d#kd+dS(.Ns:Environment is not of the right type: %r (environment: %r)tREQUEST_METHODt SERVER_NAMEt SERVER_PORTs wsgi.versions wsgi.inputs wsgi.errorsswsgi.multithreadswsgi.multiprocesss wsgi.run_onces$Environment missing required key: %rtHTTP_CONTENT_TYPEtHTTP_CONTENT_LENGTHs8Environment should not have the key: %s (use %s instead)it QUERY_STRINGsQUERY_STRING is not in the WSGI environment; the cgi module will use sys.argv when this variable is missing, so application errors are more likelyt.s9Environmental variable %s is not a string: %r (value: %r)s#wsgi.version should be a tuple (%r)swsgi.url_schemethttpthttpsswsgi.url_scheme unknown: %rtGETtHEADtPOSTtOPTIONStPATCHtPUTtDELETEtTRACEsUnknown REQUEST_METHOD: %rt SCRIPT_NAMEt/s$SCRIPT_NAME doesn't start with /: %rt PATH_INFOs"PATH_INFO doesn't start with /: %rtCONTENT_LENGTHisInvalid CONTENT_LENGTH: %rsgOne of SCRIPT_NAME or PATH_INFO are required (PATH_INFO should at least be '/' if SCRIPT_NAME is empty)sOSCRIPT_NAME cannot be '/'; it should instead be '', and PATH_INFO should be '/'(RQRR(RSRTRURVRWRXRYRZ(R R,RtwarningstwarnRtkeysRRt check_inputt check_errorstgett startswithtint(R"tkey((s(/usr/lib64/python2.7/wsgiref/validate.pyR"s`        #     cCsAx:ddddgD]&}tt||d||fqWdS(NR+R.R/R2s-wsgi.input (%r) doesn't have the attribute %s(R RF(R(tattr((s(/usr/lib64/python2.7/wsgiref/validate.pyRbcscCs>x7dddgD]&}tt||d||fqWdS(NR8R6R:s.wsgi.errors (%r) doesn't have the attribute %s(R RF(R5Rh((s(/usr/lib64/python2.7/wsgiref/validate.pyRciscCstt|tkd||jddd}tt|dkd|t|}t|dkd|t|dks|dd krtjd |t ndS( Ns Status must be a string (not %r)iiis)Status codes must be three characters: %ridsStatus code is invalid: %rit sjThe status string (%r) should be a three-digit integer followed by a single space and a status explanation( R R,RtsplitRR RfR_R`R(Rt status_codet status_int((s(/usr/lib64/python2.7/wsgiref/validate.pyRos   "cCs_tt|tkd|t|fi}x)|D]!}tt|tkd|t|ftt|dk|\}}t|jdkd|d||jR!RRbRcRRRRR (((s(/usr/lib64/python2.7/wsgiref/validate.pytns.   "   7"  ! A