%h8JSrSSKJr SSKrSSKJr SSKJr SSK J r SSK J r SS K Jr SS KJr \R"(aSS KJr SS KJr SS KJr "SS\5r"SS\5r\4SSjjr"SS5r"SS5r"SS5r"SS5r"SS5rg)a WSGI Protocol Linter ==================== This module provides a middleware that performs sanity checks on the behavior of the WSGI server and application. It checks that the :pep:`3333` WSGI spec is properly implemented. It also warns on some common HTTP errors such as non-empty responses for 304 status codes. .. autoclass:: LintMiddleware :copyright: 2007 Pallets :license: BSD-3-Clause ) annotationsN) TracebackType)urlparse)warn)Headers)is_entity_header) FileWrapper) StartResponse)WSGIApplication)WSGIEnvironmentc\rSrSrSrSrg) WSGIWarning!z Warning class for WSGI warnings.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__rP/var/www/auris/envauris/lib/python3.13/site-packages/werkzeug/middleware/lint.pyrr!*rrc\rSrSrSrSrg) HTTPWarning%z Warning class for HTTP warnings.rNrrrrrr%rrrc [U5ULa9[U<SUR<S[U5R<S3[SS9 gg)Nz requires z, got . stacklevel)typerrr)contextobjneeds r check_typer()sH Cy kDMM#4F49;M;M:PPQ R  rcF\rSrSrS SjrS SjrS SjrS SjrS SjrSr g) InputStream2cXlgN_streamselfstreams r__init__InputStream.__init__3 rc[U5S:Xa[S[SS9 O[U5S:wa[S[SS9 URR"U6$)NrzWSGI does not guarantee an EOF marker on the input stream, thus making calls to 'wsgi.input.read()' unsafe. Conforming servers may never return from this call.rr"z2Too many parameters passed to 'wsgi.input.read()'.)lenrrr/readr1argss rr9InputStream.read6sW t9> *  Y!^ D  ||  $''rc[U5S:Xa[S[SS9 O*[U5S:Xa[S[SS9 O [S5eURR "U6$)Nrz_Calls to 'wsgi.input.readline()' without arguments are unsafe. Use 'wsgi.input.read()' instead.rr"r7z~'wsgi.input.readline()' was called with a size hint. WSGI does not support this, although it's available on all major servers.z5Too many arguments passed to 'wsgi.input.readline()'.)r8rr TypeErrorr/readliner:s rr?InputStream.readlineGsd t9> 0   Y!^ O  ST T||$$d++rc[UR5$![a [S[SS9 [S5s$f=f)Nz'wsgi.input' is not iterable.rr"r)iterr/r>rrr1s r__iter__InputStream.__iter__Zs;  % %  0+! L8O s $>>cV[S[SS9 URR5 g)Nz(The application closed the input stream!rr"rrr/closerCs rrHInputStream.closea  7QRS rr.N)r2z t.IO[bytes]returnNone)r;t.AnyrKbytes)rKzt.Iterator[bytes]rKrL) rrrrr3r9r?rDrHrrrrr*r*2s(",&rr*cF\rSrSrS SjrS SjrS SjrS SjrS SjrSr g) ErrorStreamfcXlgr-r.r0s rr3ErrorStream.__init__gr5rc\[SU[5 URRU5 g)Nzwsgi.error.write())r(strr/writer1ss rrWErrorStream.writejs!'C0 1rc8URR5 gr-)r/flushrCs rr\ErrorStream.flushns rc8UHnURU5 M gr-)rW)r1seqlines r writelinesErrorStream.writelinesqsD JJt rcV[S[SS9 URR5 g)Nz(The application closed the error stream!rr"rGrCs rrHErrorStream.closeurJrr.N)r2z t.IO[str]rKrL)rYrVrKrLrO)r_zt.Iterable[str]rKrL) rrrrr3rWr\rarHrrrrrQrQfsrrQc(\rSrSrSSjrSSjrSrg) GuardedWritezcXlX lgr-)_write_chunks)r1rWchunkss rr3GuardedWrite.__init__{s   rc[SU[5 URU5 URR [ U55 g)Nzwrite())r(rNrirjappendr8rXs r__call__GuardedWrite.__call__s/9a' A CF#r)rjriN)rWzt.Callable[[bytes], object]rk list[int]rKrL)rYrNrKrL)rrrrr3rorrrrrfrfzs $rrfcV\rSrSrS SjrS SjrS SjrS SjrS SjrSr g) GuardedIteratorcjXl[U5RUlSUlX lX0lg)NF) _iteratorrB__next___nextclosed headers_setrk)r1iteratorrzrks rr3GuardedIterator.__init__s, "(^,,  & rcU$r-rrCs rrDGuardedIterator.__iter__s rcUR(a[S[SS9 UR5nUR(d[S[SS9 [ SU[ 5 URR[U55 U$)Nz Iterated over closed 'app_iter'.rr"z8The application returned before it started the response.zapplication iterator items) ryrrrxrzr(rNrkrnr8)r1rvs rrwGuardedIterator.__next__se ;; 3[Q O ZZ\ J  /U; 3r7# rcSUl[URS5(aURR5 UR(GaURup[ UR 5nURS[S9nUS:XaaUHCupVUR5nUS;dM[U5(dM/[SU<S3[S S 9 ME U(a[S [S S 9 ggS Us=::aS :dO US:Xa3US:wa[US3[S S 9 U(a[US3[S S 9 ggUbXC:wa[S[S S 9 gggg)NTrHzcontent-length)r$i0)expireszcontent-locationzEntity header z found in 304 response.rr"z#304 responses must not have a body.drz- responses must have an empty content length.z responses must not have a body.zGContent-Length and the number of bytes sent to the client do not match.)ryhasattrrvrHrzsumrkgetintlowerr rrr)r1 status_codeheaders bytes_sentcontent_lengthkey_values rrHGuardedIterator.closes` 4>>7 + + NN "    #'#3#3 KT[[)J$[[)9[DNc!#*KC))+C"AAFVGG,SG3JK''( $+=##$  )c)[C-?!Q&&-'TU##$ &-'GH##$  +0L, 1M+G rchUR(d[S[SS9 gg![a gf=f)Nz4Iterator was garbage collected before it was closed.rr")ryrr ExceptionrCs r__del__GuardedIterator.__del__s8{{ J   s $ 11)rvrxrkryrzN)r{t.Iterable[bytes]rztuple[int, Headers]rkrqrKrL)rKrs)rKrNrO) rrrrr3rDrwrHrrrrrrsrssB # )    "/b rrscd\rSrSrSrS SjrS SjrS SjrSSjrSSjr SSjr S r g )LintMiddlewarea`Warns about common errors in the WSGI and HTTP behavior of the server and wrapped application. Some of the issues it checks are: - invalid status codes - non-bytes sent to the WSGI server - strings returned from the WSGI application - non-empty conditional responses - unquoted etags - relative URLs in the Location header - unsafe calls to wsgi.input - unclosed iterators Error information is emitted using the :mod:`warnings` module. :param app: The WSGI application to wrap. .. code-block:: python from werkzeug.middleware.lint import LintMiddleware app = LintMiddleware(app) cXlgr-app)r1rs rr3LintMiddleware.__init__src[U5[La[S[SS9 SHnX!;dM [SU<S3[SS9 M USS :wa[S [SS9 UR S S 5nUR S S 5nU(aUSS:wa[SU<3[SS9 U(aUSS:wa[SU<3[SS9 ggg)Nz/WSGI environment is not a standard Python dict.r") REQUEST_METHOD SERVER_NAME SERVER_PORT wsgi.version wsgi.input wsgi.errorszwsgi.multithreadzwsgi.multiprocessz wsgi.run_oncezRequired environment key z not foundr!r)r7rz"Environ is not a WSGI 1.0 environ. SCRIPT_NAME PATH_INFOr/z+'SCRIPT_NAME' does not start with a slash: z)'PATH_INFO' does not start with a slash: )r$dictrrr)r1environr script_name path_infos r check_environLintMiddleware.check_environs = $ A   C!/wjA   " > "f , 5{q Qkk-4 KK R0 ;q>S0 =k_M  1, ;I=I -9rcD[SU[5 URSS5Sn[U5S:wdUR 5(d[ S[ SS9 [U5S:d USS:wa[ S U<S 3[ SS9 [U5nUS :a[ S [ SS9 [U5[La[ S [ SS9 UHn[U5[Ld[U5S:wa[ S[ SS9 Uupx[U5[Ld[U5[La[ S[ SS9 UR5S:XdM[ S[ SS9 M Ub$[U[5(d[ S[ SS9 [U5n URU 5 XY4$)Nstatusr7rr!z!Status code must be three digits.r"r zInvalid value for status zJ. Valid status strings are three digits, a space and a status explanation.rzStatus code < 100 detected.zHeader list is not a list.rz#Header items must be 2-item tuples.z'Header keys and values must be strings.zFThe status header is not supported due to conflicts with the CGI spec.zInvalid value for exc_info.)r(rVsplitr8 isdecimalrrrr$listtupler isinstancer check_headers) r1rrexc_infostatus_code_strritemnamevalue headers_objs rcheck_start_response#LintMiddleware.check_start_response)s} 8VS) ,,tQ/2  1 $O,E,E,G,G 4ka P v;?fQi3. +F:6==  /*   .  J = $ -{q IDDz&#d)q.:KTUVKDDz$U 3(>={WXzz|x'4    8U(C(C .  Jg&  ;'''rcrURS5nUbdURS5(a*URS5(a[S[SS9 USSnUSSUS Ss=:XaS :XdO [S [SS9 URS 5nUb+[ U5R (d[S [SS9 ggg)Netag)zW/w/rz)Weak etag indicator should be upper case.rr"rr7"zUnquoted etag emitted.locationz+Absolute URLs required for location header.)r startswithrrrnetloc)r1rrrs rrLintMiddleware.check_headers]s{{6"  |,,??4((C##$ ABx!HRS 0S0-{qI;;z*  H%,,A - rcN[U[5(a[S[SS9 gg)NzThe application returned a string. The response will send one character at a time to the client, which will kill performance. Return a list or iterable instead.r!r")rrVrr)r1app_iters rcheck_iteratorLintMiddleware.check_iteratorxs) h $ $ 6   %rc^^^^[U5S:wa[S[SS9 U(a[S[SS9 USnUSmTRU5 [ US5US'[ US5US'[ US '/m/mS UUUU4S jjnTRU[R"S U55nTRU5 [U[R"[[[4T5T5$) NrzA WSGI app takes two arguments.r"z+A WSGI app does not take keyword arguments.rr7rrzwsgi.file_wrapperc>[U5S;a[S[U5S3[SS9 U(a[S[SS9 USnUSn[U5S :XaUSOSnTRX#U5TSS&[ T"X#U5T5$) N>rr!zInvalid number of arguments: z, expected 2 or 3.rr"z1'start_response' does not take keyword arguments.rr7r!)r8rrrrf) r;kwargsrrrrkrzr1start_responses rchecking_start_response8LintMiddleware.__call__..checking_start_responses4y&3CI;>PQ  G  q'F-1!WGt9>Qt "66vQKNv I6R Rrr )r;rMrrMrKzt.Callable[[bytes], None])r8rrrr*rQr rtcastrrsrrr) r1r;rrrrrkrzrs ` @@@rroLintMiddleware.__call__s  t9> 2KA N  ={WX $(7(,Q 7# +GL,A B !,W]-C!D (3#$#%  S S$) S & S S488GQVVO=T%UV H% affU3<0+>  rrN)rr rKrL)rr rKrL)rrVrzlist[tuple[str, str]]rz?None | tuple[type[BaseException], BaseException, TracebackType]rKr)rrrKrL)rrrKrL)r;rMrrMrKr) rrrrrr3rrrrrorrrrrrsN,*X2(2('2(T 2(  2(h65 rr)r%rVr&objectr'r$rKrL) r __future__rtypingrtypesr urllib.parserwarningsrdatastructuresrhttpr wsgir TYPE_CHECKING_typeshed.wsgir r r WarningrrrVr(r*rQrfrsrrrrrs #!$#??,..+'++'+8; 11h($$[[|T T r