§
    ÎÑßjL9 ã                   óè  — d Z ddlZddlZddlZddlZddlZddlZddlZddl	Z	ddl
Z
ddlZddlZddlZddlZddlZddlmZ ddlmZmZmZ ddlmZmZ ddlmZmZ ddlmZ d	Z  ej!        ¦   «         d
k    Z"	  ej#        dd¦  «         $                    d¦  «        Z%	 e" oe% Z&	 e&r"	 ddl'Z'ddl(Z(n# e)$ r 	 dZ&d\  Z'Z(Y nw xY wddl*Z*nd\  Z'Z(Z*e"r2 e+e
d¦  «        r& e+e
d¦  «        sde
_,         e+e
d¦  «        sde
_-         e+e
d¦  «        s	 erdnde
_.        dZ/dZ0dZ1dZ2dZ3dZ4dZ5d Z6d!Z7d"Z8 e	j9        d :                    d#e8f¦  «        ¦  «        Z; e<¦   «         Z=g d$¢Z> e+ed%¦  «        si e_?         G d&„ d'¦  «        Z@ G d(„ d)e@¦  «        ZA G d*„ d+¦  «        ZB G d,„ d-¦  «        ZC G d.„ d/¦  «        ZD G d0„ d1¦  «        ZE G d2„ d3¦  «        ZF G d4„ d5¦  «        ZG G d6„ d7¦  «        ZHd8d9d:œZId=d<„ZJdS )>a­  
A high-speed, production ready, thread pooled, generic HTTP server.

For those of you wanting to understand internals of this module, here's the
basic call flow. The server's listening thread runs a very tight loop,
sticking incoming connections onto a Queue::

    server = HTTPServer(...)
    server.start()
    ->  serve()
        while ready:
            _connections.run()
                while not stop_requested:
                    child = socket.accept()  # blocks until a request comes in
                    conn = HTTPConnection(child, ...)
                    server.process_conn(conn)  # adds conn to threadpool

Worker threads are kept in a pool and poll the Queue, popping off and then
handling each connection in turn. Each connection can consist of an arbitrary
number of requests and their responses, so we run a nested loop::

    while True:
        conn = server.requests.get()
        conn.communicate()
        ->  while True:
                req = HTTPRequest(...)
                req.parse_request()
                ->  # Read the Request-Line, e.g. "GET /page HTTP/1.1"
                    req.rfile.readline()
                    read_headers(req.rfile, req.inheaders)
                req.respond()
                ->  response = app(...)
                    try:
                        for chunk in response:
                            if chunk:
                                req.write(chunk)
                    finally:
                        if hasattr(response, "close"):
                            response.close()
                if req.close_connection:
                    return

For running a server you can invoke :func:`start() <HTTPServer.start()>` (it
will run the server forever) or use invoking :func:`prepare()
<HTTPServer.prepare()>` and :func:`serve() <HTTPServer.serve()>` like this::

    server = HTTPServer(...)
    server.prepare()
    try:
        threading.Thread(target=server.serve).start()

        # waiting/detecting some appropriate stop condition here
        ...

    finally:
        server.stop()

And now for a trivial doctest to exercise the test suite

.. testsetup::

   from cheroot.server import HTTPServer

>>> 'HTTPServer' in globals()
True
é    N)Ú	lru_cacheé   )Ú__version__ÚconnectionsÚerrors)ÚIS_PPCÚbton)ÚMakeFileÚStreamWriter)Ú
threadpool)
ÚChunkedRFileÚDropUnderscoreHeaderReaderÚGatewayÚHTTPConnectionÚHTTPRequestÚ
HTTPServerÚHeaderReaderÚKnownLengthRFileÚSizeCheckWrapperÚget_ssl_adapter_classÚWindowsÚSERVER_SOFTWAREÚ zGoogle App Engine/F)NN)NNNÚAF_INET6ÚIPPROTO_IPV6é)   ÚIPV6_V6ONLYé   ÚSO_PEERCREDé   é   ó   
s   
ó   	ó    ó   :ó   ;ó    ó   *ó   /s   %2Fs   (?i))s   Accepts   Accept-Charsets   Accept-Encodings   Accept-Languages   Accept-Rangess   Allows   Cache-Controló
   Connections   Content-Encodings   Content-Languageó   Expects   If-Matchs   If-None-Matchs   Pragmas   Proxy-Authenticates   TEs   Traileró   Transfer-Encodings   Upgrades   Varys   Vias   Warnings   WWW-AuthenticateÚ
statisticsc                   ó&   — e Zd ZdZdd„Zd„ Zd„ ZdS )r   z`Object for reading headers from an HTTP request.

    Interface and default implementation.
    Nc                 óž  — |€i }d}	 |                      ¦   «         }|st          d¦  «        ‚|t          k    r�n|                     t          ¦  «        st          d¦  «        ‚|dd…         t          t
          hv r|                     ¦   «         }nh	 |                     t          d¦  «        \  }}n# t          $ r t          d¦  «        ‚w xY w|                     ¦   «         }|  	                    |¦  «        }|}|  
                    |¦  «        s�Œ|t          v r.|                     |¦  «        }|rd                     ||f¦  «        }|||<   �ŒE|S )aÈ  
        Read headers from the given stream into the given header dict.

        If hdict is None, a new header dict is created. Returns the populated
        header dict.

        Headers which are repeated are folded together using a comma if their
        specification so dictates.

        This function raises ValueError when the read bytes violate the HTTP
        spec.
        You should probably return "400 Bad Request" if this happens.
        NTúIllegal end of headers.úHTTP requires CRLF terminatorsr   zIllegal header line.s   , )ÚreadlineÚ
ValueErrorÚCRLFÚendswithÚSPACEÚTABÚstripÚsplitÚCOLONÚ_transform_keyÚ_allow_headerÚcomma_separated_headersÚgetÚjoin)ÚselfÚrfileÚhdictÚhnameÚlineÚvÚkÚexistings           úB/opt/saltstack/salt/lib/python3.11/site-packages/cheroot/server.pyÚ__call__zHeaderReader.__call__Î   sm  € ð ˆ=ØˆEàˆð#	Ø—>’>Ñ#Ô#ˆDØð <å Ð!:Ñ;Ô;Ð;à•tŠ|ˆ|áØ—=’=¥Ñ&Ô&ð CÝ Ð!AÑBÔBÐBà�B�Q�BŒx�E¥3˜<Ð'Ð'ð —J’J‘L”L��ð=ØŸ:š:¥e¨QÑ/Ô/‘D�A�q�qøÝ!ð =ð =ð =Ý$Ð%;Ñ<Ô<Ð<ð=øøøà—G’G‘I”I�Ø×'Ò'¨Ñ*Ô*�Ø�à×%Ò% aÑ(Ô(ð ÙàÕ+Ð+Ð+Ø Ÿ9š9 UÑ+Ô+�Øð 2ØŸ
š
 H¨a =Ñ1Ô1�AØˆE�%‰LñG#	ðJ ˆs   ÂB0 Â0C
c                 ó   — dS )NT© ©r@   Úkey_names     rH   r<   zHeaderReader._allow_header  s   € Øˆtr'   c                 óN   — |                      ¦   «                              ¦   «         S ©N)r8   ÚtitlerL   s     rH   r;   zHeaderReader._transform_key
  s   € à�~Š~ÑÔ×%Ò%Ñ'Ô'Ð'r'   rO   )Ú__name__Ú
__module__Ú__qualname__Ú__doc__rI   r<   r;   rK   r'   rH   r   r   È   sQ   € € € € € ðð ð
7ð 7ð 7ð 7ðrð ð ð(ð (ð (ð (ð (r'   r   c                   ó"   ‡ — e Zd ZdZˆ fd„Zˆ xZS )r   zDCustom HeaderReader to exclude any headers with underscores in them.c                 ó`   •— t          t          | ¦  «                             |¦  «        }|od|vS )NÚ_)Úsuperr   r<   )r@   rM   ÚorigÚ	__class__s      €rH   r<   z(DropUnderscoreHeaderReader._allow_header  s1   ø€ ÝÕ/°Ñ6Ô6×DÒDÀXÑNÔNˆØÐ+˜ 8Ð+Ð+r'   )rQ   rR   rS   rT   r<   Ú__classcell__)rZ   s   @rH   r   r     s>   ø€ € € € € ØNÐNð,ð ,ð ,ð ,ð ,ð ,ð ,ð ,ð ,r'   r   c                   óL   — e Zd ZdZd„ Zd„ Zdd„Zdd„Zdd„Zd	„ Z	d
„ Z
d„ ZeZdS )r   z¯Wraps a file-like object, raising MaxSizeExceeded if too large.

    :param rfile: ``file`` of a limited size
    :param int maxlen: maximum length of the file being read
    c                 ó0   — || _         || _        d| _        dS )z%Initialize SizeCheckWrapper instance.r   N)rA   ÚmaxlenÚ
bytes_read)r@   rA   r^   s      rH   Ú__init__zSizeCheckWrapper.__init__  s   € àˆŒ
ØˆŒØˆŒˆˆr'   c                 óP   — | j         r| j        | j         k    rt          j        ‚d S d S rO   )r^   r_   r   ÚMaxSizeExceeded©r@   s    rH   Ú_check_lengthzSizeCheckWrapper._check_length$  s3   € ØŒ;ð 	)˜4œ?¨T¬[Ò8Ð8ÝÔ(Ð(ð	)ð 	)Ð8Ð8r'   Nc                 óœ   — | j                              |¦  «        }| xj        t          |¦  «        z  c_        |                      ¦   «          |S )úÛRead a chunk from ``rfile`` buffer and return it.

        :param size: amount of data to read
        :type size: int

        :returns: chunk from ``rfile``, limited by size if specified
        :rtype: bytes
        )rA   Úreadr_   Úlenrd   ©r@   ÚsizeÚdatas      rH   rg   zSizeCheckWrapper.read(  sD   € ð Œz�Š˜tÑ$Ô$ˆØˆŒ�3˜t™9œ9Ñ$ˆŒØ×ÒÑÔÐØˆr'   c                 óè  — |�M| j                              |¦  «        }| xj        t          |¦  «        z  c_        |                      ¦   «          |S g }	 | j                              d¦  «        }| xj        t          |¦  «        z  c_        |                      ¦   «          |                     |¦  «         t          |¦  «        dk     s|dd…         t          k    rt                               |¦  «        S Œ¡)úÎRead a single line from ``rfile`` buffer and return it.

        :param size: minimum amount of data to read
        :type size: int

        :returns: one line from ``rfile``
        :rtype: bytes
        NTé   éÿÿÿÿ)	rA   r2   r_   rh   rd   ÚappendÚLFÚEMPTYr?   )r@   rj   rk   Úress       rH   r2   zSizeCheckWrapper.readline6  sÛ   € ð ÐØ”:×&Ò& tÑ,Ô,ˆDØˆOŒO�s 4™yœyÑ(ˆOŒOØ×ÒÑ Ô Ð ØˆKð ˆð	'Ø”:×&Ò& sÑ+Ô+ˆDØˆOŒO�s 4™yœyÑ(ˆOŒOØ×ÒÑ Ô Ð Ø�JŠJ�tÑÔÐå�4‰yŒy˜3Šˆ $ r s s¤)­r¢/ /Ý—z’z #‘”Ð&ð	'r'   r   c                 óÚ   — d}g }|                       |¦  «        }|rO|                     |¦  «         |t          |¦  «        z  }d|cxk     r|k    rn nn|                       |¦  «        }|°O|S ©zíRead all lines from ``rfile`` buffer and return them.

        :param sizehint: hint of minimum amount of data to read
        :type sizehint: int

        :returns: lines of bytes read from ``rfile``
        :rtype: list[bytes]
        r   ©r2   rp   rh   ©r@   ÚsizehintÚtotalÚlinesrD   s        rH   Ú	readlineszSizeCheckWrapper.readlinesQ  ó�   € ð ˆØˆØ�}Š}˜XÑ&Ô&ˆØð 	+Ø�LŠL˜ÑÔÐØ•S˜‘Y”YÑˆEØ�8Ð$Ð$Ò$Ð$˜uÒ$Ð$Ð$Ð$Ð$ØØ—=’= Ñ*Ô*ˆDð ð 	+ð ˆr'   c                 ó8   — | j                              ¦   «          dS ©z*Release resources allocated for ``rfile``.N©rA   Úcloserc   s    rH   r€   zSizeCheckWrapper.closef  ó   € àŒ
×ÒÑÔÐÐÐr'   c                 ó   — | S ©zReturn file iterator.rK   rc   s    rH   Ú__iter__zSizeCheckWrapper.__iter__j  ó   € àˆr'   c                 ó�   — t          | j        ¦  «        }| xj        t          |¦  «        z  c_        |                      ¦   «          |S ©zGenerate next file chunk.)ÚnextrA   r_   rh   rd   ©r@   rk   s     rH   Ú__next__zSizeCheckWrapper.__next__n  s>   € å�D”JÑÔˆØˆŒ�3˜t™9œ9Ñ$ˆŒØ×ÒÑÔÐØˆr'   rO   ©r   )rQ   rR   rS   rT   r`   rd   rg   r2   r{   r€   r„   rŠ   rˆ   rK   r'   rH   r   r     s¦   € € € € € ðð ðð ð ð)ð )ð )ðð ð ð ð'ð 'ð 'ð 'ð6ð ð ð ð*ð ð ðð ð ðð ð ð €D€D€Dr'   r   c                   óF   — e Zd ZdZd„ Zdd„Zdd„Zdd„Zd„ Zd	„ Z	d
„ Z
e
ZdS )r   z±Wraps a file-like object, returning an empty string when exhausted.

    :param rfile: ``file`` of a known size
    :param int content_length: length of the file being read
    c                 ó"   — || _         || _        dS )z%Initialize KnownLengthRFile instance.N)rA   Ú	remaining)r@   rA   Úcontent_lengths      rH   r`   zKnownLengthRFile.__init__  s   € àˆŒ
