+
     Bi:                     ,   R t R.t^ RIt^ RIt^ RIt]P
                  ! R4      t]P
                  ! R4      t ! R R]4      t	R t
R tR	 t ! R
 R4      t ! R R4      t ! R R4      t ! R R4      t ! R R4      tR tR tR tR tR tR tR tR tR# )a&  
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 exactly 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).
	validatorNz^[a-zA-Z][a-zA-Z0-9\-_]*$z[\000-\037]c                       ] tR t^ytRtRtR# )WSGIWarningz2
Raised in response to WSGI-spec-related warnings
 N)__name__
__module____qualname____firstlineno____doc____static_attributes__r       '/usr/lib/python3.14/wsgiref/validate.pyr   r   y   s    r   r   c                 (    V '       g
   \        V!  hR # N)AssertionError)condargss   &*r   assert_r   ~   s    d## r   c                 t    \        V 4      \        J d   V # \        R P                  V\	        V 4      4      4      h)z!{0} must be of type str (got {1}))typestrr   formatrepr)valuetitles   &&r   check_string_typer      s6    U|s
+225$u+FH Hr   c                   a  V 3R lpV# )a  
When applied between a WSGI server and a WSGI application, this
middleware will check for WSGI compliance 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).
c                  T  <aa \        \        V 4      ^8H  R4       \        V'       * R4       V w  po\        V4       . oVV3R lp\        VR,          4      VR&   \	        VR,          4      VR&   S! W#4      p\        VRJ;'       d    VR8g  R4       \        V4       \        VS4      # )	   zTwo arguments requiredNo keyword arguments allowedc                  ~  < \        \        V 4      ^8H  ;'       g    \        V 4      ^8H  RV : 24       \        V'       * R4       V ^ ,          pV ^,          p\        V 4      ^8X  d   V ^,          pMRp\        V4       \        V4       \	        W#4       \        V4       SP                  R4       \        S! V !  4      # )r   zInvalid number of arguments: r   N)r   lencheck_statuscheck_headerscheck_content_typecheck_exc_infoappendWriteWrapper)r   kwstatusheadersexc_infostart_responsestart_response_starteds   *,   r   start_response_wrapper;validator.<locals>.lint_app.<locals>.start_response_wrapper   s    CIN44c$i1n59;>F:;!WF1gG4yA~7 '"v/8$"))$/ 566r   
wsgi.inputwsgi.errorsNFz>The application must return an iterator, if only an empty list)r   r!   check_environInputWrapperErrorWrappercheck_iteratorIteratorWrapper)r   r(   environr.   iteratorr,   r-   applications   *,   @@r   lint_appvalidator.<locals>.lint_app   s    D	Q 89B67"&g "$	7& !-W\-B C!-gm.D!Ew?$::U):L	N 	x x)?@@r   r   )r9   r:   s   f r   r   r      s    'AR Or   c                   D   a  ] tR t^t o R tR tR tR tR tR t	Rt
V tR# )	r3   c                    Wn         R # r   input)self
wsgi_inputs   &&r   __init__InputWrapper.__init__   s    
r   c                    \        \        V4      ^8H  4       V P                  P                  ! V!  p\        \	        V4      \
        J 4       V#    )r   r!   r?   readr   bytesr@   r   vs   &* r   rG   InputWrapper.read   s:    D	QJJOOT"Q5 !r   c                    \        \        V4      ^8*  4       V P                  P                  ! V!  p\        \	        V4      \
        J 4       V# rE   )r   r!   r?   readliner   rH   rI   s   &* r   rM   InputWrapper.readline   s<    D	QJJ&Q5 !r   c                    \        \        V4      ^8*  4       V P                  P                  ! V!  p\        \	        V4      \
        J 4       V F  p\        \	        V4      \        J 4       K  	  V# rE   )r   r!   r?   	readlinesr   listrH   )r@   r   lineslines   &*  r   rP   InputWrapper.readlines   sW    D	Q

