Mh dZddlZddlZddlZddlZddlZddlm Z ddl m Z ddl Z ddlZddlmZddlZddlZddlmZmZmZmZddlmZmZmZmZddlmZmZe ddl Z dd l m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+e j,r%dd l m-Z-dd l.m/Z/ddl0Z0ej1j2e3e3fZ4n ej1j2Z4d Z5ej6d Z7GddZ8e dde3de3fdZ9Gdde4Z:GddZ;Gdde<Z=Gdde<Z>GddZ?GddZ@Gd d!ZAd"e3d#e'de&e3e3fe#e!e3e3fe!e!e3e3fd$ffde3fd%ZBGd&d'eZCd(e3de(e!e(eDe(eDffd)ZEd*e(eDd+e(eDd,eDde3fd-ZFd.e3de(eDfd/ZG dWd0e3d1eHd2e&e3e#eHfd3e&e3e#eCfd4e(e:ddf d5ZId6eHd7eHd2e&e3e#eHfd3e&e3e#eCfddf d8ZJd9e'eDeKeLejMejfde3fd:ZNGd;dZQGd?d@e jOZRd=e3deRfdAZSdBe3de*e3ddffdCZTd=e3de!e3e&e3e3fffdDZUdEe3dFe&e3e3fde3fdGZVdHe'e3eHfdIe'e3eHfdeHfdJZWdKZXej6dLZYdMe3de!e3e(eDffdNZZdOe&e3e#e+fde"e!e3e+ffdPZ[ej6dQj\Z]dRej^de3fdSZ_dBe3de3fdTZ`dUe3de&e3e3ffdVZadS)XzHTTP utility code shared by clients and servers. This module also defines the `HTTPServerRequest` class which is exposed via `tornado.web.RequestHandler.request`. N) lru_cache) responses)SSLError) urlencodeurlparse urlunparse parse_qsl) native_strparse_qs_bytesutf8 to_unicode) ObjectDict unicode_type) TupleIterableListMappingIteratorDictUnionOptional Awaitable GeneratorAnyStr)Deque)Futurez z [\x00-\x08\x0B\x0C\x0E-\x1F\x7F]c eZdZdZejdZejdZejdZejdej dej dej dZ ejdZ ejd Z ejd Z ejd e j de j d Zejdej dej d ej d ej ZejdZejej dZeZeZejd e j de j dZejdZejde j de j dZejej dZejdej dej dej d ZejdZejdej dej dej dZdS)_ABNFa}Class that holds a subset of ABNF rules from RFC 9110 and friends. Class attributes are re.Pattern objects, with the same name as in the RFC (with hyphens changed to underscores). Currently contains only the subset we use (which is why this class is not public). Unfortunately the fields cannot be alphabetized as they are in the RFCs because of dependencies. z[A-Za-z0-9\-._~]z [!$&'()*+,;=]z%[0-9A-Fa-f]{2}z (?:[\[\]:]||z)*z[0-9]*z [\x21-\x7E]z [\x80-\xFF]z(?:)z| |\t)*z[!#$%&'*+\-.^_`|~0-9A-Za-z]+z)(?::z)?zHTTP/[0-9]\.[0-9]z (?:[\t ]|z)+(z) (z[0-9]{3}N)__name__ __module__ __qualname____doc__recompileuri_unreserveduri_sub_delimsuri_pct_encodedpatternuri_hosturi_portVCHARobs_text field_vchar field_valuetchartoken field_namemethodhost HTTP_version reason_phraserequest_target request_line status_code status_lineP/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/tornado/httputil.pyrrNs RZ 344NRZ 011N bj!344Orzd~-dd0FddI`dddHrz)$$H BJ~ & &Erz.))H"*GEMGGH4DGGGHHK"* V   V V   V V$/$7 V V@K@S V VK BJ5 6 6E BJ5=+++ , ,EJ F 2:HX-HHH4DHHH I ID2:233LBJPEMPPHSWWWKKKr?rinamereturncfdd|dDS)ziMap a header name to Http-Header-Case. >>> _normalize_header("coNtent-TYPE") 'Content-Type' -c6g|]}|Sr>) capitalize).0ws r@ z%_normalize_header..s ===Q\\^^===r?)joinsplit)rAs r@_normalize_headerrLs/ 88==TZZ__=== > >>r?c 8eZdZdZejdeeeefddfdZ ejdeeefddfdZ ejde eefddfdZ ejd eddfd Z dej d eddfd Z d d dedede ddfdZ dedeefdZdee eeffdZd d dede ddfdZed d dede ddfdZdededdfdZdedefdZdeddfdZdefdZdeej fdZddZeZdefdZeZdS) HTTPHeadersaA dictionary that maintains ``Http-Header-Case`` for all keys. Supports multiple values per key via a pair of new methods, `add()` and `get_list()`. The regular dictionary interface returns a single value per key, with multiple values joined by a comma. >>> h = HTTPHeaders({"content-type": "text/html"}) >>> list(h.keys()) ['Content-Type'] >>> h["Content-Type"] 'text/html' >>> h.add("Set-Cookie", "A=B") >>> h.add("Set-Cookie", "C=D") >>> h["set-cookie"] 'A=B,C=D' >>> h.get_list("set-cookie") ['A=B', 'C=D'] >>> for (k,v) in sorted(h.get_all()): ... print('%s: %s' % (k,v)) ... Content-Type: text/html Set-Cookie: A=B Set-Cookie: C=D _HTTPHeaders__argrBNcdSNr>selfrOs r@__init__zHTTPHeaders.__init__ r?cdSrQr>rRs r@rTzHTTPHeaders.__init__rUr?argscdSrQr>)rSrWs r@rTzHTTPHeaders.__init__rUr?kwargsc dSrQr>)rSrYs r@rTzHTTPHeaders.__init__rUr?c<i|_i|_d|_t|dkrft|dkrSt |dt r8|dD]\}}|||dS|j|i|dS)Nr) _dict_as_list _last_keylen isinstancerNget_alladdupdate)rSrWrYkvs r@rTzHTTPHeaders.__init__s   t99>>c&kkQ..:d1g{3S3S.Q))  1A   DK ( ( ( ( ( (r?T_chars_are_bytesrAvaluerhc$tj|std|z|r?tjt |std|zn,t |rtd|zt|}||_ ||vrRt||dzt|z|j |<|j | |dS|||<dS)z#Adds a new value for the given key.zInvalid header name %rInvalid header value %r,N)rr5 fullmatchHTTPInputErrorr2r _FORBIDDEN_HEADER_CHARS_REsearchrLr_r r]r^append)rSrArirh norm_names r@rczHTTPHeaders.adds ))$// B !9D!@AA A  H$..z%/@/@AA H%%>%FGGG H *0077 H$%>%FGGG%d++ "   4 ?++c1Ju4E4EE Jy ! M) $ + +E 2 2 2 2 2#DOOOr?cVt|}|j|gS)z2Returns all values for the given header as a list.)rLr^getrSrArrs r@get_listzHTTPHeaders.get_lists'%d++ }  B///r?c#^K|jD]\}}|D]}||fV dS)zReturns an iterable of all (name, value) pairs. If a header has multiple values, multiple pairs will be returned with the same name. N)r^items)rSrAvaluesris r@rbzHTTPHeaders.get_allsZ !M//11 $ $LD& $ $Um#### $ $ $r?linectjd|x}r|d|}|sdS|dtvr|jt dd|tz}|r:tj |ddst d|zn,t|rt d|z|j |jd xx|z cc<|j |jxx|z cc<dS | d d\}}n#t$rt d wxYw|||t| dS) aUpdates the dictionary with a single header line. >>> h = HTTPHeaders() >>> h.parse_line("Content-Type: text/html") >>> h.get('content-type') 'text/html' >>> h.parse_line("Content-Length: 42\r\n") >>> h.get('content-type') 'text/html' .. versionchanged:: 6.5 Now supports lines with or without the trailing CRLF, making it possible to pass lines from AsyncHTTPClient's header_callback directly to this method. .. deprecated:: 6.5 In Tornado 7.0, certain deprecated features of HTTP will become errors. Specifically, line folding and the use of LF (with CR) as a line separator will be removed. z\r?\n$Nrz.first header line cannot start with whitespace r\zInvalid header continuation %rrk:zno colon in header linerg)r'rpstartHTTP_WHITESPACEr_rnstriprr2rmror^r]rK ValueErrorrc)rSrzrhmnew_partrAris r@ parse_linezHTTPHeaders.parse_lines( )T** *1 % !'')) $D  F 7o % %~%$%UVVVTZZ888H O(228ABB<@@V()IH)TUUUV.44X>>O()BX)MNNN M$. )" - - - 9 - - - Jt~ & & &( 2 & & & & & @"jja00 ee @ @ @$%>??? @ HHekk/22EU      s D99Eheadersc|}d} |d|}|dkr |||d|n*|||dz}|dz}|||f|S)aReturns a dictionary from HTTP header text. >>> h = HTTPHeaders.parse("Content-Type: text/html\r\nContent-Length: 42\r\n") >>> sorted(h.items()) [('Content-Length', '42'), ('Content-Type', 'text/html')] .. versionchanged:: 5.1 Raises `HTTPInputError` on malformed headers instead of a mix of `KeyError`, and `ValueError`. rT r}Nrgr\)findr)clsrrhhrlfrzs r@parsezHTTPHeaders.parse#s8 CEE BdE**BRxx WUVV_?O PPP526>*DFE LL0@L A A A Br?cNt|}||j|<|g|j|<dSrQrLr]r^)rSrArirrs r@ __setitem__zHTTPHeaders.__setitem__Ns/%d++ % 9$)7 i   r?c6|jt|SrQ)r]rL)rSrAs r@ __getitem__zHTTPHeaders.__getitem__Ssz+D1122r?cDt|}|j|=|j|=dSrQrrus r@ __delitem__zHTTPHeaders.__delitem__Vs)%d++ Jy ! M) $ $ $r?c*t|jSrQ)r`r]rSs r@__len__zHTTPHeaders.__len__[s4:r?c*t|jSrQ)iterr]rs r@__iter__zHTTPHeaders.__iter__^sDJr?c t|SrQ)rNrs r@copyzHTTPHeaders.copyas4   r?cg}|D] \}}||d|d!d|S)Nz: r)rbrqrJ)rSlinesrAris r@__str__zHTTPHeaders.__str__jsX<<>> / /KD% LLD--E--- . . . .wwu~~r?)rBrN)r#r$r%r&typingoverloadrstrrrTrAnyboolrcrvrrbr classmethodrrrrintrrrr__copy__r __unicode__r>r?r@rNrNs8 _ gc49n5 $   _  _ gc3h/ D   _  _ eCHo $   _  _     _  )fj )C )D ) ) ) )FJ$$$$C$d$d$$$$,0S0T#Y0000 $%S/2$$$$AE111s111111f=A&&&C&d&m&&&[&T++C+D++++ 333333%%%%%%  (6:.    !!!!H KKKr?rNcpeZdZdZdZdZdZ ddeedeededee dee d ee ee d fd ed d eddee ddfdZede eejjffdZdefdZdefdZ ddedede e ffdZddZdefdZdS)HTTPServerRequesta7 A single HTTP request. All attributes are type `str` unless otherwise noted. .. attribute:: method HTTP request method, e.g. "GET" or "POST" .. attribute:: uri The requested uri. .. attribute:: path The path portion of `uri` .. attribute:: query The query portion of `uri` .. attribute:: version HTTP version specified in request, e.g. "HTTP/1.1" .. attribute:: headers `.HTTPHeaders` dictionary-like object for request headers. Acts like a case-insensitive dictionary with additional methods for repeated headers. .. attribute:: body Request body, if present, as a byte string. .. attribute:: remote_ip Client's IP address as a string. If ``HTTPServer.xheaders`` is set, will pass along the real IP address provided by a load balancer in the ``X-Real-Ip`` or ``X-Forwarded-For`` header. .. versionchanged:: 3.1 The list format of ``X-Forwarded-For`` is now supported. .. attribute:: protocol The protocol used, either "http" or "https". If ``HTTPServer.xheaders`` is set, will pass along the protocol used by a load balancer if reported via an ``X-Scheme`` header. .. attribute:: host The requested hostname, usually taken from the ``Host`` header. .. attribute:: arguments GET/POST arguments are available in the arguments property, which maps arguments names to lists of values (to support multiple values for individual names). Names are of type `str`, while arguments are byte strings. Note that this is different from `.RequestHandler.get_argument`, which returns argument values as unicode strings. .. attribute:: query_arguments Same format as ``arguments``, but contains only arguments extracted from the query string. .. versionadded:: 3.2 .. attribute:: body_arguments Same format as ``arguments``, but contains only arguments extracted from the request body. .. versionadded:: 3.2 .. attribute:: files File uploads are available in the files property, which maps file names to lists of `.HTTPFile`. .. attribute:: connection An HTTP request is attached to a single HTTP connection, which can be accessed through the "connection" attribute. Since connections are typically kept open in HTTP/1.1, multiple requests can be handled sequentially on a single connection. .. versionchanged:: 4.0 Moved from ``tornado.httpserver.HTTPRequest``. NHTTP/1.0r6uriversionrbodyfilesHTTPFile connectionHTTPConnection start_lineRequestStartLineserver_connectionrBc ||\}}}||_||_||_|p t|_|pd|_t |dd} t | dd|_t | dd|_ |jd|_ n-#t$r |dkrd|_ ntd YnwxYwtj |j s5ttj jtd |j zd |j vrtd |j zt!|j d |_|pi|_||_| |_t-j|_d|_|#|d\|_} |_t9|jd|_t=j|j|_ i|_!dS)Nr?context remote_ipprotocolhttpHostrz 127.0.0.1zMissing Host headerzInvalid Host header: %rrlz%Multiple host headers not allowed: %rr?Tkeep_blank_values)"r6rrrNrrgetattrrrr7KeyErrorrnrrmprintr,split_host_and_portlower host_namerrrtime _start_time _finish_time partitionpathqueryr argumentsrdeepcopyquery_argumentsbody_arguments) rSr6rrrrrrrrrseps r@rTzHTTPServerRequest.__init__s  !#- FC  /+-- KC *i66 +t<<V<<  < V,DII < < <*$$' $%:;;;  < z##DI.. H %*$ % % % !:TY!FGG G $)  "!!H49!TUU U,TY__->->??B[b $!29;;  ?),s);); &DIsDJ' dKKK#}T^<< s:B 'B76B7cJt|dstj|_d|jvra t |jd}|D] \}} ||j|<#t$rYwxYwn#t$rYnwxYw|jS)z0A dictionary of ``http.cookies.Morsel`` objects._cookiesCookie) hasattrrcookies SimpleCookierr parse_cookierx Exception)rSparsedrerfs r@rzHTTPServerRequest.cookiesstZ(( ! ))++ M4<'' !)$,x*@AAF!' !!1!/0DM!,,(!!!!D !!!D}s#B2 A== B  B  BBc6|jdz|jz|jzS)z+Reconstructs the full URL for this request.z://)rr7rrs r@full_urlzHTTPServerRequest.full_url1s}u$ty048;;r?cd|jtj|jz S|j|jz S)z?Returns the amount of time it took for this request to execute.)rrrrs r@ request_timezHTTPServerRequest.request_time5s0   $9;;!11 1$t'77 7r?F binary_formc |jdS|jjj|S#t$rYdSwxYw)a>Returns the client's SSL certificate, if any. To use client certificates, the HTTPServer's `ssl.SSLContext.verify_mode` field must be set, e.g.:: ssl_ctx = ssl.create_default_context(ssl.Purpose.CLIENT_AUTH) ssl_ctx.load_cert_chain("foo.crt", "foo.key") ssl_ctx.load_verify_locations("cacerts.pem") ssl_ctx.verify_mode = ssl.CERT_REQUIRED server = HTTPServer(app, ssl_options=ssl_ctx) By default, the return value is a dictionary (or None, if no client certificate is present). If ``binary_form`` is true, a DER-encoded form of the certificate is returned instead. See SSLSocket.getpeercert() in the standard library for more details. http://docs.python.org/library/ssl.html#sslsocket-objects N)r)rstreamsocket getpeercertr)rSrs r@get_ssl_certificatez%HTTPServerRequest.get_ssl_certificate<s`* &t?)0<<'=    44 s0$0 >>c t|jdd|j|j|j|j|jD]3\}}|j|g |4dS)N Content-Typer) parse_body_argumentsrrtrrrrxr setdefaultextend)rSrerfs r@ _parse_bodyzHTTPServerRequest._parse_body[s L  ^R 0 0 I   J L    '--// 7 7DAq N % %a , , 3 3A 6 6 6 6 7 7r?cnd}dfd|D}jjd|dS)N)rr7r6rrrz, c:g|]}|dt|S)=)r)rGnrSs r@rIz.HTTPServerRequest.__repr__..is1EEE!Q55q!1!155EEEr?r"r )rJ __class__r#)rSattrsrWs` r@__repr__zHTTPServerRequest.__repr__gsJMyyEEEEuEEEFF.)33D3333r?) NNrNNNNNN)FrBN)r#r$r%r&rr _body_futurerrrNbytesrrobjectrTpropertyrrMorselrfloatrrrrrrr>r?r@rrssZZx D EL!%!!)- $7;1537.2B!B! B!c]B! B! +& B! uo B!S$z"2234B!-.B!/0B!$F+B! B!B!B!B!Hc4<#667X,<#<<<<8e8888#( tT5 !> 7 7 7 74#444444r?rceZdZdZdS)rnzqException class for malformed HTTP requests or responses from remote sources. .. versionadded:: 4.0 Nr#r$r%r&r>r?r@rnrnms  Dr?rnceZdZdZdS)HTTPOutputErrorzJException class for errors in HTTP output. .. versionadded:: 4.0 Nrr>r?r@rrws  Dr?rc6eZdZdZdeddddfdZdeddfd ZdS) HTTPServerConnectionDelegatez_Implement this interface to handle requests from `.HTTPServer`. .. versionadded:: 4.0 server_conn request_connrrBHTTPMessageDelegatect)ajThis method is called by the server when a new request has started. :arg server_conn: is an opaque object representing the long-lived (e.g. tcp-level) connection. :arg request_conn: is a `.HTTPConnection` object for a single request/response exchange. This method should return a `.HTTPMessageDelegate`. NotImplementedError)rSrrs r@ start_requestz*HTTPServerConnectionDelegate.start_requests"###r?NcdS)zThis method is called when a connection has been closed. :arg server_conn: is a server connection that has previously been passed to ``start_request``. Nr>)rSrs r@on_closez%HTTPServerConnectionDelegate.on_close r?)r#r$r%r&rrrr>r?r@rrsl $! $1A $  $ $ $ $ F t      r?rceZdZdZdeddedeedfdZde deedfd Z d d Z d d Z dS) rz_Implement this interface to handle an HTTP request or response. .. versionadded:: 4.0 rrResponseStartLinerrBNcdS)aCalled when the HTTP headers have been received and parsed. :arg start_line: a `.RequestStartLine` or `.ResponseStartLine` depending on whether this is a client or server message. :arg headers: a `.HTTPHeaders` instance. Some `.HTTPConnection` methods can only be called during ``headers_received``. May return a `.Future`; if it does the body will not be read until it is done. Nr>)rSrrs r@headers_receivedz$HTTPMessageDelegate.headers_receiveds " r?chunkcdS)ziCalled when a chunk of data has been received. May return a `.Future` for flow control. Nr>rSr s r@ data_receivedz!HTTPMessageDelegate.data_receiveds r?cdS)z6Called after the last chunk of data has been received.Nr>rs r@finishzHTTPMessageDelegate.finishrUr?cdS)zCalled if the connection is closed without finishing the request. If ``headers_received`` is called, either ``finish`` or ``on_connection_close`` will be called, but not both. Nr>rs r@on_connection_closez'HTTPMessageDelegate.on_connection_closerr?r) r#r$r%r&rrNrrr rrrrr>r?r@rrs  AB   )D/ "     & 5 Xio-F              r?rc ^eZdZdZ d deddedeeddfd Zdeddfd Z d d Z dS)rzYApplications use this interface to write their responses. .. versionadded:: 4.0 Nrr rr rBz Future[None]ct)aWrite an HTTP header block. :arg start_line: a `.RequestStartLine` or `.ResponseStartLine`. :arg headers: a `.HTTPHeaders` instance. :arg chunk: the first (optional) chunk of data. This is an optimization so that small responses can be written in the same call as their headers. The ``version`` field of ``start_line`` is ignored. Returns a future for flow control. .. versionchanged:: 6.0 The ``callback`` argument was removed. r)rSrrr s r@ write_headerszHTTPConnection.write_headerss,"###r?ct)zWrites a chunk of body data. Returns a future for flow control. .. versionchanged:: 6.0 The ``callback`` argument was removed. rrs r@writezHTTPConnection.writes"###r?ct)z3Indicates that the last body data has been written.rrs r@rzHTTPConnection.finishs!###r?rQr) r#r$r%r&rrNrrrrrr>r?r@rrs"& $$AB$$ $  $$$$0 $5 $^ $ $ $ $$$$$$$r?rurlrW.c d||St|}t|tr>t|jd}||nt|tst|tr,t|jd}||n1d t|}t|t|}t|d|d|d|d||d f}|S) aConcatenate url and arguments regardless of whether url has existing query parameters. ``args`` may be either a dictionary or a list of key-value pairs (the latter allows for multiple values with the same key. >>> url_concat("http://example.com/foo", dict(c="d")) 'http://example.com/foo?c=d' >>> url_concat("http://example.com/foo?a=b", dict(c="d")) 'http://example.com/foo?a=b&c=d' >>> url_concat("http://example.com/foo?a=b", [("c", "d"), ("c", "d2")]) 'http://example.com/foo?a=b&c=d&c=d2' NTrz7'args' parameter should be dict, list or tuple. Not {0}rr\)rradictr rrrxlisttupleformattype TypeErrorrr)rrW parsed_url parsed_queryerr final_querys r@ url_concatr*s(& | #J$  !1TJJJ DJJLL)))) D$  :dE#:#: !1TJJJ D!!!!GNN JJ  nnL))K  qM qM qM qM  qM    C Jr?c2eZdZUdZeed<eed<eed<dS)rzRepresents a file uploaded via a form. For backwards compatibility, its instance attributes are also accessible as dictionary keys. * ``filename`` * ``body`` * ``content_type`` filenamer content_typeN)r#r$r%r&r__annotations__rr>r?r@rr(s<MMM KKKr?r range_headercZ|d\}}}||}}|dkrdS|d\}}} t|}t|}n#t$rYdSwxYw|| |dkr| }d}n|dz }||fS)agParses a Range header. Returns either ``None`` or tuple ``(start, end)``. Note that while the HTTP headers use inclusive byte positions, this method returns indexes suitable for use in slices. >>> start, end = _parse_request_range("bytes=1-2") >>> start, end (1, 3) >>> [0, 1, 2, 3, 4][start:end] [1, 2] >>> _parse_request_range("bytes=6-") (6, None) >>> _parse_request_range("bytes=-6") (-6, None) >>> _parse_request_range("bytes=-0") (None, 0) >>> _parse_request_range("bytes=") (None, None) >>> _parse_request_range("foo=42") >>> _parse_request_range("bytes=1-2,6-10") Note: only supports one range (ex, ``bytes=1-2,6-10`` is not allowed). See [0] for the details of the range header. [0]: http://greenbytes.de/tech/webdav/draft-ietf-httpbis-p5-range-latest.html#byte.ranges rrNrDrr\)rr _int_or_noner)r/unit_ristart_bend_brends r@_parse_request_ranger78s>"++C00ND!U**,, %D wt,,GQW%%5!! tt  =axx 1HC 3<s$B BBrr6totalc.|pd}|p|dz }d|d|d|S)zReturns a suitable Content-Range header: >>> print(_get_content_range(None, 1, 4)) bytes 0-0/4 >>> print(_get_content_range(1, 3, 4)) bytes 1-2/4 >>> print(_get_content_range(None, None, 4)) bytes 0-3/4 rr\zbytes rD/r>)rr6r8s r@_get_content_ranger;ks9 JQE <%1 C )E ) )C ) )% ) ))r?valcX|}|dkrdSt|S)Nr)rr)r<s r@r1r1zs( ))++C byyt s88Or?r-rrrrc|dr|rd|vrtd|dz t|d}n%#t$r}td|z|d}~wwxYw|D]0\}}|r)||g|1dS|dr|rd|vrtd|dz |d } | D]W} |  d \} } } | d kr$| r"tt| |||dSXtd #t$r}td |z|d}~wwxYwdS)aFParses a form request body. Supports ``application/x-www-form-urlencoded`` and ``multipart/form-data``. The ``content_type`` parameter should be a string and ``body`` should be a byte string. The ``arguments`` and ``files`` parameters are dictionaries that will be updated with the parsed contents. z!application/x-www-form-urlencodedzContent-Encodingz Unsupported Content-Encoding: %sTrz&Invalid x-www-form-urlencoded body: %sNzmultipart/form-data;rboundaryzmultipart boundary not foundzInvalid multipart/form-data: %s) startswithrnr rrxrrrKrrparse_multipart_form_datar )r-rrrr uri_argumentserAryfieldsfieldrerrfs r@rrsBCCO  )W44 2W=O5PP  V*44HHHMM V V V !IA!MNNTU U V)//11 > >LD& >$$T2..55f=== > >  !6 7 7O  )W44 2W=O5PP  O!'',,F E E!KKMM33C88 3 ??q?-d1ggtYNNNEE$%CDDD O O O !BQ!FGGQ N OOOs6A A)A$$A)'A,E%E%% F/FFr@datac*|dr|dr |dd}|d|zdz}|dkrtd|d|d|zdz}|D]}|s|d}|dkrtd t |d|d d }| d d} t| \} } | dks|dstd||dzd} | dstd| d} | drW| dd}| | g t| d| |^| | g | dS)a]Parses a ``multipart/form-data`` body. The ``boundary`` and ``data`` parameters are both byte strings. The dictionaries given in the arguments and files parameters will be updated with the contents of the body. .. versionchanged:: 5.1 Now recognizes non-ASCII filenames in RFC 2231/5987 (``filename*=``) format. "r\r}s--z4Invalid multipart/form-data: no final boundary foundNs s z#multipart/form-data missing headerszutf-8FrgzContent-Dispositionrz form-datazInvalid multipart/form-datarAz multipart/form-data missing namer,rzapplication/unknown)r,rr-)rAendswithrfindrnrKrrNrdecodert _parse_headerrrqr)r@rGrrfinal_boundary_indexpartsparteohr disp_header disposition disp_paramsrirActypes r@rBrBsD,4  "X%6%6t%<%<"AbD>::eh&6&>??r!!STTT &&& ' - -eh.>.H I IE99  ii $$ "99 !FGG G##D#J$5$5g$>$>QV#WWkk"7<< #0#=#= [ + % %T]]7-C-C % !>?? ?S1Wr\"v&& E !CDD D6" ??: & & 9KK0EFFE   T2 & & - -(45u      r * * 1 1% 8 8 8 8/99r?tsct|ttfr|}nt|ttjfrt j|}nSt|tjr't j| }ntd|ztj |dS)aFormats a timestamp in the format used by HTTP. The argument may be a numeric timestamp as returned by `time.time`, a time tuple as returned by `time.gmtime`, or a `datetime.datetime` object. Naive `datetime.datetime` objects are assumed to represent UTC; aware objects are converted to UTC before formatting. >>> format_timestamp(1359312200) 'Sun, 27 Jan 2013 18:43:20 GMT' zunknown timestamp type: %rT)usegmt)rarrr"r struct_timecalendartimegmdatetime utctimetupler%emailutils formatdate)rXtime_nums r@format_timestamprds"sEl##; B 01 2 2;?2&& B) * *;?2??#4#4554r9::: ; ! !(4 ! 8 88r?c.eZdZUeed<eed<eed<dS)rr6rrN)r#r$r%rr.r>r?r@rrs+ KKK III LLLLLr?rrzc\tj|}|stdt |d|d|d}|jdstd|jz|S)zReturns a (method, path, version) tuple for an HTTP 1.x request line. The response is a `typing.NamedTuple`. >>> parse_request_start_line("GET /foo HTTP/1.1") RequestStartLine(method='GET', path='/foo', version='HTTP/1.1') zMalformed HTTP request liner\rrHTTP/1Unexpected HTTP version %r)rr;rmrnrgrouprrArzmatchrs r@parse_request_start_linerms   ( ( . .E <:;;;QQQHHA 9   ) )G9AIEFFF Hr?c.eZdZUeed<eed<eed<dS)r rcodereasonN)r#r$r%rr.rr>r?r@r r s+ LLL III KKKKKr?r cvtj|}|stdt |dt |d|d}|jdstd|jz|S)zReturns a (version, code, reason) tuple for an HTTP 1.x response line. The response is a `typing.NamedTuple`. >>> parse_response_start_line("HTTP/1.1 200 OK") ResponseStartLine(version='HTTP/1.1', code=200, reason='OK') z!Error parsing response start liner\rrrgrh) rr=rmrnr rirrrArjs r@parse_response_start_linerrs   ' ' - -E B@AAA%++a..#ekk!nn*=*=u{{1~~NNA 9   ) )G9AIEFFF Hr?sc#K|dddkr|dd}|d}|dkr|dd||dd|z dzrQ|d|dz}|dkr2|dd||dd|z dzQ|dkrt|}|d|}|V||d}|dddkdSdS)Nr\r?r"z\"r)rcountr`r)rsr6fs r@ _parseparamrx9s BQB%3,, abbEffSkkAgg17733//!''%C2H2HHAMg&&cAg&&CAgg17733//!''%C2H2HHAMg 77a&&C dsdGggii cddG BQB%3,,,,,,r?ctd|z}t|}dg}|D]}|d}|dkrq|d|}||dzd}||t |ftj |}| di} |D]^\}} tj | }t|dkr"|ddkr|d dkr |dd }|| |<_|| fS) aYParse a Content-type like header. Return the main content-type and a dictionary of options. >>> d = "form-data; foo=\"b\\\\a\\\"r\"; file*=utf-8''T%C3%A4st" >>> ct, d = _parse_header(d) >>> ct 'form-data' >>> d['file'] == r'T\u00e4st'.encode('ascii').decode('unicode_escape') True >>> d['foo'] 'b\\a"r' r?)DummyrirrNr\rrur}) rxnextrrrrqr r`ra decode_paramspopcollapse_rfc2231_valuer`) rzrQkeyparamspirAridecoded_paramspdict decoded_values r@rOrOFsO d # #E u++C !F 55 FF3KK 66RaR5;;==&&((Da!eggJ$$&&E MM4E!2!23 4 4 4[..v66Nq E-m 22=AA u::??uQx3593C3C!B$KEd :r?rrc|s|S|g}t|D]7\}}|||||d|8d|S)zInverse of _parse_header. >>> _encode_header('permessage-deflate', ... {'client_max_window_bits': 15, 'client_no_context_takeover': None}) 'permessage-deflate; client_max_window_bits=15; client_no_context_takeover' Nrz; )sortedrxrqrJ)rroutrerfs r@_encode_headerris  %Cu{{}}%%##1 9 JJqMMMM JJ!zzazz " " " " 99S>>r?usernamepasswordct|trtjd|}t|trtjd|}t |dzt |zS)zEncodes a username/password pair in the format used by HTTP auth. The return value is a byte string in the form ``username:password``. .. versionadded:: 5.1 NFC:)rar unicodedata normalizer )rrs r@encode_username_passwordr}sh(L)):(99(L)):(99 >>D 4>> 11r?c2ddl}|S)Nr)doctest DocTestSuite)rs r@doctestsrsNNN    ! !!r?z ^(.+):(\d+)$netlocct|}|r8|d}t|d}n|}d}||fS)zReturns ``(host, port)`` tuple from ``netloc``. Returned ``port`` will be ``None`` if not present. .. versionadded:: 4.1 r\rN) _netloc_rerkrir)rrkr7ports r@rrs[   V $ $E {{1~~5;;q>>"" $<r?qsc#TK|D]\}}|D]}||fV dS)zgGenerator converting a result of ``parse_qs`` back to name-value pairs. .. versionadded:: 5.0 N)rx)rrevsrfs r@ qs_to_qslrsP 2  Aa&LLLL r?z\\(?:([0-3][0-7][0-7])|(.))rch|dr#tt|ddS|dS)Nr\r)chrr)rs r@_unquote_replacers1t3qtQ<<   t r?c|t|dkr|S|ddks |ddkr|S|dd}tt|S)zHandle double quotes and escaping in cookie values. This method is copied verbatim from the Python 3.13 standard library (http.cookies._unquote) so we don't have to depend on non-public interfaces. Nrrrur}r\)r` _unquote_subr)rss r@_unquote_cookiers\ yCFFQJJts{{aesll !B$A (! , ,,r?cookieci}|dD]b}d|vr|dd\}}nd|}}||}}|s|rt|||<c|S)a[Parse a ``Cookie`` HTTP header into a dict of name/value pairs. This function attempts to mimic browser cookie parsing behavior; it specifically does not follow any of the cookie-related RFCs (because browsers don't either). The algorithm used is identical to that used by Django version 1.9.10. .. versionadded:: 4.4.2 r?rr\r)rKrr)r cookiedictr rr<s r@rrsJc"" 3 3 %<<{{3**HC5C99;; S  3# 3-c22JsO r?rQ)br&r\collections.abc collectionsrr^ email.utilsr` functoolsr http.clientr http.cookiesrr'sslrrr urllib.parserrrr tornado.escaper r r r tornado.utilrrrrrrrrrrrrrr TYPE_CHECKINGrasynciorunittestabcMutableMappingrStrMutableMappingrr(rorrLrNrrrnrrrrr*rrr7r;r1rrrBrr"r[rd NamedTuplerrmr rrrxrOrrrrrrsubrMatchrrrr>r?r@rs|   !!!!!!  CCCCCCCCCCCCGGGGGGGGGGGG11111111                              7OOO$6sCx@#6(RZ(KLL55555555p 4?C?C????`````#```Fw4w4w4w4w4w4w4w4t     Y        i           :+ + + + + + + + \+$+$+$+$+$+$+$+$\, ,  d38nd5c?3U5c?C;O5PP ,  ,,,,^     z    00 eHSM8C=0120000f *hsm *(3- * *PS * * * *chsm&* +O+O+O +OCe$%+O T(^# $ +O k " +O  +O+O+O+O\3939 39Ce$%39 T(^# $ 39  39393939l9 c5%!183DDE999990v(  3 +;    ,)  C ,=    4 3 9S$_5      c4S>&9 :    FDcNs( 2CJ 2+0e+< 2  2 2 2 2 """RZ ( ( c8C=.@(A"$sDL()huS&[7I.Jrz899= S-s-s----6c3hr?