Ø'ˆŒˆˆr'   Nc                 óÌ   — | j         dk    rdS |€| j         }nt          || j         ¦  «        }| j                             |¦  «        }| xj         t	          |¦  «        z  c_         |S )zÛRead a chunk from ``rfile`` buffer and return it.

        :param size: amount of data to read
        :type size: int

        :rtype: bytes
        :returns: chunk from ``rfile``, limited by size if specified
        r   r'   )rŽ   ÚminrA   rg   rh   ri   s      rH   rg   zKnownLengthRFile.read„  sc   € ð Œ>˜QÒÐØ�3Øˆ<Ø”>ˆDˆDå�t˜Tœ^Ñ,Ô,ˆDàŒz�Š˜tÑ$Ô$ˆØˆŒ�#˜d™)œ)Ñ#ˆŒØˆr'   c                 óÌ   — | j         dk    rdS |€| j         }nt          || j         ¦  «        }| j                             |¦  «        }| xj         t	          |¦  «        z  c_         |S )rm   r   r'   )rŽ   r‘   rA   r2   rh   ri   s      rH   r2   zKnownLengthRFile.readline˜  se   € ð Œ>˜QÒÐØ�3Øˆ<Ø”>ˆDˆDå�t˜Tœ^Ñ,Ô,ˆDàŒz×"Ò" 4Ñ(Ô(ˆØˆŒ�#˜d™)œ)Ñ#ˆŒØˆr'   r   c                 óÚ   — d}g }|                       |¦  «        }|rO|                     |¦  «         |t          |¦  «        z  }d|cxk     r|k    rn nn|                       |¦  «        }|°O|S ru   rv   rw   s        rH   r{   zKnownLengthRFile.readlines¬  r|   r'   c                 ó8   — | j                              ¦   «          dS r~   r   rc   s    rH   r€   zKnownLengthRFile.closeÁ  r�   r'   c                 ó   — | S rƒ   rK   rc   s    rH   r„   zKnownLengthRFile.__iter__Å  r…   r'   c                 óh   — t          | j        ¦  «        }| xj        t          |¦  «        z  c_        |S r‡   )rˆ   rA   rŽ   rh   r‰   s     rH   rŠ   zKnownLengthRFile.__next__É  s,   € å�D”JÑÔˆØˆŒ�#˜d™)œ)Ñ#ˆŒØˆr'   rO   r‹   )rQ   rR   rS   rT   r`   rg   r2   r{   r€   r„   rŠ   rˆ   rK   r'   rH   r   r   x  s—   € € € € € ðð ð(ð (ð (ð
ð ð ð ð(ð ð ð ð(ð ð ð ð*ð ð ðð ð ðð ð ð €D€D€Dr'   r   c                   óD   — e Zd ZdZdd„Zd„ Zdd„Zdd„Zdd	„Zd
„ Z	d„ Z
dS )r   aª  Wraps a file-like object, returning an empty string when exhausted.

    This class is intended to provide a conforming wsgi.input value for
    request entities that have been encoded with the 'chunked' transfer
    encoding.

    :param rfile: file encoded with the 'chunked' transfer encoding
    :param int maxlen: maximum length of the file being read
    :param int bufsize: size of the buffer used to read the file
    é    c                 ód   — || _         || _        d| _        t          | _        || _        d| _        dS )z!Initialize ChunkedRFile instance.r   FN)rA   r^   r_   rr   ÚbufferÚbufsizeÚclosed)r@   rA   r^   r›   s       rH   r`   zChunkedRFile.__init__Þ  s0   € àˆŒ
ØˆŒØˆŒÝˆŒØˆŒØˆŒˆˆr'   c                 óZ  — | j         rd S | j                             ¦   «         }| xj        t	          |¦  «        z  c_        | j        r*| j        | j        k    rt          j        d| j        ¦  «        ‚|                     ¦   «          	                    t          d¦  «        }	 |                     d¦  «        }t          |d¦  «        }n # t          $ r t          d|›�¦  «        ‚w xY w|dk    r	d| _         d S | j        r"| j        |z   | j        k    rt          d¦  «        ‚| j                             |¦  «        }| xj        t	          |¦  «        z  c_        | xj        |z  c_        | j                             d¦  «        }|t"          k    r"t          dt%          |¦  «        z   d	z   ¦  «        ‚d S )
NúRequest Entity Too Larger   r   é   zBad chunked transfer size: Té   z2Bad chunked transfer coding (expected '\r\n', got ú))rœ   rA   r2   r_   rh   r^   r   rb   r8   r9   Ú	SEMICOLONÚpopÚintr3   ÚIOErrorrg   rš   r4   Úrepr)r@   rD   Ú
chunk_sizeÚchunkÚcrlfs        rH   Ú_fetchzChunkedRFile._fetchç  s¹  € ØŒ;ð 	ØˆFàŒz×"Ò"Ñ$Ô$ˆØˆŒ�3˜t™9œ9Ñ$ˆŒàŒ;ð 	˜4œ?¨T¬[Ò8Ð8ÝÔ(Ø*Ø”ñô ð ð
 �zŠz‰|Œ|×!Ò!¥)¨QÑ/Ô/ˆð	ØŸš !™œˆJÝ˜Z¨Ñ,Ô,ˆJˆJøÝð 	ð 	ð 	ÝØ<¨jÐ<Ð<ñô ð ð	øøøð
 ˜Š?ˆ?ØˆDŒKØˆFð Œ;ð 	6˜4œ?¨ZÑ7¸$¼+ÒEÐEÝÐ4Ñ5Ô5Ð5à”
—’ 
Ñ+Ô+ˆØˆŒ�3˜u™:œ:Ñ%ˆŒØˆŒ�uÑˆŒàŒz�Š˜qÑ!Ô!ˆØ•4Š<ˆ<ÝðÝ˜d™œñ$Ø&)ñ*ñô ð ð ˆ<s   Â%C ÃC"Nc                 ó<  — t           }|dk    r|S 	 |rt          |¦  «        |k    r|S | j        s|                      ¦   «          | j        s|S |r9|t          |¦  «        z
  }|| j        d|…         z  }| j        |d…         | _        n|| j        z  }t           | _        Œ�)rf   r   TN)rr   rh   rš   rª   )r@   rj   rk   rŽ   s       rH   rg   zChunkedRFile.read  s¸   € õ ˆà�1Š9ˆ9ØˆKð	$Øð �˜D™	œ	 TÒ)Ð)Ø�à”;ð  Ø—’‘”�Ø”{ð  à�Kàð $Ø ¥3 t¡9¤9Ñ,�	Ø˜œ J Y JÔ/Ñ/�Ø"œk¨)¨*¨*Ô5�”�à˜œÑ#�Ý#�”ð!	$r'   c                 óp  — t           }|dk    r|S 	 |rt          |¦  «        |k    r|S | j        s|                      ¦   «          | j        s|S | j                             t
          ¦  «        }|r†|dk    r9|t          |¦  «        z
  }|| j        d|…         z  }| j        |d…         | _        nŠt          |t          |¦  «        z
  |¦  «        }|| j        d|…         z  }| j        |d…         | _        nC|dk    r|| j        z  }t           | _        n&|| j        d|…         z  }| j        |d…         | _        �Œ')rm   r   Tro   N)rr   rh   rš   rª   Úfindrq   r‘   )r@   rj   rk   Únewline_posrŽ   s        rH   r2   zChunkedRFile.readline2  sO  € õ ˆà�1Š9ˆ9ØˆKð	8Øð �˜D™	œ	 TÒ)Ð)Ø�à”;ð  Ø—’‘”�Ø”{ð  à�Kàœ+×*Ò*­2Ñ.Ô.ˆKØð 8Ø "Ò$Ð$Ø $¥s¨4¡y¤yÑ 0�IØ˜DœK¨
¨¨
Ô3Ñ3�DØ"&¤+¨i¨j¨jÔ"9�D”K�Kå # D­3¨t©9¬9Ñ$4°kÑ BÔ B�IØ˜DœK¨
¨¨
Ô3Ñ3�DØ"&¤+¨i¨j¨jÔ"9�D”K�KØ Ò"Ð"Ø˜œÑ#�Ý#�”�à˜œ L [ LÔ1Ñ1�Ø"œk¨+¨,¨,Ô7�”ñ3	8r'   r   c                 óÚ   — d}g }|                       |¦  «        }|rO|                     |¦  «         |t          |¦  «        z  }d|cxk     r|k    rn nn|                       |¦  «        }|°O|S ru   rv   rw   s        rH   r{   zChunkedRFile.readlines[  r|   r'   c              #   ó„  K  — | j         st          d¦  «        ‚	 | j                             ¦   «         }|st          d¦  «        ‚| xj        t          |¦  «        z  c_        | j        r| j        | j        k    rt          d¦  «        ‚|t          k    rdS | 	                    t          ¦  «        st          d¦  «        ‚|V — Œ¨)zhRead HTTP headers and yield them.

        :yields: CRLF separated lines
        :ytype: bytes

        z:Cannot read trailers until the request body has been read.Tr0   rž   r1   N)
rœ   r3   rA   r2   r_   rh   r^   r¥   r4   r5   )r@   rD   s     rH   Úread_trailer_lineszChunkedRFile.read_trailer_linesp  sÓ   è è € ð Œ{ð 	ÝØLñô ð ð	Ø”:×&Ò&Ñ(Ô(ˆDØð <å Ð!:Ñ;Ô;Ð;àˆOŒO�s 4™yœyÑ(ˆOŒOØŒ{ð :˜tœ°´Ò<Ð<ÝÐ8Ñ9Ô9Ð9à•tŠ|ˆ|à�Ø—=’=¥Ñ&Ô&ð CÝ Ð!AÑBÔBÐBàˆJˆJˆJð!	r'   c                 ó8   — | j                              ¦   «          dS r~   r   rc   s    rH   r€   zChunkedRFile.closeŽ  r�   r'   )r˜   rO   r‹   )rQ   rR   rS   rT   r`   rª   rg   r2   r{   r±   r€   rK   r'   rH   r   r   Ò  sž   € € € € € ð	ð 	ðð ð ð ð)ð )ð )ðV$ð $ð $ð $ð@'8ð '8ð '8ð '8ðRð ð ð ð*ð ð ð<ð ð ð ð r'   r   c                   óŒ   — e Zd ZdZdZ	 dZ	 i Z	 g Z	 dZ	 dZ		 dZ
	  e¦   «         Z	 dd„Zd„ Zd„ Zd„ Zd	„ Zdd„Zd„ Zd„ Zd„ ZdS )r   zrAn HTTP Request (and response).

    A single HTTP connection may consist of multiple request/response pairs.
    NFTc                 ó&  — || _         || _        d| _        d| _        d| _        | j         j        �d| _        d| _        i | _        d| _        g | _	        d| _
        | j        j        | _        d| _        | j        j        | _        || _        || _        dS )a  Initialize HTTP request container instance.

        Args:
            server (HTTPServer): web server object receiving this request
            conn (HTTPConnection): HTTP connection object for this request
            proxy_mode (bool): whether this HTTPServer should behave as a PROXY
            server for certain requests
            strict_mode (bool): whether we should return a 400 Bad Request when
            we encounter a request that a HTTP compliant client should not be
            making
        Fs   httpNs   httpszHTTP/1.0r   )ÚserverÚconnÚreadyÚstarted_requestÚschemeÚssl_adapterÚresponse_protocolÚ	inheadersÚstatusÚ
outheadersÚsent_headersrZ   Úclose_connectionÚchunked_readÚchunked_writeÚ
proxy_modeÚstrict_mode)r@   rµ   r¶   rÃ   rÄ   s        rH   r`   zHTTPRequest.__init__¹  s–   € ð ˆŒØˆŒ	àˆŒ
Ø$ˆÔØˆŒØŒ;Ô"Ð.Ø"ˆDŒKà!+ˆÔØˆŒàˆŒØˆŒØ!ˆÔØ $¤Ô ?ˆÔØ!ˆÔØ!œ^Ô9ˆÔØ$ˆŒØ&ˆÔÐÐr'   c                 ó~  — t          | j        j        | j        j        ¦  «        | _        	 |                      ¦   «         }|sdS n,# t          j        $ r |                      dd¦  «         Y dS w xY w	 |  	                    ¦   «         }|sdS n,# t          j        $ r |                      dd¦  «         Y dS w xY wd| _
        dS )z;Parse the next HTTP request start-line and message-headers.Nz414 Request-URI Too LongzHThe Request-URI sent with the request exceeds the maximum allowed bytes.ú413 Request Entity Too LargezCThe headers sent with the request exceed the maximum allowed bytes.T)r   r¶   rA   rµ   Úmax_request_header_sizeÚread_request_liner   rb   Úsimple_responseÚread_request_headersr·   )r@   Úsuccesss     rH   Úparse_requestzHTTPRequest.parse_requestÚ  s  € å%ØŒIŒOØŒKÔ/ñ