$$d+Ut#$DDJ%'( r   c              #  J   "   V P                  4       ;p'       d   Vx  K  R # 5ir   )rM   )r@   rS   s   & r   __iter__InputWrapper.__iter__   s      mmo%d%J &s   ##c                    \        ^ R4       R# )    z input.close() must not be calledNr   r@   s   &r   closeInputWrapper.close   s    56r   r>   N)r   r   r   r	   rB   rG   rM   rP   rV   r\   r   __classdictcell____classdict__s   @r   r3   r3      s(      7 7r   r3   c                   >   a  ] tR t^t o R tR tR tR tR tRt	V t
R# )r4   c                    Wn         R # r   errors)r@   wsgi_errorss   &&r   rB   ErrorWrapper.__init__       !r   c                p    \        \        V4      \        J 4       V P                  P	                  V4       R # r   )r   r   r   rd   writer@   ss   &&r   ri   ErrorWrapper.write   s$    Q3!r   c                :    V P                   P                  4        R # r   )rd   flushr[   s   &r   rn   ErrorWrapper.flush   s    r   c                :    V F  pV P                  V4       K  	  R # r   )ri   )r@   seqrS   s   && r   
writelinesErrorWrapper.writelines   s    DJJt r   c                    \        ^ R4       R# )rY   z!errors.close() must not be calledNrZ   r[   s   &r   r\   ErrorWrapper.close   s    67r   rc   N)r   r   r   r	   rB   ri   rn   rr   r\   r   r^   r_   s   @r   r4   r4      s#     "8 8r   r4   c                   ,   a  ] tR t^t o R tR tRtV tR# )r'   c                    Wn         R # r   writer)r@   wsgi_writers   &&r   rB   WriteWrapper.__init__   rg   r   c                \    \        \        V4      \        J 4       V P                  V4       R # r   )r   r   rH   ry   rj   s   &&r   __call__WriteWrapper.__call__   s    Q5 !Ar   rx   N)r   r   r   r	   rB   r}   r   r^   r_   s   @r   r'   r'      s     " r   r'   c                   ,   a  ] tR t^t o R tR tRtV tR# )PartialIteratorWrapperc                    Wn         R # r   r8   )r@   wsgi_iterators   &&r   rB   PartialIteratorWrapper.__init__   s    %r   c                .    \        V P                  R 4      # r   )r6   r8   r[   s   &r   rV   PartialIteratorWrapper.__iter__   s    t}}d33r   r   N)r   r   r   r	   rB   rV   r   r^   r_   s   @r   r   r      s     &4 4r   r   c                   >   a  ] tR tRt o R tR tR tR tR tRt	V t
R# )	r6   i  c                L    Wn         \        V4      V n        R V n        W n        R# )FN)original_iteratoriterr8   closedcheck_start_response)r@   r   r   s   &&&r   rB   IteratorWrapper.__init__  s!    !.]+$8!r   c                    V # r   r   r[   s   &r   rV   IteratorWrapper.__iter__  s    r   c                   \        V P                  '       * R 4       \        V P                  4      p\	        V4      \
        Jd   \        RRV: R24       V P                  e   \        V P                  R4       RV n        V# )zIterator read after closedFz!Iterator yielded non-bytestring ()NzjThe application returns and we started iterating over its body, but start_response has not yet been called)r   r   nextr8   r   rH   r   )r@   rJ   s   & r   __next__IteratorWrapper.__next__  si    DKK(	*7%EQHI$$0D--|~(,D%r   c                    R V n         \        V P                  R4      '       d   V P                  P                  4        R# R# )Tr\   N)r   hasattrr   r\   r[   s   &r   r\   IteratorWrapper.close  s3    4))733""((* 4r   c                    V P                   '       g    \        P                  P                  R 4       \	        V P                   R 4       R# )z/Iterator garbage collected without being closedN)r   sysstderrri   r   r[   s   &r   __del__IteratorWrapper.__del__   s2    {{{JJAC=	?r   )r   r   r8   r   N)r   r   r   r	   rB   rV   r   r\   r   r   r^   r_   s   @r   r6   r6     s#     9
+
? ?r   r6   c                    \        \        V 4      \        J R \        V 4      : RV : R24       R  F  p\        W9   RV: 24       K  	  R! F!  p\        W9  RV: R	VR
,          : R24       K#  	  RV 9  d   \        P                  ! R\
        4       V P                  4        FO  pRV9   d   K  \        \        W,          4      \        J RV: R\        W,          4      : RW,          : R24       KQ  	  \        \        V R,          4      \        J RV R,          : R24       \        V R,          R"9   RV R,          ,          4       \        V R,          4       \        V R,          4       V R,          R#9  d*   \        P                  ! RV R,          ,          \
        4       \        V P                  R4      '       * ;'       g    V R,          P                  R4      RV R,          ,          4       \        V P                  R4      '       * ;'       g    V R,          P                  R4      RV R,          ,          4       V P                  R4      '       d.   \        \        V R,          4      ^ 8  RV R,          ,          4       V P                  R4      '       g   \        RV 9   R4       \        V P                  R4      R8g  R4       R# )$z&Environment is not of the right type: z (environment: r   REQUEST_METHODwsgi.versionr0   r1   z"Environment missing required key: z%Environment should not have the key: z (use :   NNz	 instead)QUERY_STRINGzQUERY_STRING is not in the WSGI environment; the cgi module will use sys.argv when this variable is missing, so application errors are more likely.zEnvironmental variable z is not a string: z	 (value: z wsgi.version should be a tuple (zwsgi.url_schemezwsgi.url_scheme unknown: %rzUnknown REQUEST_METHOD: %rSCRIPT_NAME/z$SCRIPT_NAME doesn't start with /: %r	PATH_INFOz"PATH_INFO doesn't start with /: %rCONTENT_LENGTHzInvalid CONTENT_LENGTH: %rzgOne of SCRIPT_NAME or PATH_INFO are required (PATH_INFO should at least be '/' if SCRIPT_NAME is empty)zOSCRIPT_NAME cannot be '/'; it should instead be '', and PATH_INFO should be '/'N)	r   SERVER_NAMESERVER_PORTr   r0   r1   zwsgi.multithreadzwsgi.multiprocesszwsgi.run_once)HTTP_CONTENT_TYPEHTTP_CONTENT_LENGTH)httphttps)GETHEADPOSTOPTIONSPATCHPUTDELETETRACE)r   r   dictwarningswarnr   keysr   tuplecheck_inputcheck_errorsget