ô 
ˆŒ
ð	Ø×,Ò,Ñ.Ô.ˆGð ð Ø�ðøõ Ô%ð 	ð 	ð 	Ø× Ò Ø*ð!ñô ð ð
 ˆFˆFð	øøøð	Ø×/Ò/Ñ1Ô1ˆGð ð Ø�ðøõ Ô%ð 	ð 	ð 	Ø× Ò Ø.ð!ñô ð ð
 ˆFˆFð	øøøð ˆŒ
ˆ
ˆ
s#   «A Á%A-Á,A-Á1B
 Â
%B3Â2B3c                 óJ
  — | j                              ¦   «         }d| _        |sdS |t          k    r| j                              ¦   «         }|sdS |                     t          ¦  «        s|                      dd¦  «         dS 	 |                     ¦   «                              t          d¦  «        \  }}}| 	                    d¦  «        s|                      dd¦  «         dS |dd	…                              d
d¦  «        }t          |¦  «        dk    r|                      dd¦  «         dS t          t          t          |¦  «        ¦  «        }|dk    r|                      dd¦  «         dS n.# t          t          f$ r |                      dd¦  «         Y dS w xY w|| _        |                     ¦   «         | _        | j        r%|| j        k    rd}|                      d|¦  «         dS 	 t(          j                             |¦  «        \  }}}	}
}n'# t.          $ r |                      dd¦  «         Y dS w xY w|p|}| j        dk    r| j        r|r|n|	}	�n| j        dk    rà| j        s|                      d¦  «         dS t(          j                             d                     d|f¦  «        ¦  «        }|\  }}}}}t4          }t7          j        t          ¦  «        5  |j        }d	d	d	¦  «         n# 1 swxY w Y   ||k    p| pt=          ||||f¦  «        }|r|                      dd¦  «         dS |x}}	t4          x}x}
}�n| j        o	| j         o|}|r	 |                      dd¦  «         dS | j        o| 	                    t>          ¦  «         o| }|r	 d}|                      d|¦  «         dS |r|                      dd¦  «         dS |	€|                      dd¦  «         dS 	 d„ t@                               |	¦  «        D ¦   «         }n9# t          $ r,}|                      d|j!        d         ¦  «         Y d	}~dS d	}~ww xY wtD                               |¦  «        }	|	 	                    t>          ¦  «        s
t>          |	z   }	|t4          ur|| _#        || _$        |	| _%        |
| _&        t          | j'        j(        d         ¦  «        t          | j'        j(        d         ¦  «        f}|d         |d         k    r|                      d¦  «         dS || _)        d tU          ||¦  «        z  | _+        dS )!zšRead and parse first line of the HTTP request.

        Returns:
            bool: True if the request line is valid or False if it's malformed.

        TFú400 Bad Requestr1   r    s   HTTP/z$Malformed Request-Line: bad protocolé   Nó   .r   z#Malformed Request-Line: bad version)r   r   z505 HTTP Version Not SupportedzCannot fulfill requestzMalformed Request-Linez²Malformed method name: According to RFC 2616 (section 5.1.1) and its successors RFC 7230 (section 3.1.1) and RFC 7231 (section 4.1) method names are case-sensitive and uppercase.zMalformed Request-URIs   OPTIONSs   CONNECTz405 Method Not Allowedr'   s   //zFInvalid path in Request-URI: request-target must match authority-form.z2Absolute URI not allowed if server is not a proxy.z…Invalid path in Request-URI: request-target must contain origin-form which starts with absolute-path (URI starting with a slash "/").z!Illegal #fragment in Request-URI.zInvalid path in Request-URI.c                 óL   — g | ]!}t           j                             |¦  «        ‘Œ"S rK   )ÚurllibÚparseÚunquote_to_bytes©Ú.0Úxs     rH   ú
<listcomp>z1HTTPRequest.read_request_line.<locals>.<listcomp>µ  s8   € ð ð ð àõ ”L×1Ò1°!Ñ4Ô4ðð ð r'   r   é   z
HTTP/%s.%s),rA   r2   r¸   r4   r5   rÉ   r8   r9   r6   Ú
startswithrh   ÚtupleÚmapr¤   r3   Ú
IndexErrorÚuriÚupperÚmethodrÄ   rÒ   rÓ   ÚurlsplitÚUnicodeErrorrÃ   r?   rr   Ú
contextlibÚsuppressÚportÚanyÚFORWARD_SLASHÚQUOTED_SLASH_REGEXÚargsÚQUOTED_SLASHr¹   Ú	authorityÚpathÚqsrµ   ÚprotocolÚrequest_protocolr‘   r»   )r@   Úrequest_linerà   rÞ   Úreq_protocolÚrpÚrespr¹   rë   rì   rí   ÚfragmentÚuri_is_absolute_formÚ	uri_splitÚ_schemeÚ
_authorityÚ_pathÚ_qsÚ	_fragmentÚ_portÚinvalid_pathÚdisallowed_absoluteÚatomsÚexÚsps                            rH   rÈ   zHTTPRequest.read_request_lineü  s•  € ð ”z×*Ò*Ñ,Ô,ˆð  $ˆÔØð 	Ø�5à�4ÒÐð
  œ:×.Ò.Ñ0Ô0ˆLØð Ø�uà×$Ò$¥TÑ*Ô*ð 	Ø× Ò Ø!Ø0ñô ð ð �5ð	Ø(4×(:Ò(:Ñ(<Ô(<×(BÒ(BÅ5È!Ñ(LÔ(LÑ%ˆF�C˜Ø×*Ò*¨8Ñ4Ô4ð Ø×$Ò$Ø%Ø:ñô ð ð �uØ˜a˜b˜bÔ!×'Ò'¨¨aÑ0Ô0ˆBÝ�2‰wŒw˜!Š|ˆ|Ø×$Ò$Ø%Ø9ñô ð ð �uÝ•s�3 ‘|”|Ñ$Ô$ˆBØ�FŠ{ˆ{Ø×$Ò$Ø4Ø,ñô ð ð �uð øõ �JÐ'ð 	ð 	ð 	Ø× Ò Ð!2Ð4LÑMÔMÐMØ�5�5ð	øøøð ˆŒØ—l’l‘n”nˆŒàÔð 	 ¨$¬+Ò 5Ð 5ðAð ð × Ò Ð!2°DÑ9Ô9Ð9Ø�5ð	Ý4:´L×4IÒ4IÈ#Ñ4NÔ4NÑ1ˆF�I˜t R¨¨øÝð 	ð 	ð 	Ø× Ò Ð!2Ð4KÑLÔLÐLØ�5�5ð	øøøð  &Ð2¨ÐàŒ;˜*Ò$Ð$ð
 ”Oðà(<ð��ð ð	 ‰Dð Œ[˜JÒ&Ð&à”?ð Ø×$Ò$Ð%=Ñ>Ô>Ð>Ø�uõ œ×-Ò-¨c¯hªh¸¸s°|Ñ.DÔ.DÑEÔEˆIØ9BÑ6ˆG�Z ¨¨YÝˆEÝÔ$¥ZÑ0Ô0ð 'ð 'Ø!œ�ð'ð 'ð 'ñ 'ô 'ð 'ð 'ð 'ð 'ð 'ð 'øøøð 'ð 'ð 'ð 'ð ˜cÒ!ð 9Ø�9ð9å˜ ¨¨YÐ7Ñ8Ô8ð ð
 ð Ø×$Ò$Ø%ð8ñô ð ð
 �uà)Ð)ˆI˜Ý%*Ð*ˆFÐ*�R˜(™(ð Ô ð )ØœÐ'ð)à(ð  ð
 #ð ð CØ×$Ò$Ø%ØHñô ð ð �uð Ô ð -ØŸš¥}Ñ5Ô5Ð5ð-à,Ð,ð ð
 ð 
ð >ð2ð ð
 ×$Ò$Ð%6¸Ñ=Ô=Ð=Ø�uàð Ø×$Ò$Ø%Ø7ñô ð ð �uàˆ|à×$Ò$Ø%Ø2ñô ð ð �uð	ðð å/×5Ò5°dÑ;Ô;ðñ ô ��øõ ð ð ð Ø×$Ò$Ð%6¸¼À¼
ÑCÔCÐCØ�u�u�u�u�uøøøøðøøøõ  ×$Ò$ UÑ+Ô+ˆDà�Š�}Ñ-Ô-ð 	(Ý  4Ñ'ˆDà�ÐÐØ ˆDŒKØ"ˆŒØˆŒ	ð ˆŒõ �”Ô% aÔ(Ñ)Ô)­3¨t¬{Ô/CÀAÔ/FÑ+GÔ+GÐGˆàˆaŒ5�B�q”EŠ>ˆ>Ø× Ò Ð!AÑBÔBÐBØ�5à ,ˆÔØ!-µ°B¸±´Ñ!;ˆÔàˆts\   Â AE( ÃAE( Ä'>E( Å('FÆFÇ#%H	 È	 H-È,H-ËK'Ë'K+Ë.K+Ï$P Ð
P7Ð!P2Ð2P7c                 óâ  — 	 |                       | j        | j        ¦  «         n9# t          $ r,}|                      d|j        d         ¦  «         Y d}~dS d}~ww xY w| j        j        }	 t          | j         	                    dd¦  «        ¦  «        }n'# t          $ r |                      dd¦  «         Y dS w xY w|r||k    r|                      dd¦  «         dS | j
        d	k    r'| j         	                    d
d¦  «        dk    rd| _        n&| j         	                    d
d¦  «        dk    rd| _        d}| j
        d	k    r;| j         	                    d¦  «        }|rd„ |                     d¦  «        D ¦   «         }d| _        |r1|D ].}|dk    rd| _        Œ|                      d¦  «         d| _         dS | j         	                    dd¦  «        dk    r�d                     | j        j                             d¦  «        t"          dt$          t$          f¦  «        }	 | j        j                             |¦  «         n6# t,          j        $ r$}|j        d         t0          j        vr‚ Y d}~nd}~ww xY wdS )z®Read ``self.rfile`` into ``self.inheaders``.

        Ref: :py:attr:`self.inheaders <HTTPRequest.outheaders>`.

        :returns: success status
        :rtype: bool
        rÎ   r   NFó   Content-Lengthz Malformed Content-Length Header.rÆ   úCThe entity sent with the request exceeds the maximum allowed bytes.úHTTP/1.1r*   r'   ó   closeTó
   Keep-Aliver,   c                 ó‚   — g | ]<}|                      ¦   «         ¯|                      ¦   «                              ¦   «         ‘Œ=S rK   )r8   ÚlowerrÕ   s     rH   rØ   z4HTTPRequest.read_request_headers.<locals>.<listcomp>  s7   € ÐMÐMÐM¨AÀ1Ç7Â7Á9Ä9ÐM�a—g’g‘i”i—o’oÑ'Ô'ÐMÐMÐMr'   ó   ,ó   chunkedz501 Unimplementedr+   s   100-continueÚasciis   100 Continue)Úheader_readerrA   r¼   r3   rÉ   ré   rµ   Úmax_request_body_sizer¤   r>   r»   rÀ   r9   rÁ   r?   rî   Úencoder6   r4   r¶   ÚwfileÚwriteÚsocketÚerrorr   Úsocket_errors_to_ignore)r@   r   ÚmrbsÚclÚteÚencÚmsgs          rH   rÊ   z HTTPRequest.read_request_headersá  sî  € ð	Ø×Ò˜tœz¨4¬>Ñ:Ô:Ð:Ð:øÝð 	ð 	ð 	Ø× Ò Ð!2°B´G¸A´JÑ?Ô?Ð?Ø�5�5�5�5�5øøøøð	øøøð Œ{Ô0ˆð	Ý�T”^×'Ò'Ð(9¸1Ñ=Ô=Ñ>Ô>ˆBˆBøÝð 	ð 	ð 	Ø× Ò Ø!Ø2ñô ð ð �5�5ð	øøøð ð 	�B˜’I�IØ× Ò Ø.ð!ñô ð ð
 �5ð Ô! ZÒ/Ð/àŒ~×!Ò! -°Ñ5Ô5¸ÒAÐAØ(,�Ô%øàŒ^×Ò ¨sÑ3Ô3°}ÒDÐDØ$(ˆDÔ!ð ˆØÔ! ZÒ/Ð/Ø”×#Ò#Ð$8Ñ9Ô9ˆBØð NØMÐM°·²¸$±´ÐMÑMÔM�à!ˆÔàð 		!Øð !ð !�Ø˜*Ò$Ð$Ø(,�DÔ%Ð%ð ×(Ò(Ð)<Ñ=Ô=Ð=Ø,0�DÔ)Ø ˜5˜5ð& Œ>×Ò˜i¨Ñ-Ô-°Ò@Ð@ð —(’(à”KÔ(×/Ò/°Ñ8Ô8ÝØ#ÝÝðñô ˆCðØ”	”×%Ò% cÑ*Ô*Ð*Ð*øÝ”<ð ð ð Ø”7˜1”:¥VÔ%CÐCÐCØð DÐCÐCÐCÐCøøøøðøøøð ˆts>   ‚ # £
A­!AÁAÁ)(B Â B6Â5B6ÈH9 È9I,ÉI'É'I,c                 ó&  — | j         j        }| j        r t          | j        j        |¦  «        | _        nnt          | j                             dd¦  «        ¦  «        }|r%||k     r| j	        s|  
                    dd¦  «         dS t          | j        j        |¦  «        | _        | j                              | ¦  «                             ¦   «          | j        o|                      ¦   «          | j        r!| j        j                             d¦  «         dS dS )z/Call the gateway and write its iterable output.r  r   rÆ   r  Ns   0

)rµ   r  rÁ   r   r¶   rA   r¤   r¼   r>   r¿   rÉ   r   ÚgatewayÚrespondr·   Úensure_headers_sentrÂ   r  r  )r@   r  r  s      rH   r  zHTTPRequest.respondE  s  € àŒ{Ô0ˆØÔð 	?Ý% d¤i¤o°tÑ<Ô<ˆDŒJˆJå�T”^×'Ò'Ð(9¸1Ñ=Ô=Ñ>Ô>ˆBØð ˜˜rš	˜	ØÔ(ð Ø×(Ò(Ø6ð1ñô ð ð
 �Ý)¨$¬)¬/¸2Ñ>Ô>ˆDŒJàŒ×Ò˜DÑ!Ô!×)Ò)Ñ+Ô+Ð+ØŒ
Ð1�t×/Ò/Ñ1Ô1øàÔð 	0ØŒIŒO×!Ò! ,Ñ/Ô/Ð/Ð/Ð/ð	0ð 	0r'   r   c                 óì  — t          |¦  «        }| j        j        ›d|›d�}dt          |¦  «        z  }d}|                     d¦  «        |                     d¦  «        |                     d¦  «        g}|dd…         dv r*d	| _        | j        d
k    r|                     d¦  «         nd}|                     t          ¦  «         |r?t          |t           ¦  «        r|                     d¦  «        }|                     |¦  «         	 | j
        j                             t                               |¦  «        ¦  «         dS # t          j        $ r%}|j        d         t$          j        vr‚ Y d}~dS d}~ww xY w)z+Write a simple response back to the client.ú z
zContent-Length: %s
zContent-Type: text/plain
ú
ISO-8859-1Né   >   Ú413Ú414Tr  s   Connection: close
rÎ   r   )Ústrrµ   rî   rh   r  rÀ   r»   rp   r4   Ú
isinstancer¶   r  r  rr   r?   r  r  ré   r   r  )r@   r½   r  Úproto_statusr�   Úcontent_typeÚbufr   s           rH   rÉ   zHTTPRequest.simple_response\  s…  € å�V‘”ˆØ&*¤kÔ&:Ð&:Ð&:¸F¸F¸FÐCˆØ1µC¸±H´HÑ<ˆØ5ˆà×Ò Ñ-Ô-Ø×!Ò! ,Ñ/Ô/Ø×Ò Ñ-Ô-ð
ˆð �"�1�"Œ:˜Ð'Ð'à$(ˆDÔ!ØÔ%¨Ò3Ð3ð —
’
Ð3Ñ4Ô4Ð4Ð4ð +�à�
Š
•4ÑÔÐØð 	Ý˜#�sÑ#Ô#ð /Ø—j’j Ñ.Ô.�Ø�JŠJ�s‰OŒOˆOð	ØŒIŒO×!Ò!¥%§*¢*¨S¡/¤/Ñ2Ô2Ð2Ð2Ð2øÝŒ|ð 	ð 	ð 	ØŒw�qŒz¥Ô!?Ð?Ð?Øð @Ð?Ð?Ð?Ð?Ð?øøøøð	øøøs   Ä7D? Ä?E3ÅE.Å.E3c                 óN   — | j         sd| _         |                      ¦   «          dS dS )z:Ensure headers are sent to the client if not already sent.TN)r¿   Úsend_headersrc   s    rH   r  zHTTPRequest.ensure_headers_sent�  s7   € àÔ ð 	 Ø $ˆDÔØ×ÒÑÔÐÐÐð	 ð 	 r'   c                 óV  — | j         r‚|r€t          t          |¦  «        ¦  «        dd…                              d¦  «        }|t          |t          g}| j        j                             t           	                    |¦  «        ¦  «         dS | j        j                             |¦  «         dS )z$Write unbuffered data to the client.r    Nr  )
rÂ   Úhexrh   r  r4   r¶   r  r  rr   r?   )r@   r¨   Úchunk_size_hexr(  s       rH   r  zHTTPRequest.write‡  s�   € àÔð 	) %ð 	)Ý ¥ U¡¤™_œ_¨Q¨R¨RÔ0×7Ò7¸Ñ@Ô@ˆNØ!¥4¨µÐ5ˆCØŒIŒO×!Ò!¥%§*¢*¨S¡/¤/Ñ2Ô2Ð2Ð2Ð2àŒIŒO×!Ò! %Ñ(Ô(Ð(Ð(Ð(r'   c                 ó´  — d„ | j         D ¦   «         }t          | j        dd…         ¦  «        }|dk    rd| _        nPd|vrL|dk     s|dv rnA| j        d	k    o
| j        d
k    }|r"d| _        | j                              d¦  «         nd| _        | j        s| j        j	        }| | _        d|vrN| j        d	k    r"| j        r| j                              d¦  «         n!| j        s| j                              d¦  «         d| j         v r<| j                              dd| j        j
        › �                     d¦  «        f¦  «         | j        s=| j        s6t          | j        dd¦  «        }|dk    r| j                             |¦  «         d|vrM| j                              dt           j                             d¬¦  «                             d¦  «        f¦  «         d|vr9| j                              d| j        j                             d¦  «        f¦  «         | j        j                             d¦  «        }|t*          z   | j        z   t,          z   g}| j         D ]5\  }}	|                     |t.          z   t*          z   |	z   t,          z   ¦  «         Œ6|                     t,          ¦  «         | j        j                             t6                               |¦  «        ¦  «         dS )zÁAssert, process, and send the HTTP response message-headers.

        You must set ``self.status``, and :py:attr:`self.outheaders
        <HTTPRequest.outheaders>` before calling this.
        c                 ó<   — g | ]\  }}|                      ¦   «         ‘ŒS rK   )r	  )rÖ   ÚkeyÚvalues      rH   rØ   z,HTTPRequest.send_headers.<locals>.<listcomp>–  s$   € Ð?Ð?Ð?¡  e�—’‘”Ð?Ð?Ð?r'   Nr!  i�  Ts   content-lengthéÈ   >   é0  éÌ   éÍ   r  s   HEAD)r,   r  s
   connection)r*   r  )r*   r  r  ztimeout=r   rŽ   r   s   dates   Date)Úusegmts   servers   Serverr  )r¾   r¤   r½   rÀ   r»   rà   rÂ   rp   rµ   Úcan_add_keepalive_connectionÚtimeoutr  rÁ   ÚgetattrrA   rg   ÚemailÚutilsÚ
formatdateÚserver_namerî   r6   r4   r:   r¶   r  r  rr   r?   )
r@   Úhkeysr½   Úneeds_chunkedÚcan_keeprŽ   Úprotor(  rF   rE   s
             rH   r*  zHTTPRequest.send_headers�  s  € ð @Ð?¨t¬Ð?Ñ?Ô?ˆÝ�T”[  ! ”_Ñ%Ô%ˆà�SŠ=ˆ=à$(ˆDÔ!Ð!Ø eÐ+Ð+ð ˜Š|ˆ|˜v¨Ð8Ð8Øð Ô*¨jÒ8ð /Øœ wÒ.ð ð !ð 1à)-�DÔ&Ø”O×*Ò*Ð+MÑNÔNÐNÐNð -1�DÔ)ð Ô$ð 	1Ø”{Ô?ˆHØ(0 LˆDÔ!à Ð%Ð%ØÔ%¨Ò3Ð3àÔ(ð FØ”O×*Ò*Ð+DÑEÔEÐEøàÔ*ð GØ”×&Ò&Ð'EÑFÔFÐFà)¨T¬_Ð<Ð<ØŒO×"Ò"à!Ø4˜tœ{Ô2Ð4Ð4×;Ò;¸LÑIÔIðñô ð ð Ô%ð 	+°Ô0Að 	+õ   ¤
¨K¸Ñ;Ô;ˆIØ˜1Š}ˆ}Ø”
—’ 	Ñ*Ô*Ð*à˜%ÐÐØŒO×"Ò"àÝ”K×*Ò*°$Ð*Ñ7Ô7×>Ò>¸|ÑLÔLðñô ð ð ˜EÐ!Ð!ØŒO×"Ò"àØ”KÔ+×2Ò2°<Ñ@Ô@ðñô ð ð ”Ô$×+Ò+¨GÑ4Ô4ˆØ•u‰}˜tœ{Ñ*­TÑ1Ð2ˆØ”Oð 	5ð 	5‰DˆAˆqØ�JŠJ�q�5‘y¥5Ñ(¨1Ñ,­tÑ3Ñ4Ô4Ð4Ð4Ø�
Š
•4ÑÔÐØŒ	Œ×Ò�eŸjšj¨™oœoÑ.Ô.Ð.Ð.Ð.r'   )FT)r   )rQ   rR   rS   rT   rµ   r¶   r¼   r¾   r·   rÀ   rÂ   r   r  r`   rÌ   rÈ   rÊ   r  rÉ   r  r  r*  rK   r'   rH   r   r   “  s  € € € € € ðð ð
 €FØ@à€DØDà€IØ$à€JØ;à€Eð@ð Ððð €Mð<ð !�L‘N”N€Mðð'ð 'ð 'ð 'ðB ð  ð  ðDcð cð cðJbð bð bðH0ð 0ð 0ð.#ð #ð #ð #ðJ ð  ð  ð)ð )ð )ð\/ð \/ð \/ð \/ð \/r'   r   c                   óð   — e Zd ZdZdZdZdZej        Z	ej        Z
eZdZdZdZefd„Zd„ ZdZd„ Zd„ Zd„ Zd	„ Zed
„ ¦   «         Zed„ ¦   «         Zed„ ¦   «         Zd„ Zed„ ¦   «         Zed„ ¦   «         Zd„ ZdS )r   z#An HTTP connection (active socket).NFc                 ó\  — || _         || _         ||d| j        ¦  «        | _         ||d| j        ¦  «        | _        d| _        | j         j        | _        | j         j        | _         t          d¬¦  «        | j
        ¦  «        | _
         t          d¬¦  «        | j        ¦  «        | _        dS )aB  Initialize HTTPConnection instance.

        Args:
            server (HTTPServer): web server object receiving this request
            sock (socket._socketobject): the raw socket object (usually
                TCP) for this connection
            makefile (file): a fileobject class for reading from the socket
        ÚrbÚwbr   r   )ÚmaxsizeN)rµ   r  ÚrbufsizerA   Úwbufsizer  Úrequests_seenÚpeercreds_enabledÚpeercreds_resolve_enabledr   Úresolve_peer_credsÚget_peer_creds)r@   rµ   ÚsockÚmakefiles       rH   r`   zHTTPConnection.__init__þ  sª   € ð ˆŒØˆŒØ�X˜d D¨$¬-Ñ8Ô8ˆŒ
Ø�X˜d D¨$¬-Ñ8Ô8ˆŒ
ØˆÔà!%¤Ô!>ˆÔØ)-¬Ô)NˆÔ&ð #7¥)°AÐ"6Ñ"6Ô"6°tÔ7NÑ"OÔ"OˆÔØ2�i°Ð2Ñ2Ô2°4Ô3FÑGÔGˆÔÐÐr'   c                 óž  — d}	 |                       | j        | ¦  «        }|                     ¦   «          | j        j        d         r| xj        dz  c_        |j        sdS d}|                     ¦   «          |j        sdS �nN# t          j	        $ rš}|j
        d         }d}||v r"|r	|r|j        r|                      |d¦  «         n[|t          j        vrM| j                             dt!          |¦  «        z  t"          j        d¬	¦  «         |                      |d
¦  «         Y d}~nªd}~wt&          t(          f$ r ‚ t          j        $ r Y n…t          j        $ r |                      |¦  «         Y n`t0          $ rT}| j                             t!          |¦  «        t"          j        d¬	¦  «         |                      |d
¦  «         Y d}~nd}~ww xY wdS )zrRead each request and respond appropriately.

        Returns true if the connection should be kept open.
        FÚEnabledr   Tr   )z	timed outzThe read operation timed outz408 Request Timeoutzsocket.error %s©ÚlevelÚ	tracebackz500 Internal Server ErrorN)ÚRequestHandlerClassrµ   rÌ   ÚstatsrI  r·   r  rÀ   r  r  ré   r¸   Ú_conditional_errorr   r  Ú	error_logr¦   ÚloggingÚWARNINGÚKeyboardInterruptÚ