startswithint)r7   keys   & r   r2   r2   '  sy   DMT!='	#$! 	69;	=	! <""%s2ww0	1 <
 W$4 		 ||~#:W\"c)D&6	7	  D()U2181H1HJLG%&*;;%0A(BBD %&'(   )M M(73C+DD	 M** 6 6}%005.1GGI K(( 4 4{#..s3,w{/CCE {{#$$G,-.!3(73C+DD	F ;;}%%w&>	? GKK&#-	"#r   c                 R    R F   p\        \        W4      RV : RV: 24       K"  	  R# )rG   zwsgi.input () doesn't have the attribute N)rG   rM   rP   rV   r   r   )rA   attrs   & r   r   r   h  s%    =
)4!	" >r   c                 R    R F   p\        \        W4      RV : RV: 24       K"  	  R# )rn   zwsgi.errors (r   N)rn   ri   rr   r   )re   r   s   & r   r   r   n  s%    0*D"	# 1r   c                 T   \        V R 4      p V P                  R^4      ^ ,          p\        \        V4      ^8H  RV,          4       \	        V4      p\        V^d8  RV,          4       \        V 4      ^8  g   V ^,          R8w  d%   \
        P                  ! RV ,          \        4       R# R# )StatusNz)Status codes must be three characters: %rzStatus code is invalid: %r zjThe status string (%r) should be a three-digit integer followed by a single space and a status explanation)r   splitr   r!   r   r   r   r   )r)   status_code
status_ints   &  r   r"   r"   t  s    vx0F,,tQ'*KC!3kAC[!JJ#;jHI
6{Q&)s*B!	# +r   c           
      @   \        \        V 4      \        J R V : R\        V 4      : 24       V  EFj  p\        \        V4      \        J RV: R\        V4      : 24       \        \	        V4      ^8H  4       Vw  r#\        VR4      p\        VR4      p\        VP                  4       R8g  RV,          4       \        RV9  ;'       d    R	V9  R
V,          4       \        \        P                  V4      RV,          4       \        VP                  R4      '       * ;'       d    VP                  R4      '       * RV,          4       \        P                  V4      '       g   EK3  \        ^ RV: R\        P                  V4      P                  ^ 4      : R24       EKm  	  R# )z	Headers (z) must be of type list: zIndividual headers (z) must be of type tuple: Header namezHeader valuer)   zyThe Status header cannot be used; it conflicts with CGI script, and HTTP status is not given through headers (value: %r).
:z,Header names may not contain ':' or '\n': %rzBad header name: %r-_z#Names may not end in '-' or '_': %rzBad header value: z (bad char: r   N)r   r   rQ   r   r!   r   lower	header_researchendswithbad_header_value_regroup)r*   itemnamer   s   &   r   r#   r#     sT   DMT!DM	#$ T
e#T$Z!	" 	D	Q }5!%8

("#	$ 	D 44S_;dB	D	  &(=(DEDMM#&&AAt}}S/A+A1D8	:%%e,,A)007==a@B C% r   c                 0   \        V R 4      p \        V P                  R^4      ^ ,          4      pRpV FD  w  rE\        VR4      pVP                  4       R8X  g   K(  W#9  d    R# \	        ^ RV,          4       KF  	  W#9  d   \	        ^ RV,          4       R# R# )r   Nr   zcontent-typezJContent-Type header found in a %s response, which must not return content.z,No Content-Type header found in headers (%s))   i0  )r   r   r   r   r   )r)   r*   codeNO_MESSAGE_BODYr   r   s   &&    r   r$   r$     s    vx0Fv||D!$Q'(D !O }5::<>)*A 9<@A B  "AGKL #r   c           	      v    \        V R J ;'       g    \        V 4      \        J RV : R\        V 4      : 24       R # )Nz
exc_info (z) is not a tuple: )r   r   r   )r+   s   &r   r%   r%     s0    H77X% 7.6XGIr   c                 P    \        \        V \        \        34      '       * R 4       R# )zwYou should not return a string as your application iterator, instead return a single-item list containing a bytestring.N)r   
isinstancer   rH   r   s   &r   r5   r5     s#     
8c5\22	EFr   )r
   __all__rer   r   compiler   r   Warningr   r   r   r   r3   r4   r'   r   r6   r2   r   r   r"   r#   r$   r%   r5   r   r   r   <module>r      s   
iT - 
 
 JJ34	jj0 ' 
$H5n7 7@8 8& 4 4!? !?F?#B"##C2M I
Fr   