SystemExitÚFatalSSLAlertÚ
NoSSLErrorÚ_handle_no_sslÚ	ExceptionÚERROR)r@   Úrequest_seenÚreqr   ÚerrnumÚtimeout_errss         rH   ÚcommunicatezHTTPConnection.communicate  sH  € ð
 ˆð-	FØ×*Ò*¨4¬;¸Ñ=Ô=ˆCØ×ÒÑÔÐØŒ{Ô  Ô+ð (ØÐ"Ô" aÑ'Ð"Ô"Ø”9ð ð �uàˆLØ�KŠK‰MŒMˆMØÔ'ð Ø�tñøåŒ|ð 	Jð 	Jð 	JØ”W˜Q”ZˆFàFˆLØ˜Ð%Ð%ð
 %ð H¨#ð H°#Ô2Eð HØ×+Ò+¨CÐ1FÑGÔGÐGøØ�vÔ=Ð=Ð=Ø”×%Ò%Ø%­¨V©¬Ñ4Ý!œ/Ø"ð &ñ ô ð ð
 ×'Ò'¨Ð-HÑIÔIÐIøøøøøøøøøÝ!¥:Ð.ð 	ð 	ð 	ØÝÔ#ð 	ð 	ð 	ØˆDÝÔ ð 	%ð 	%ð 	%Ø×Ò Ñ$Ô$Ð$Ð$Ð$Ýð 	Fð 	Fð 	FØŒK×!Ò!Ý�R‘”Ý”mØð "ñ ô ð ð
 ×#Ò# CÐ)DÑEÔEÐEÐEÐEÐEÐEÐEøøøøð	Føøøð ˆus8   „AA? ÁA? Á?G
ÂBD#Ä##G
Å#G
Å-	G
Å6A
GÇG
c                 óä   — |r|j         rd S 	 | j        j        }n# t          $ r | j        j        }Y nw xY wt          |d| j        ¦  «        | _        d}|                     d|¦  «         d| _	        d S )NrE  zUThe client sent a plain HTTP request, but this server only speaks HTTPS on this port.rÎ   T)
r¿   r  Ú_sockÚAttributeErrorÚ_socketr   rH  r  rÉ   Úlinger)r@   rc  Ú	resp_sockr  s       rH   r_  zHTTPConnection._handle_no_sslM  s˜   € Øð 	�cÔ&ð 	ØˆFð	,ØœÔ)ˆIˆIøÝð 	,ð 	,ð 	,àœÔ+ˆIˆIˆIð	,øøøõ " )¨T°4´=ÑAÔAˆŒ
ð:ð 	ð 	×ÒÐ-¨sÑ3Ô3Ð3ØˆŒˆˆs   � š3²3c                 óÀ   — |r|j         rdS 	 |                     |¦  «         dS # t          j        $ r Y dS t          j        $ r |                      |¦  «         Y dS w xY w)zvRespond with an error.

        Don't bother writing if a response
        has already started being written.
        N)r¿   rÉ   r   r]  r^  r_  )r@   rc  Úresponses      rH   rW  z!HTTPConnection._conditional_error^  s‘   € ð ð 	�cÔ&ð 	ØˆFð	%Ø×Ò Ñ)Ô)Ð)Ð)Ð)øÝÔ#ð 	ð 	ð 	ØˆDˆDÝÔ ð 	%ð 	%ð 	%Ø×Ò Ñ$Ô$Ð$Ð$Ð$Ð$ð	%øøøs   �$ ¤A¶#AÁAc                 ó¤   — | j                              ¦   «          | j        s/|                      ¦   «          | j                             ¦   «          dS dS )z,Close the socket underlying this connection.N)rA   r€   rk  Ú_close_kernel_socketr  rc   s    rH   r€   zHTTPConnection.closen  sU   € àŒ
×ÒÑÔÐàŒ{ð 	Ø×%Ò%Ñ'Ô'Ð'ð ŒK×ÒÑÔÐÐÐð ˆDr'   c                 ó”  — d}t           s| j        j        t          j        k    rt	          d¦  «        ‚| j        st          d¦  «        ‚	 | j                             t          j        t          j	        t          j        |¦  «        ¦  «        }t          j        ||¦  «        \  }}}|||fS # t          j        $ r}	 t          |‚d}~ww xY w)aš  Return the PID/UID/GID tuple of the peer socket for UNIX sockets.

        This function uses SO_PEERCRED to query the UNIX PID, UID, GID
        of the peer, which is only available if the bind address is
        a UNIX domain socket.

        Raises:
            NotImplementedError: in case of unsupported socket type
            RuntimeError: in case of SO_PEERCRED lookup unsupported or disabled

        Ú3iz5SO_PEERCRED is only supported in Linux kernel and WSLz0Peer creds lookup is disabled within this serverN)Ú
IS_WINDOWSr  ÚfamilyÚAF_UNIXÚNotImplementedErrorrJ  ÚRuntimeErrorÚ
getsockoptÚ
SOL_SOCKETr   ÚstructÚcalcsizeÚunpackr  )r@   ÚPEERCRED_STRUCT_DEFÚ
peer_credsÚpidÚuidÚgidÚ
socket_errs          rH   rM  zHTTPConnection.get_peer_creds�  sê   € ð #Ðåð 	˜œÔ+­v¬~Ò=Ð=Ý%ØGñô ð ð Ô%ð 	ÝØBñô ð ð	!Øœ×/Ò/õ Ô!ÝÔ"Ý”Ð 3Ñ4Ô4ñô ˆJõ" #œMÐ*=¸zÑJÔJ‰MˆC��cØ˜˜S�=Ð øõ Œ|ð 	/ð 	/ð 	/ðõ  JÐ.øøøøð	/øøøs   Á
AB* Â*CÂ9	CÃCc                 ó6   — |                       ¦   «         \  }}}|S )z,Return the id of the connected peer process.©rM  )r@   r  rW   s      rH   Úpeer_pidzHTTPConnection.peer_pid­  s    € ð ×'Ò'Ñ)Ô)‰	ˆˆQ�Øˆ
r'   c                 ó6   — |                       ¦   «         \  }}}|S )z1Return the user id of the connected peer process.r„  )r@   rW   r€  s      rH   Úpeer_uidzHTTPConnection.peer_uid³  s    € ð ×'Ò'Ñ)Ô)‰	ˆˆ3�Øˆ
r'   c                 ó6   — |                       ¦   «         \  }}}|S )z2Return the group id of the connected peer process.r„  )r@   rW   r�  s      rH   Úpeer_gidzHTTPConnection.peer_gid¹  s    € ð ×'Ò'Ñ)Ô)‰	ˆˆ1ˆcØˆ
r'   c                 óÚ   — t           st          d¦  «        ‚| j        st          d¦  «        ‚t	          j        | j        ¦  «        j        }t          j	        | j
        ¦  «        j        }||fS )a  Look up the username and group tuple of the ``PEERCREDS``.

        :returns: the username and group tuple of the ``PEERCREDS``

        :raises NotImplementedError: if the OS is unsupported
        :raises RuntimeError: if UID/GID lookup is unsupported or disabled
        z€UID/GID lookup is unavailable under current platform. It can only be done under UNIX-like OS but not under the Google App Enginez-UID/GID lookup is disabled within this server)ÚIS_UID_GID_RESOLVABLErv  rK  rw  ÚpwdÚgetpwuidr‡  Úpw_nameÚgrpÚgetgrgidr‰  Úgr_name)r@   ÚuserÚgroups      rH   rL  z!HTTPConnection.resolve_peer_creds¿  sy   € õ %ð 	Ý%ð6ñô ð ð
 Ô-ð 	ÝØ?ñô ð õ Œ|˜DœMÑ*Ô*Ô2ˆÝ”˜Tœ]Ñ+Ô+Ô3ˆà�Uˆ{Ðr'   c                 ó4   — |                       ¦   «         \  }}|S )z2Return the username of the connected peer process.©rL  )r@   r’  rW   s      rH   Ú	peer_userzHTTPConnection.peer_user×  s   € ð ×)Ò)Ñ+Ô+‰ˆˆaØˆr'   c                 ó4   — |                       ¦   «         \  }}|S )z/Return the group of the connected peer process.r•  )r@   rW   r“  s      rH   Ú
peer_groupzHTTPConnection.peer_groupÝ  s   € ð ×*Ò*Ñ,Ô,‰ˆˆ5Øˆr'   c                 óö   — t          | j        d| j        j        ¦  «        }	  |t          j        ¦  «         dS # t          j        $ r Y dS t          j        $ r}|j        t          j        vr‚ Y d}~dS d}~ww xY w)z0Terminate the connection at the transport level.Úsock_shutdownN)	r9  r  ÚshutdownÚ	SHUT_RDWRr   Ú#acceptable_sock_shutdown_exceptionsr  ÚerrnoÚ$acceptable_sock_shutdown_error_codes)r@   r›  Úes      rH   rp  z#HTTPConnection._close_kernel_socketã  s¦   € õ ØŒKØØŒKÔ ñ
ô 
ˆð	ØˆH•VÔ%Ñ&Ô&Ð&Ð&Ð&øÝÔ9ð 	ð 	ð 	ØˆDˆDÝŒ|ð 	ð 	ð 	ØŒw�fÔIÐIÐIØð JÐIÐIÐIÐIÐIøøøøð	øøøs   ¢9 ¹A8ÁA8ÁA3Á3A8) rQ   rR   rS   rT   Úremote_addrÚremote_portÚssl_envÚioÚDEFAULT_BUFFER_SIZErG  rH  r   rU  rJ  rK  Ú	last_usedr
   r`   rf  rk  r_  rW  r€   rM  Úpropertyr…  r‡  r‰  rL  r–  r˜  rp  rK   r'   rH   r   r   ï  sf  € € € € € Ø-Ð-à€KØ€KØ€GØÔ%€HØÔ%€HØ%ÐØÐØ %Ðð €Ià.6ð Hð Hð Hð Hð.4ð 4ð 4ðl €Fðð ð ð"%ð %ð %ð ð ð ð&*!ð *!ð *!ðX ðð ñ „Xðð
 ðð ñ „Xðð
 ðð ñ „Xðð
ð ð ð0 ðð ñ „Xðð
 ðð ñ „Xðð
ð ð ð ð r'   r   c                   ó  — e Zd ZdZdZdZdZ	 dZ	 dZ	 dZ		 dZ
	 dZ	 dZ	 dZ	 dZ	 de›�Z	 dZ	 d	Z	 d
Z	 d
Z	 dZ	 eZ	 dZ	 d	Z	 d	Z	 d	Z	 dZ	 	 	 	 	 	 	 d)d„Zd„ Zd„ Zd„ Z e!d„ ¦   «         Z"e"j#        d„ ¦   «         Z"d„ Z$d„ Z%d„ Z&d„ Z'd„ Z(e)j*        d„ ¦   «         Z+e!d„ ¦   «         Z,d„ Z-d*d„Z.d+d„Z/d„ Z0e1d „ ¦   «         Z2e3	 d,d!„¦   «         Z4e1d"„ ¦   «         Z5e1d#„ ¦   «         Z6d$„ Z7e!d%„ ¦   «         Z8e!d&„ ¦   «         Z9e8j#        d'„ ¦   «         Z8d(„ Z:dS )-r   zAn HTTP server.z	127.0.0.1Nr  rÏ   é
   g      à?zCheroot/Fr   Tro   c	                 ó  — || _         || _        t          j        | |pd|¬¦  «        | _        |s| j        }|| _        || _        |o|| _        || _	        |  
                    ¦   «          t          j        ¦   «         | _        dS )a  Initialize HTTPServer instance.

        Args:
            bind_addr (tuple): network interface to listen to
            gateway (Gateway): gateway for processing HTTP requests
            minthreads (int): minimum number of threads for HTTP thread pool
            maxthreads (int): maximum number of threads for HTTP thread pool
            server_name (str): web server name to be advertised via Server
                HTTP header
            reuse_port (bool): if True SO_REUSEPORT option would be set to
                socket
        r   )r‘   ÚmaxN)Ú	bind_addrr  r   Ú
ThreadPoolÚrequestsÚversionr=  rJ  rK  Ú
reuse_portÚclear_statsÚqueueÚQueueÚ_unservicable_conns)	r@   r¬  r  Ú
minthreadsÚ
maxthreadsr=  rJ  rK  r°  s	            rH   r`   zHTTPServer.__init__U  s™   € ð. #ˆŒØˆŒå"Ô-ØØ�˜aØð
ñ 
ô 
ˆŒð ð 	'Øœ,ˆKØ&ˆÔØ!2ˆÔà%Ð;Ð*;ð 	Ô&ð %ˆŒØ×ÒÑÔÐå#(¤;¡=¤=ˆÔ Ð Ð r'   c                 ó
  ‡ — d‰ _         d‰ _        i dd“dˆ fd„“dˆ fd„“d	d“d
ˆ fd„“dˆ fd„“dˆ fd„“dˆ fd„“dd“dd„ “dd„ “dd„ “dd„ “dd„ “dd„ “di “‰ _        ‰ j        t          j        d t          ‰ ¦  «        z  <   dS )!zReset server stat counters..Nr   rQ  FzBind Addressc                 ó,   •— t          ‰j        ¦  «        S rO   )r¦   r¬  ©Úsr@   s    €rH   ú<lambda>z(HTTPServer.clear_stats.<locals>.<lambda>‡  s   ø€ ¥d¨4¬>Ñ&:Ô&:€ r'   zRun timec                 óB   •— | d          rdp‰                      ¦   «         S )NrQ  ro   ©Úruntimer¹  s    €rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>ˆ  s&   ø€ ¨¨)¬Ð$4Ð#<¸"ð #Ø�|Š|‰~Œ~ð r'   ÚAcceptszAccepts/secc                 ó>   •— | d         ‰                      ¦   «         z  S )Nr¿  r½  r¹  s    €rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>‹  s   ø€  Q y¤\°D·L²L±N´NÑ%B€ r'   r³  c                 ó0   •— t          ‰j        dd ¦  «        S )NÚqsize©r9  r®  r¹  s    €rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>Œ  s   ø€ �w t¤}°g¸tÑDÔD€ r'   ÚThreadsc                 óJ   •— t          t          ‰j        dg ¦  «        ¦  «        S )NÚ_threads)rh   r9  r®  r¹  s    €rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>�  s   ø€ ¥¥W¨T¬]¸JÈÑ%KÔ%KÑ!LÔ!L€ r'   zThreads Idlec                 ó0   •— t          ‰j        dd ¦  «        S )NÚidlerÃ  r¹  s    €rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>Ž  s   ø€ ¥g¨d¬m¸VÀTÑ&JÔ&J€ r'   zSocket ErrorsÚRequestsc                 ó|   — | d          rdp1t          d„ | d                              ¦   «         D ¦   «         d¦  «        S )NrQ  ro   c              3   ó8   K  — | ]} |d          |¦  «        V — ŒdS )rÉ  NrK   ©rÖ   Úws     rH   ú	<genexpr>z;HTTPServer.clear_stats.<locals>.<lambda>.<locals>.<genexpr>’  s0   è è € ÐHÐH a���:”˜qÑ!Ô!ÐHÐHÐHÐHÐHÐHr'   úWorker Threadsr   ©ÚsumÚvalues©rº  s    rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>�  sM   € ¨¨)¬Ð$4Ð#<¸"ð #ÝØHÐH¨1Ð-=Ô+>×+EÒ+EÑ+GÔ+GÐHÑHÔHØñô ð r'   ú
Bytes Readc                 ó|   — | d          rdp1t          d„ | d                              ¦   «         D ¦   «         d¦  «        S )NrQ  ro   c              3   ó8   K  — | ]} |d          |¦  «        V — ŒdS )rÔ  NrK   rÌ  s     rH   rÎ  z;HTTPServer.clear_stats.<locals>.<lambda>.<locals>.<genexpr>—  s0   è è € ÐJÐJ¨���<” Ñ#Ô#ÐJÐJÐJÐJÐJÐJr'   rÏ  r   rÐ  rÓ  s    rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>•  sM   € ¨!¨I¬,Ð&6Ð%>¸Bð %ÝØJÐJ¨QÐ/?Ô-@×-GÒ-GÑ-IÔ-IÐJÑJÔJØñô ð r'   úBytes Writtenc                 ó|   — | d          rdp1t          d„ | d                              ¦   «         D ¦   «         d¦  «        S )NrQ  ro   c              3   ó8   K  — | ]} |d          |¦  «        V — ŒdS )r×  NrK   rÌ  s     rH   rÎ  z;HTTPServer.clear_stats.<locals>.<lambda>.<locals>.<genexpr>œ  s2   è è € ÐMÐM¨1Ð#��?Ô# AÑ&Ô&ÐMÐMÐMÐMÐMÐMr'   rÏ  r   rÐ  rÓ  s    rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>š  sM   € ¨Q¨y¬\Ð)9Ð(A¸rð (ÝØMÐM°Ð2BÔ0C×0JÒ0JÑ0LÔ0LÐMÑMÔMØñô ð r'   ú	Work Timec                 ó|   — | d          rdp1t          d„ | d                              ¦   «         D ¦   «         d¦  «        S )NrQ  ro   c              3   ó8   K  — | ]} |d          |¦  «        V — ŒdS )rÚ  NrK   rÌ  s     rH   rÎ  z;HTTPServer.clear_stats.<locals>.<lambda>.<locals>.<genexpr>¡  s0   è è € ÐIÐI q���;” Ñ"Ô"ÐIÐIÐIÐIÐIÐIr'   rÏ  r   rÐ  rÓ  s    rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>Ÿ  sM   € ¨¨9¬Ð%5Ð$=¸2ð $ÝØIÐI¨AÐ.>Ô,?×,FÒ,FÑ,HÔ,HÐIÑIÔIØñô ð r'   zRead Throughputc                 ó|   — | d          rdp1t          d„ | d                              ¦   «         D ¦   «         d¦  «        S )NrQ  ro   c              3   ó`   K  — | ])} |d          |¦  «         |d         |¦  «        pdz  V — Œ*dS )rÔ  rÚ  ç�íµ ÷Æ°>NrK   rÌ  s     rH   rÎ  z;HTTPServer.clear_stats.<locals>.<lambda>.<locals>.<genexpr>¦  s\   è è € ð ð àð $�A�l”O AÑ&Ô&¨.¨!¨K¬.¸Ñ*;Ô*;Ð*C¸tÑDðð ð ð ð ð r'   rÏ  r   rÐ  rÓ  s    rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>¤  sZ   € ¨q°¬|Ð+;Ð*CÀð *Ýðð àÐ/Ô0×7Ò7Ñ9Ô9ðñ ô ð ñô ð r'   zWrite Throughputc                 ó|   — | d          rdp1t          d„ | d                              ¦   «         D ¦   «         d¦  «        S )NrQ  ro   c              3   ó`   K  — | ])} |d          |¦  «         |d         |¦  «        pdz  V — Œ*dS )r×  rÚ  rß  NrK   rÌ  s     rH   rÎ  z;HTTPServer.clear_stats.<locals>.<lambda>.<locals>.<genexpr>®  s]   è è € ð ð àð '�A�oÔ& qÑ)Ô)¨^¨Q¨{¬^¸AÑ->Ô->Ð-FÀ$ÑGðð ð ð ð ð r'   rÏ  r   rÐ  rÓ  s    rH   r»  z(HTTPServer.clear_stats.<locals>.<lambda>¬  sZ   € °°)´Ð,<Ð+DÀ"ð +Ýðð àÐ/Ô0×7Ò7Ñ9Ô9ðñ ô ð ñô ð r'   rÏ  zCheroot HTTPServer %d)Ú_start_timeÚ	_run_timerV  rY  r-   Úidrc   s   `rH   r±  zHTTPServer.clear_stats�  su  ø€ àˆÔØˆŒð0
Ø�uð0
àÐ:Ð:Ð:Ð:ð0
ð ð ð ð ð ð0
ð
 �qð0
ð ÐBÐBÐBÐBð0
ð ÐDÐDÐDÐDð0
ð ÐLÐLÐLÐLð0
ð ÐJÐJÐJÐJð0
ð ˜Qð0
ð ð ð ð0
ð  ð ð ð!0
ð* ð ð ð+0
ð4 ð ð ð50
ð> ð  ð  ð?0
ðN ð !ð !ðO0
ð^ ˜bð_0
ˆŒ
ðb BFÄ�ÔÐ2µR¸±X´XÑ=Ñ>Ð>Ð>r'   c                 ód   — | j         €| j        S | j        t          j        ¦   «         | j         z
  z   S )zReturn server uptime.)râ  rã  Útimerc   s    rH   r¾  zHTTPServer.runtime¸  s.   € àÔÐ#Ø”>Ð!ØŒ~¥¤¡¤¨tÔ/?Ñ!?Ñ@Ð@r'   c                 ó@   — | j         ›d| j        j        ›d| j        ›d�S )z1Render Server instance representing bind address.ú.ú(r¡   )rR   rZ   rQ   r¬  rc   s    rH   Ú__str__zHTTPServer.__str__¾  s.   € ð ŒOˆOˆOØŒNÔ#Ð#Ð#ØŒNˆNˆNð
ð 	
r'   c                 ó   — | j         S )a³  Return the interface on which to listen for connections.

        For TCP sockets, a (host, port) tuple. Host values may be any
        :term:`IPv4` or :term:`IPv6` address, or any valid hostname.
        The string 'localhost' is a synonym for '127.0.0.1' (or '::1',
        if your hosts file prefers :term:`IPv6`).
        The string '0.0.0.0' is a special :term:`IPv4` entry meaning
        "any active interface" (INADDR_ANY), and '::' is the similar
        IN6ADDR_ANY for :term:`IPv6`.
        The empty string or :py:data:`None` are not allowed.

        For UNIX sockets, supply the file name as a string.

        Systemd socket activation is automatic and doesn't require tempering
        with this variable.

        .. glossary::

           :abbr:`IPv4 (Internet Protocol version 4)`
              Internet Protocol version 4

           :abbr:`IPv6 (Internet Protocol version 6)`
              Internet Protocol version 6
        )Ú
_bind_addrrc   s    rH   r¬  zHTTPServer.bind_addrÆ  s   € ð4 ŒÐr'   c                 óp   — t          |t          ¦  «        r|d         dv rt          d¦  «        ‚|| _        dS )z5Set the interface on which to listen for connections.r   >   Nr   zzHost values of '' or None are not allowed. Use '0.0.0.0' (IPv4) or '::' (IPv6) instead to listen on all active interfaces.N)r%  rÛ   r3   rì  )r@   r1  s     rH   r¬  zHTTPServer.bind_addrâ  sJ   € õ �e�UÑ#Ô#ð 	¨¨a¬°JÐ(>Ð(>õ ð6ñô ð ð
  ˆŒˆˆr'   c                 óº   — 	 |                       ¦   «          dS # t          $ r}| j        }|s|| _        ||‚d}~wt          $ r}| j        }|s|| _        ||‚d}~ww xY w)z4Run the server forever, and stop it cleanly on exit.N)Ústartr[  Ú	interruptr\  )r@   Úkb_intr_excÚunderlying_interruptÚsys_exit_excs       rH   Ú
safe_startzHTTPServer.safe_start÷  s�   € ð	9Ø�JŠJ‰LŒLˆLˆLˆLøÝ ð 	8ð 	8ð 	8Ø#'¤>Ð Ø'ð -Ø!,�”ØÐ#7Ð7øøøøÝð 	9ð 	9ð 	9Ø#'¤>Ð Ø'ð .Ø!-�”ØÐ$8Ð8øøøøð		9øøøs   ‚ ˜
A¢5µAÁAÁAc                 ó(  — d| _         | j        €d| j        z  | _        d| _        d}t	          j        dd¦  «        r1t          j        dt          j        t          j        ¦  «        | _        �n€t          | j
        t          t          f¦  «        rY	 |                      | j
        ¦  «         �nB# t          j        $ r*}|›d| j
        ›d|›d�}t          j        |¦  «        |‚d}~ww xY w| j
        \  }}	 t          j        ||t          j        t          j        d	t          j        ¦  «        }nO# t          j        $ r= t          j        }| j
        }d
|v rt          j        }|dz   }|t          j        d	d|fg}Y nw xY w|D ]q}|\  }	}
}}}	 |                      |	|
|¦  «          nN# t          j        $ r<}|›d|›d|›d�}| j        r| j                             ¦   «          d| _        Y d}~Œjd}~ww xY w| j        st          j        |¦  «        ‚| j                             d¦  «         | j                             | j        ¦  «         t3          j        | ¦  «        | _        | j                             ¦   «          d| _        t?          j        ¦   «         | _         dS )zšPrepare server to serving requests.

        It binds a socket's port, setups the socket to ``listen()`` and does
        other preparing things.
        Nz	%s ServerzNo socket could be createdÚ
LISTEN_PIDr!  z -- (z: r¡   r   ú:)r   r   r   r   T)!Ú
_interruptÚsoftwarer¯  r  ÚosÚgetenvÚfromfdÚAF_INETÚSOCK_STREAMr%  r¬  r$  ÚbytesÚbind_unix_socketr  ÚgetaddrinfoÚ	AF_UNSPECÚ
AI_PASSIVEÚgaierrorr   Úbindr€   Ú
settimeoutÚlistenÚrequest_queue_sizer   ÚConnectionManagerÚ_connectionsr®  rï  r·   ræ  râ  )r@   r  ÚserrÚhostrå   ÚinfoÚ	sock_typer¬  rs   ÚafÚsocktyperA  Ú
_canonnameÚsas                 rH   ÚpreparezHTTPServer.prepare  sÅ  € ð ˆŒàŒ=Ð Ø'¨$¬,Ñ6ˆDŒMð ˆŒØ*ˆÝŒ9�\ 4Ñ(Ô(ð +	'å œ-¨­6¬>½6Ô;MÑNÔNˆDŒK‰KÝ˜œ­­e¨Ñ5Ô5ð (	'ð2Ø×%Ò% d¤nÑ5Ô5Ð5Ñ5øÝ”<ð 2ð 2ð 2Ø*-¨#¨#¨t¬~¨~¨~¸t¸t¸tÐD�Ý”l 3Ñ'Ô'¨TÐ1øøøøð2øøøð œ‰JˆD�$ðKÝÔ)ØØÝÔ$ÝÔ&ØÝÔ%ñô ��øõ ”?ð Kð Kð KÝ"œN�	Ø œN�	à˜$�;�;Ý &¤�IØ )¨FÑ 2�Ià"¥FÔ$6¸¸2¸yÐIÐJ���ðKøøøð ð 	'ð 	'�Ø69Ñ3��H˜e Z°ð'Ø—I’I˜b (¨EÑ2Ô2Ð2Ø�EøÝ”|ð 'ð 'ð 'Ø.1¨c¨c°2°2°2°t°t°tÐ<�CØ”{ð ,Øœ×)Ò)Ñ+Ô+Ð+Ø"&�D”K�K�K�K�K�Køøøøð	'øøøð Œ{ð 	$Ý”,˜sÑ#Ô#Ð#ð 	Œ×Ò˜qÑ!Ô!Ð!ØŒ×Ò˜4Ô2Ñ3Ô3Ð3õ (Ô9¸$Ñ?Ô?ˆÔð 	Œ×ÒÑÔÐàˆŒ
Ýœ9™;œ;ˆÔÐÐsC   ÂB+ Â+C$Â:%CÃC$Ã27D* Ä*A	E6Å5E6ÆFÆG*Æ.2G%Ç%G*c                 ó¶  — | j         rÑ| j                             ¦   «         }|t          u rdS t	          | |¦  «        }	 |                     d¦  «         nb# t          t          j        f$ r Y Œjt          $ r>}| j
                             t          |¦  «        t          j        d¬¦  «         Y d}~nd}~ww xY wd|_        |                     ¦   «          | j         °ÏdS dS )z(Serve connections we can't handle a 503.Nz503 Service UnavailableTrR  )r·   r´  r>   Ú_STOPPING_FOR_INTERRUPTr   rÉ   ÚOSErrorr   r]  r`  rµ   rX  r¦   rY  ra  rk  r€   )r@   r¶   Úrequestr   s       rH   Ú_serve_unservicablezHTTPServer._serve_unservicableQ  s  € àŒjð 	ØÔ+×/Ò/Ñ1Ô1ˆDØÕ.Ð.Ð.Ø�Ý! $¨Ñ-Ô-ˆGðØ×'Ò'Ð(AÑBÔBÐBÐBøÝ�VÔ1Ð2ð ð ð ð �Ýð ð ð ð ”×%Ò%Ý˜‘H”HÝ!œ-Ø"ð &ñ ô ð ð ð ð ð ð øøøøð	øøøð ˆDŒKØ�JŠJ‰LŒLˆLð+ Œjð 	ð 	ð 	ð 	ð 	s   ½A ÁB2Á+	B2Á44B-Â-B2c                 óÐ  — t          j        | j        ¬¦  «                             ¦   «          | j        ry| j        sr	 | j                             | j        ¦  «         nC# t          t          f$ r ‚ t          $ r% |                      dt          j        d¬¦  «         Y nw xY w| j        r| j        ¯r| j        r0| j        rt!          j        d¦  «         | j        °| j        r	| j        ‚dS dS )z1Serve requests, after invoking :func:`prepare()`.©ÚtargetzError in HTTPServer.serveTrR  gš™™™™™¹?N)Ú	threadingÚThreadr  rï  r·   rð  r
  ÚrunÚexpiration_intervalr[  r\  r`  rX  rY  ra  Ú_stopping_for_interruptræ  Úsleeprc   s    rH   ÚservezHTTPServer.servej  s-  € õ
 	Ô Ô 8Ð9Ñ9Ô9×?Ò?ÑAÔAÐAàŒjð 
	 ¤ð 
	ð	ØÔ!×%Ò% dÔ&>Ñ?Ô?Ð?Ð?øÝ%¥zÐ2ð ð ð ØÝð ð ð Ø—’Ø/Ý!œ-Ø"ð ñ ô ð ð ð ðøøøð Œjð 
	 ¤ð 
	ð Œ>ð 	%ØÔ.ð  Ý”
˜3‘”�ð Ô.ð  àŒ~ð %Ø”nÐ$ð		%ð 	%ð%ð %s   ¼A Á=BÂBc                 óV   — |                       ¦   «          |                      ¦   «          dS )zmRun the server forever.

        It is shortcut for invoking :func:`prepare()` then :func:`serve()`.
        N)r  r"  rc   s    rH   rï  zHTTPServer.start…  s"   € ð 	�Š‰ŒˆØ�
Š
‰Œˆˆˆr'   c              #   ó   K  — |                       ¦   «          t          j        | j        ¬¦  «        }d|_        |                     ¦   «          	 |V — |                      ¦   «          dS # |                      ¦   «          w xY w)z4Context manager for running this server in a thread.r  TN)r  r  r  r"  Údaemonrï  Ústop)r@   Úthreads     rH   Ú_run_in_threadzHTTPServer._run_in_thread‘  so   è è € ð 	�Š‰ŒˆÝÔ!¨¬Ð4Ñ4Ô4ˆØˆŒØ�Š‰Œˆð	ØˆLˆLˆLà�IŠI‰KŒKˆKˆKˆKøˆD�IŠI‰KŒKˆKˆKøøøs   ÁA' Á'A=c                 ó(   — | j         o| j        j        S )z>Flag whether it is allowed to add a new keep-alive connection.)r·   r
  r7  rc   s    rH   r7  z'HTTPServer.can_add_keepalive_connection�  s   € ð ŒzÐL˜dÔ/ÔLÐLr'   c                 ót   — | j         r| j                             |¦  «         dS |                     ¦   «          dS )z7Put an idle connection back into the ConnectionManager.N)r·   r
  Úputr€   ©r@   r¶   s     rH   Úput_connzHTTPServer.put_conn¢  s<   € àŒ:ð 	ØÔ×!Ò! $Ñ'Ô'Ð'Ð'Ð'ð �JŠJ‰LŒLˆLˆLˆLr'   r   é   c                 ó.  — t           j                             |›d�¦  «         t           j                             ¦   «          |rRt	          j        ¦   «         }t           j                             |¦  «         t           j                             ¦   «          dS dS )zôWrite error message to log.

        :param msg: error message
        :type msg: str

        :param level: logging level
        :type level: int

        :param traceback: add traceback to output or not
        :type traceback: bool
        ú
N)ÚsysÚstderrr  ÚflushÚ
traceback_Ú
format_exc)r@   r  rS  rT  Útbliness        rH   rX  zHTTPServer.error_logª  s„   € õ 	Œ
×Ò˜C˜˜˜Ñ&Ô&Ð&ÝŒ
×ÒÑÔÐØð 	Ý Ô+Ñ-Ô-ˆGÝŒJ×Ò˜WÑ%Ô%Ð%ÝŒJ×ÒÑÔÐÐÐð	ð 	r'   c           	      óÜ   — |                       | j        |||| j        | j        | j        ¦  «        }|                      || j        ¦  «        x}| _        |                      |¦  «        | _        |S )z.Create (or recreate) the actual socket object.)Úprepare_socketr¬  Únodelayrº   r°  Úbind_socketr  Úresolve_real_bind_addr)r@   rt  ÚtyperA  rN  s        rH   r  zHTTPServer.bind¾  so   € à×"Ò"ØŒNØØØØŒLØÔØŒOñ
ô 
ˆð "×-Ò-¨d°D´NÑCÔCÐCˆˆtŒ{Ø×4Ò4°TÑ:Ô:ˆŒØˆr'   c           	      óæ  — t           r	 t          d¦  «        ‚d}	 t          j        | j        ¦  «         nd# t
          $ r Y nXt          $ r}t          |¦  «        }d|vr‚ Y d}~n6d}~wt          $ r&}t          |¦  «        }d|vr	d|vrd|vr‚ Y d}~nd}~ww xY w|                      |t          j
        t          j        d| j        | j        | j        ¬	¦  «        }	 	 t          j        |                     ¦   «         |¦  «         d
}n# t
          $ r d}Y nw xY w	 |                      ||¦  «        }n(# t          j        $ r |                     ¦   «          ‚ w xY w|                      |¦  «        }	 	 |s@	 t          j        ||¦  «         n'# t,          $ r t          j        ||d¬¦  «         Y nw xY wd
}n# t
          $ r Y nw xY w|s!|                      dt2          j        ¬¦  «         || _        || _	        |S )z*Create (or recreate) a UNIX socket object.z0AF_UNIX sockets are not supported under Windows.iÿ  zJremove() argument 1 must be encoded string without null bytes, not unicodeNz'unlink: embedded null character in pathzembedded null bytez0argument must be a string without NUL charactersr   )r¬  rt  r<  rA  r9  rº   r°  TF)Úfollow_symlinksz(Failed to set socket fs mode permissions)rS  )rs  r3   rú  Úunlinkr¬  r  Ú	TypeErrorr$  r8  r  ru  rþ  r9  rº   r°  ÚfchmodÚfilenor:  r  r€   r;  Úlchmodri  ÚchmodrX  rY  rZ  )r@   r¬  Úfs_permissionsÚtyp_errÚerr_msgÚval_errrN  ÚFS_PERMS_SETs           rH   r   zHTTPServer.bind_unix_socketÍ  sÐ  € åð 	ðõ ØBñô ð ð ˆð	åŒI�d”nÑ%Ô%Ð%Ð%øÝð 	ð 	ð 	ðð õ ð 	ð 	ð 	Ý˜'‘l”lˆGð9Ø@GðHð Hð ðHð Hð Hð Hð Høøøøõ ð 	ð 	ð 	Ý˜'‘l”lˆGà9ÀÐHÐHØ(°Ð7Ð7ØFØðð ð øøøøøøøøøð	øøøð ×"Ò"ØÝ”>ÝÔ#ØØ”LØÔ(Ø”ð #ñ 
ô 
ˆð	!ØBåŒI�d—k’k‘m”m ^Ñ4Ô4Ð4ØˆLˆLøÝð 	!ð 	!ð 	!Ø ˆLˆLˆLð	!øøøð	Ø×#Ò# D¨)Ñ4Ô4ˆDˆDøÝŒ|ð 	ð 	ð 	Ø�JŠJ‰LŒLˆLØð	øøøð ×/Ò/°Ñ5Ô5ˆ	ð		ØCØð $ðOÝ”I˜i¨Ñ8Ô8Ð8Ð8øÝ%ð Oð Oð OÝ”H˜Y¨ÈÐNÑNÔNÐNÐNÐNðOøøøà#�øøÝð 	ð 	ð 	ØˆDð	øøøð ð 	Ø�NŠNØ:Ý”oð ñ ô ð ð
 #ˆŒØˆŒØˆs{   ›5 µ
BÁ	BÁ
A#Á#BÁ0BÂBÃ*D ÄDÄDÄD. Ä.%EÅ,F0 Å0F ÆF0 Æ!F*Æ'F0 Æ)F*Æ*F0 Æ0
F=Æ<F=c                 ó4  — |d d…         \  }}|dk    }| j         t          j        t          j        hvrt	          d¦  «        ‚|rt	          d¦  «        ‚t          t          d¦  «        r-|                      t          j        t          j        d¦  «         d S t          t          d¦  «        r-|                      t          j        t          j	        d¦  «         d S t          r-|                      t          j        t          j        d¦  «         d S t          d¦  «        ‚)	Nr    r   zCannot reuse a non-IP socketz"Cannot reuse an ephemeral port (0)ÚSO_REUSEPORT_LBr   ÚSO_REUSEPORTz,Current platform does not support port reuse)rt  r  rý  r   r3   ÚhasattrÚ
setsockoptry  rK  rL  rs  ÚSO_REUSEADDRrv  )Úsocket_r¬  Ú_hostrå   ÚIS_EPHEMERAL_PORTs        rH   Ú_make_socket_reusablez HTTPServer._make_socket_reusable!  s
  € à   ”m‰ˆˆtØ  AšIÐàŒ>¥&¤.µ&´/Ð!BÐBÐBÝÐ;Ñ<Ô<Ð<àð 	CÝÐAÑBÔBÐBõ •6Ð,Ñ-Ô-ð 		Ø×Ò�vÔ0µ&Ô2HÈ!ÑLÔLÐLÐLÐLÝ•V˜^Ñ,Ô,ð 	Ø×Ò�vÔ0µ&Ô2EÀqÑIÔIÐIÐIÐIÝð 	Ø×Ò�vÔ0µ&Ô2EÀqÑIÔIÐIÐIÐIå%Ø>ñô ð r'   c                 ó   — t          j         |||¦  «        }t          j        |¦  «         |dd…         \  }	}
|
dk    }|r|                      ||¬¦  «         t          s.|s,	 |                     t           j        t           j        d¦  «         |rGt          |t          t          f¦  «        s+|                     t           j        t           j        d¦  «         |�|                     |¦  «        }t          t           d¦  «        o|t           j        k    o|	dv }|rgt!          j        t$          t           j        ¦  «        5  |                     t           j        t           j        d¦  «         ddd¦  «         n# 1 swxY w Y   |S )z%Create and prepare the socket object.Nr    r   ©rP  r¬  r   r   >   ú::ú::0ú	::0.0.0.0)r  r   Úprevent_socket_inheritancerS  rs  rN  ry  rO  r%  r$  rÿ  ÚIPPROTO_TCPÚTCP_NODELAYr  rM  r   rã   rä   ri  r  r   r   )Úclsr¬  rt  r<  rA  r9  rº   r°  rN  r  rå   rR  Úlistening_ipv6s                rH   r8  zHTTPServer.prepare_socket;  sÁ  € õ Œ}˜V T¨5Ñ1Ô1ˆÝÔ.¨tÑ4Ô4Ð4à˜r ˜r”]‰
ˆˆdØ  AšIÐàð 	IØ×%Ò%¨d¸iÐ%ÑHÔHÐHåð 	GÐ/ð 	Gð	ð �OŠO�FÔ-­vÔ/BÀAÑFÔFÐFØð 	G�: iµ#µu°Ñ>Ô>ð 	GØ�OŠO�FÔ.µÔ0BÀAÑFÔFÐFàÐ"Ø×#Ò# DÑ)Ô)ˆDõ •F˜JÑ'Ô'ð 3Ø�&œ/Ò)ð3àÐ2Ð2ð 	ð
 ð 	ÝÔ$¥^µV´\ÑBÔBð ð ð —’ÝÔ'ÝÔ&Øñô ð ðð ð ñ ô ð ð ð ð ð ð øøøð ð ð ð ð ˆs   Ä;,E3Å3E7Å:E7c                 ó0   — |                       |¦  «         | S )z#Bind the socket to given interface.)r  rU  s     rH   r:  zHTTPServer.bind_socketv  s   € ð 	�Š�YÑÔÐØˆr'   c                 óÊ   — |                       ¦   «         }| j        t          j        t          j        hv r	 |dd…         S t          |t          ¦  «        rt          |¦  «        }|S )z/Retrieve actual bind address from bound socket.Nr    )Úgetsocknamert  r  rý  r   r%  rÿ  r	   rU  s     rH   r;  z!HTTPServer.resolve_real_bind_addr|  sk   € ð
 ×'Ò'Ñ)Ô)ˆ	ØŒ>åŒNÝŒOð
ð 
ð 
ð
ð ˜R˜a˜R”=Ð å�i¥Ñ'Ô'ð 	(Ý˜Y™œˆIàÐr'   c                 óœ   — 	 | j                              |¦  «         dS # t          j        $ r | j                             |¦  «         Y dS w xY w)z#Process an incoming HTTPConnection.N)r®  r+  r²  ÚFullr´  r,  s     rH   Úprocess_connzHTTPServer.process_conn’  s`   € ð	/ØŒM×Ò˜dÑ#Ô#Ð#Ð#Ð#øÝŒzð 	/ð 	/ð 	/ØÔ$×(Ò(¨Ñ.Ô.Ð.Ð.Ð.Ð.ð	/øøøs   ‚ ž)AÁ
Ac                 ó   — | j         S )zFlag interrupt of the server.)rø  rc   s    rH   rð  zHTTPServer.interrupt™  s   € ð ŒÐr'   c                 ó   — | j         t          u S )z8Return whether the server is responding to an interrupt.)rø  r  rc   s    rH   r   z"HTTPServer._stopping_for_interruptž  s   € ð ŒÕ"9Ð9Ð9r'   c                 óü   — t           | _        t          |t          ¦  «        r|                      d¦  «         t          |t
          ¦  «        r|                      d¦  «         |                      ¦   «          || _        dS )a  Perform the shutdown of this server and save the exception.

        Typically invoked by a worker thread in
        :py:mod:`~cheroot.workers.threadpool`, the exception is raised
        from the thread running :py:meth:`serve` once :py:meth:`stop`
        has completed.
        z!Keyboard Interrupt: shutting downz SystemExit raised: shutting downN)r  rø  r%  r[  rX  r\  r&  )r@   rð  s     rH   rð  zHTTPServer.interrupt£  so   € õ 2ˆŒå�iÕ!2Ñ3Ô3ð 	@Ø�NŠNÐ>Ñ?Ô?Ð?å�i¥Ñ,Ô,ð 	?Ø�NŠNÐ=Ñ>Ô>Ð>à�	Š	‰ŒˆØ#ˆŒˆˆr'   c                 óX  — | j         sdS d| _         | j                             t          ¦  «         | j        �)| xj        t          j        ¦   «         | j        z
  z  c_        d| _        | j                             ¦   «          t          | dd¦  «        }|�r^t          | j        t          t          f¦  «        �s	 |                     ¦   «         dd…         \  }}t          j        ||t          j        t          j        ¦  «        D ]Ž}|\  }}}}}	d}
	 t          j        |||¦  «        }
|
                     d¦  «         |
                     ||f¦  «         |
                     ¦   «          Œd# t          j        $ r |
r|
                     ¦   «          Y Œ‹w xY wn6# t          j        $ r$}|j        d         t0          j        vr‚ Y d}~nd}~ww xY wt5          |d¦  «        r|                     ¦   «          d| _        | j                             ¦   «          | j                             | j        ¦  «         dS )z5Gracefully shutdown a server that is serving forever.NFr  r    g      ð?r   r€   )r·   r´  r+  r  râ  rã  ræ  r
  r&  r9  r%  r¬  r$  rÿ  r`  r  r  r  rþ  r  Úconnectr€   r  ré   r   r  rM  r®  Úshutdown_timeout)r@   rN  r  rå   rs   r  r  rA  r  Ú_sarº  r   s               rH   r&  zHTTPServer.stop·  sG  € àŒzð 	ØˆFàˆŒ
ð 	Ô ×$Ò$Õ%<Ñ=Ô=Ð=àÔÐ'ØˆNŒN�dœi™kœk¨DÔ,<Ñ<Ñ<ˆNŒNØˆÔàÔ×ÒÑ Ô Ð å�t˜X tÑ,Ô,ˆØñ %	Ý˜dœn­sµE¨lÑ;Ô;ñ !*ð*Ø!%×!1Ò!1Ñ!3Ô!3°B°Q°BÔ!7‘J�D˜$õ  &Ô1ØØÝÔ(ÝÔ*ñ	 ô  ð *ð *˜ð @CÑ<˜˜H e¨Z¸Ø ˜ð
*Ý &¤¨b°(¸EÑ BÔ B˜Að ŸLšL¨Ñ-Ô-Ð-ØŸIšI t¨T lÑ3Ô3Ð3ØŸGšG™IœI˜I˜IøÝ%œ|ð *ð *ð *Ø ð *Ø !§¢¡	¤	 	øøð*øøøð!*øõ ”|ð ð ð Ø”w˜q”z­Ô)GÐGÐGð ð	 HÐGÐGÐGÐGøøøøðøøøõ< �t˜WÑ%Ô%ð Ø—
’
‘”�ØˆDŒKàÔ×ÒÑ!Ô!Ð!ØŒ×Ò˜4Ô0Ñ1Ô1Ð1Ð1Ð1s+   Â7F ÄAE%Å%%FÆFÆGÆ F?Æ?G)r©  ro   NFFF)r   r.  Fr‹   )F);rQ   rR   rS   rT   rì  rø  r  rµ  r¶  r=  rî   r  ri  r8  r  r   r¯  rù  r·   rÇ   r  r9  r   ÚConnectionClassrº   rJ  rK  r°  Úkeep_alive_conn_limitr`   r±  r¾  rê  r§  r¬  Úsetterrô  r  r  r"  rï  rã   Úcontextmanagerr(  r7  r-  rX  r  r   ÚstaticmethodrS  Úclassmethodr8  r:  r;  rc  rð  r   r&  rK   r'   rH   r   r   õ  sZ  € € € € € ØÐà€JØ€Jà€GØà€JØFà€Jðð €KØ?à€Hð&ð
 Ðð/ð Ððð €GØGàÐðð )˜Ð(Ð(€GØ.à€Hðð
 €EØMàÐØMàÐØLà€GØNà$€OØ9à€Kðð Ððð
 !&Ððð
 €JØ2àÐðAð ØØØØ"'Øð*1ð *1ð *1ð *1ðX5Lð 5Lð 5LðnAð Að Að
ð 
ð 
ð ðð ñ „Xðð6 Ôð ð  ñ Ôð ð(9ð 9ð 9ðI'ð I'ð I'ðVð ð ð2%ð %ð %ð6
ð 
ð 
ð Ôð	ð 	ñ Ôð	ð ðMð Mñ „XðMðð ð ðð ð ð ð(ð ð ð ðRð Rð Rðh ðð ñ „\ðð2 ð ð8ð 8ð 8ñ „[ð8ðt ðð ñ „\ðð
 ðð ñ „\ðð*/ð /ð /ð ðð ñ „Xðð ð:ð :ñ „Xð:ð Ôð$ð $ñ Ôð$ð&:2ð :2ð :2ð :2ð :2r'   r   c                   ó   — e Zd ZdZd„ Zd„ ZdS )r   zDBase class to interface HTTPServer with other systems, such as WSGI.c                 ó   — || _         dS )zuInitialize Gateway instance with request.

        Args:
            req (HTTPRequest): current HTTP request
        N)rc  )r@   rc  s     rH   r`   zGateway.__init__÷  s   € ð ˆŒˆˆr'   c                 ó   — t           ‚)z>Process the current request. Must be overridden in a subclass.)rv  rc   s    rH   r  zGateway.respondÿ  s   € å!Ð!r'   N)rQ   rR   rS   rT   r`   r  rK   r'   rH   r   r   ô  s8   € € € € € ØNÐNðð ð ð"ð "ð "ð "ð "r'   r   z%cheroot.ssl.builtin.BuiltinSSLAdapterz&cheroot.ssl.pyopenssl.pyOpenSSLAdapter)ÚbuiltinÚ	pyopensslrt  c                 óâ  — t           |                      ¦   «                  }t          |t          ¦  «        rº|                     d¦  «        }||dz   d…         }|d|…         }	 t
          j        |         }|€t          ‚n;# t          $ r. t          |t          ¦   «         t          ¦   «         dg¦  «        }Y nw xY w	 t          ||¦  «        }n$# t          $ r t          d|›d|›d�¦  «        ‚w xY w|S )z/Return an SSL adapter class for the given name.rè  r   Nr   ú'z' object has no attribute ')Ússl_adaptersr	  r%  r$  Úrfindr1  ÚmodulesÚKeyErrorÚ
__import__ÚglobalsÚlocalsr9  ri  )ÚnameÚadapterÚlast_dotÚ	attr_nameÚmod_pathÚmods         rH   r   r   	  s  € å˜4Ÿ:š:™<œ<Ô(€GÝ�'�3ÑÔð Ø—=’= Ñ%Ô%ˆØ˜H q™L˜N˜NÔ+ˆ	Ø˜9˜H˜9Ô%ˆð	BÝ”+˜hÔ'ˆCØˆ{Ý�ð øåð 	Bð 	Bð 	Bå˜X¥w¡y¤yµ&±(´(¸R¸DÑAÔAˆCˆCˆCð	Bøøøð
	Ý˜c 9Ñ-Ô-ˆGˆGøÝð 	ð 	ð 	Ý �.Ø7?°x°xÀÀÀÐKñô ð ð	øøøð
 €Ns   Á"A> Á>5B6Â5B6Â:C Ã!C,)rt  )KrT   rã   Úemail.utilsr:  r¤  rY  rú  Úplatformr²  Úrer  r1  r  ræ  rT  r4  Úurllib.parserÒ   Ú	functoolsr   r   r   r   r   Ú_compatr   r	   rO  r
   r   Úworkersr   Ú__all__Úsystemrs  rû  rÚ   ÚIS_GAEr‹  r�  rŒ  ÚImportErrorrz  rM  r   r   r   rq   r4   r7   r6   r:   r¢   rr   ÚASTERISKrç   rê   Úcompiler?   rè   r`  r  r=   r-   r   r   r   r   r   r   r   r   r   rx  r   rK   r'   rH   ú<module>r’     sÕ  ððAð AðF Ð Ð Ð Ø Ð Ð Ð Ø 	€	€	€	Ø €€€Ø 	€	€	€	Ø €€€Ø €€€Ø 	€	€	€	Ø €€€Ø 
€
€
€
Ø Ð Ð Ð Ø €€€Ø Ð Ð Ð Ø Ð Ð Ð Ø Ð Ð Ð Ð Ð à .Ð .Ð .Ð .Ð .Ð .Ð .Ð .Ð .Ð .Ø !Ð !Ð !Ð !Ð !Ð !Ð !Ð !Ø ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ð ,Ø Ð Ð Ð Ð Ð ð€ð ˆXŒ_ÑÔ )Ò+€
Ø ?ð 
ˆŒÐ$ bÑ	)Ô	)×	4Ò	4Ð5IÑ	JÔ	J€ðð '˜Ð5¨v¨:Ð Ø Nð ð (ð
Øˆ
ˆ
ˆ
Øˆ
ˆ
ˆ
ˆ
øØð ð ð ð	ð
 !&ÐØ‰ˆˆSˆSˆSðøøøð €M€M€M€Mà'Ñ€Cˆˆfð ð  �'�'˜& *Ñ-Ô-ð  Øˆ7�6˜>Ñ*Ô*ð !Ø ˆÔØˆ7�6˜=Ñ)Ô)ð  ØˆÔð €wˆv�}Ñ%Ô%ð .ðð
  &Ð-˜˜¨2€FÔð €Ø€Ø€Ø€Ø€Ø€	Ø€Ø€Ø€Ø€Ø�R”Z §¢¨'°<Ð)@Ñ AÔ AÑBÔBÐ ð $˜)™+œ+Ð ðð ð Ð ð6 €wˆw˜Ñ%Ô%ð Ø€GÔðD(ð D(ð D(ð D(ð D(ñ D(ô D(ð D(ðN,ð ,ð ,ð ,ð , ñ ,ô ,ð ,ð^ð ^ð ^ð ^ð ^ñ ^ô ^ð ^ðBWð Wð Wð Wð Wñ Wô Wð Wðt~ð ~ð ~ð ~ð ~ñ ~ô ~ð ~ðBY	/ð Y	/ð Y	/ð Y	/ð Y	/ñ Y	/ô Y	/ð Y	/ðxCð Cð Cð Cð Cñ Cô Cð CðL|2ð |2ð |2ð |2ð |2ñ |2ô |2ð |2ð~"ð "ð "ð "ð "ñ "ô "ð "ð& 7Ø9ðð €ðð ð ð ð ð s   Â&B/ Â/B?Â>B?