"S#S$\5r?S%\1S\'\ \'\@\'\@44S&jrAS'\'\@S(\'\@S)\@S\14S*jrBS+\1S\'\@4S,jrCSVS-\1S.\DS/\%\1\"\D4S0\%\1\"\?4S1\'\5SS4 S2jjrES3\DS4\DS/\%\1\"\D4S0\%\1\"\?4SS4 S5jrFS6\&\@\G\H\R\R 4S\14S7jrJ\R"S8/S9Q5rL\R"S:5rNS;\1S\L4S<jrO\R"S=/S>Q5rP\R"S?5rQS;\1S\P4S@jrRSA\1S\)\1SS44SBjrSS;\1S\ \1\%\1\1444SCjrTSD\1SE\%\1\14S\14SFjrUSG\&\1\D4SH\&\1\D4S\D4SIjrVSJrW\R"SK5rXSL\1S\ \1\'\@44SMjrYSN\%\1\"\*4S\!\ \1\*44SOjrZ\R"SP5Rr\SQ\RS\14SRjr^SA\1S\14SSjr_ST\1S\%\1\144SUjr`g)WzHTTP 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) ObjectDict unicode_type) TupleIterableListMappingIteratorDictUnionOptional Awaitable GeneratorAnyStr)Deque)Futurez inamereturncSRURS5Vs/sHoR5PM sn5$s snf)z]Map a header name to Http-Header-Case. >>> _normalize_header("coNtent-TYPE") 'Content-Type' -)joinsplit capitalize)rws 2/usr/lib/python3/dist-packages/tornado/httputil.py_normalize_headerr%Ds1 88TZZ_=_\\^_= >>=s?cB\rSrSrSr\R S\\\ \4SS4Sj5r \R S\\\4SS4Sj5r \R S\ \\4SS4S j5r \R S \SS4S j5r S\RS \SS4S jr S \S\SS4Sjr S \S\ \4SjrS\\ \\44SjrS\SS4Sjr\S\SS4Sj5rS \S\SS4SjrS \S\4SjrS \S\4SjrS \SS4SjrS\4SjrS\\R4SjrSSjr\rS\4Sjr \ r!Sr"g) HTTPHeadersNaA 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__argrNcgNselfr)s r$__init__HTTPHeaders.__init__k cgr+r,r-s r$r/r0or1r2argscgr+r,)r.r4s r$r/r0sr1r2kwargsc gr+r,)r.r6s r$r/r0wr1r2c0Ul0UlSUl[U5S:XaU[U5S:XaF[ US[ 5(a.USR 5Hup4URX45 M gUR"U0UD6 g)Nr) _as_list_combined_cache _last_keylen isinstancer'get_alladdupdate)r.r4r6kvs r$r/r0{su/1 /1 t9>c&kQ.:d1g{3S3SQ)* KK ( (r2rvaluec[U5nX0lX0;a;URRUS5 URUR U5 gX U'g)z#Adds a new value for the given key.N)r%r<r;popr:appendr.rrD norm_names r$r@HTTPHeaders.addsK%d+ "    $ $Y 5 MM) $ + +E 2#Or2cP[U5nURRU/5$)z2Returns all values for the given header as a list.)r%r:getr.rrIs r$get_listHTTPHeaders.get_lists#%d+ }}  B//r2c#n# URR5HupUHnX4v M M g7f)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)r.rvaluesrDs r$r?HTTPHeaders.get_alls2 !MM//1LDm# 2s35linecUSR5(a{URc [S5eSUR[5-nUR URS==U- ss'UR RURS5 gURSS5up4URX4R[55 g![a [S5ef=f) zUpdates the dictionary with a single header line. >>> h = HTTPHeaders() >>> h.parse_line("Content-Type: text/html") >>> h.get('content-type') 'text/html' rNz.first header line cannot start with whitespace :r9zno colon in header line) isspacer<HTTPInputErrorlstripHTTP_WHITESPACEr:r;rFr! ValueErrorr@strip)r.rTnew_partrrDs r$ parse_lineHTTPHeaders.parse_lines 7??  ~~%$%UVVT[[99H MM$.. )" - 9 -  $ $T^^T : @"jja0  HHT;;7 8 @$%>?? @s CC$headerscU"5nURS5H8nURS5(aUSSnU(dM'URU5 M: U$)aLReturns 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`.   NrW)r!endswithr`)clsrbhrTs r$parseHTTPHeaders.parsesR EMM$'D}}T""CRyt T" ( r2cV[U5nX RU'U/URU'gr+r%r;r:rHs r$ __setitem__HTTPHeaders.__setitem__s*%d+ */Y'$)7 i r2c`[U[5(dg[U5nX R;$)NF)r>strr%r:rMs r$ __contains__HTTPHeaders.__contains__s+$$$%d+ MM))r2c[U5nX R;a+SRURU5URU'URU$)N,)r%r;r r:)r.rheaders r$ __getitem__HTTPHeaders.__getitem__sK"4( -- -+.88DMM&4I+JD  (##F++r2cN[U5nURU URU gr+rlrMs r$ __delitem__HTTPHeaders.__delitem__s&%d+   + MM) $r2c,[UR5$r+)r=r:r.s r$__len__HTTPHeaders.__len__s4==!!r2c,[UR5$r+)iterr:r|s r$__iter__HTTPHeaders.__iter__sDMM""r2c[U5$r+)r'r|s r$copyHTTPHeaders.copys 4  r2c/nUR5Hup#URU<SU<S35 M SRU5$)Nz: rd)r?rGr )r.linesrrDs r$__str__HTTPHeaders.__str__s8<<>KD LLtU3 4*wwu~r2)r:r;r<)rr')#__name__ __module__ __qualname____firstlineno____doc__typingoverloadrrprr/rAnyr@rNrr?r` classmethodrirmobjectboolrqrvryintr}rrr__copy__r __unicode____static_attributes__r,r2r$r'r'Ns8 __ gc49n5 $   __ gc3h/ D   __ eCHo $   __    )fjj)C)D)($$C$D$0S0T#Y0 $%S/2$9s9t9,CM2++C+D+ **D*,,, %%% ""#(6::.#!H Kr2r'cZ\rSrSrSrSrSrSrSS\\ S\\ S\ S\\ S\\ S \\ S \\ \ \ S 4S \S S\SS\\SS4Sjjr\S\ \ \R$R&44Sj5rS\ 4SjrS\4SjrSS\S\S\ \ 44SjjrSSjrS\ 4SjrSrg)HTTPServerRequestia[ 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``. NmethoduriversionrbbodyhostfilesHTTPFile connectionHTTPConnection start_lineRequestStartLineserver_connectionrc U bU upnXlX lX0lU=(d [5UlU=(d SUl[ USS5n [ U SS5Ul[ U SS5UlU=(d$ URRS5=(d SUl [URR55SUl U=(d 0UlXlXl["R""5UlSUlUbUR)S 5uUlol[/UR,S S 9Ul[2R4"UR05Ul0Ulg) Nr2context remote_ipprotocolhttpHostz 127.0.0.1r?Tkeep_blank_values)rrrr'rbrgetattrrrrLrsplit_host_and_portlower host_namerrrtime _start_time _finish_time partitionpathqueryr argumentsrdeepcopyquery_argumentsbody_arguments) r.rrrrbrrrrrrrseps r$r/HTTPServerRequest.__init__ks  !#- F  /+- KC *i6 +t<V< CDLL,,V4C  ,TYY__->?B[b $!299;  ?),s); &DIsJ' dK#}}T^^< r2c[US5(d[RR5UlSUR ;aM[ UR S5nUR5Hup#X0RU'M UR$UR$![a M=f=f![a UR$f=f)z0A dictionary of ``http.cookies.Morsel`` objects._cookiesCookie) hasattrrcookies SimpleCookierrb parse_cookierQ Exception)r.parsedrBrCs r$rHTTPServerRequest.cookiesstZ(( ))+ M4<<' !)$,,x*@AF!' !/0MM!,!/}}t}} )!! ! !}}s$B/4B B,+B,/ CCcTURS-UR-UR-$)z+Reconstructs the full URL for this request.z://)rrrr|s r$full_urlHTTPServerRequest.full_urls#}}u$tyy0488;;r2cURc"[R"5UR- $URUR- $)z?Returns the amount of time it took for this request to execute.)rrrr|s r$ request_timeHTTPServerRequest.request_times<    $99;!1!11 1$$t'7'77 7r2 binary_formcURcgURRRRUS9$![a gf=f)aReturns 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)r.rs r$get_ssl_certificate%HTTPServerRequest.get_ssl_certificatesS* &??))00<<'=   s =,= A  A cB[URRSS5URURUR UR5 URR 5H0upURRU/5RU5 M2 g)N Content-Typer) parse_body_argumentsrbrLrrrrQr setdefaultextend)r.rBrCs r$ _parse_bodyHTTPServerRequest._parse_bodysx LL  ^R 0 II    JJ LL  ''--/DA NN % %a , 3 3A 60r2c SnSRUVs/sHo"<S[X5<3PM sn5nURR<SU<S3$s snf)N)rrrrrrz, =())r r __class__r)r.attrsnr4s r$__repr__HTTPServerRequest.__repr__sIMyy5I5aQ(895IJ>>22D99JsA)rrrrrrrrrbrrrrrrrrrrr) NNzHTTP/1.0NNNNNNN)FrN)rrrrrrr _body_futurerrpr'bytesrrrr/propertyrrMorselrfloatrrrrrrrr,r2r$rrsfZx D EL!%!!)- $"7;1537.2&! &!c]&! &! +& &! uo &!sm&!S$z"2234&!-.&!/0&!$F+&! &!Pc4<<#6#667,<#<8e8#( tT5 !> 7:#:r2rc\rSrSrSrSrg)rZizeException class for malformed HTTP requests or responses from remote sources. .. versionadded:: 4.0 r,Nrrrrrrr,r2r$rZrZs   r2rZc\rSrSrSrSrg)HTTPOutputErrorizBException class for errors in HTTP output. .. versionadded:: 4.0 r,Nrr,r2r$rrs   r2rc@\rSrSrSrS\SSSS4SjrS\SS 4S jrS rg ) HTTPServerConnectionDelegateizWImplement this interface to handle requests from `.HTTPServer`. .. versionadded:: 4.0 server_conn request_connrrHTTPMessageDelegatec[5e)a:This 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)r.rrs r$ start_request*HTTPServerConnectionDelegate.start_requests "##r2Ncg)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,)r.rs r$on_close%HTTPServerConnectionDelegate.on_close  r2r,) rrrrrrrrrr,r2r$rrs7 $! $1A $  $ F t r2rcr\rSrSrSrS\SS\S\\S4Sjr S \ S\\S4S jr SS jr SS jr S rg)rizWImplement this interface to handle an HTTP request or response. .. versionadded:: 4.0 rrResponseStartLinerbrNcg)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,)r.rrbs r$headers_received$HTTPMessageDelegate.headers_receiveds" r2chunkcg)zYCalled when a chunk of data has been received. May return a `.Future` for flow control. Nr,r.rs r$ data_received!HTTPMessageDelegate.data_received0s r2cg)z6Called after the last chunk of data has been received.Nr,r|s r$finishHTTPMessageDelegate.finish7r1r2cg)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,r|s r$on_connection_close'HTTPMessageDelegate.on_connection_close;rr2r,r)rrrrrrr'rrrrr r rrr,r2r$rrs]  AB   )D/ "  & 5 Xio-F   r2rc `\rSrSrSrSS\SS\S\\SS 4S jjr S\SS 4S jr SS jr S r g)riDzQApplications use this interface to write their responses. .. versionadded:: 4.0 Nrrrbrrz Future[None]c[5e)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)r.rrbrs r$ write_headersHTTPConnection.write_headersJs ,"##r2c[5e)zWrites a chunk of body data. Returns a future for flow control. .. versionchanged:: 6.0 The ``callback`` argument was removed. rrs r$writeHTTPConnection.writebs "##r2c[5e)z3Indicates that the last body data has been written.rr|s r$r HTTPConnection.finishms !##r2r,r+r) rrrrrrr'rrrrr rr,r2r$rrDsY"& $AB$$ $  $0 $5 $^ $$r2rurlr4.c UcU$[U5n[U[5(a4[URSS9nUR UR 55 Ou[U[5(d[U[5(a&[URSS9nUR U5 O%SR[U55n[U5e[U5n[USUSUSUSUUS45nU$) 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' Trz7'args' parameter should be dict, list or tuple. Not {0}rr9)rr>dictr rrrQlisttupleformattype TypeErrorrr)rr4 parsed_url parsed_queryerr final_querys r$ url_concatr)rs& | #J$ !1!1TJ DJJL) D$  :dE#:#: !1!1TJ D!GNN J nL)K  qM qM qM qM  qM   C Jr2c8\rSrSr%Sr\\S'\\S'\\S'Srg)rizRepresents a file uploaded via a form. For backwards compatibility, its instance attributes are also accessible as dictionary keys. * ``filename`` * ``body`` * ``content_type`` filenamer content_typer,N) rrrrrrp__annotations__rrr,r2r$rrsM Kr2r range_headerc$URS5upnUR5UR5p1US:wagURS5upBn[U5n[U5nUbUcUS:waU*nSnXg4$US- nXg4$![a gf=f)aParses 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 rrNrrr9)rr^ _int_or_noner])r.unit_rDstart_bend_bstartends r$_parse_request_ranger7s>"++C0NDU**, % w,GW%5!  =ax < 1HC < sB BBr5r6totalcPU=(d SnU=(d US- nSU<SU<SU<3$)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 rr9zbytes r/r,)r5r6r8s r$_get_content_ranger;s( JQE <%1 C$c5 11r2valcFUR5nUS:Xag[U5$)Nr)r^r)r<s r$r0r0s ))+C by s8Or2r,rrrrbcURS5(amU(aSU;a[SUS-5e[USS9nUR 5H/upxU(dMUR U/5R U5 M1 gURS5(aU(aSU;a[SUS-5eURS 5n U HLn U R5RS 5upn U S :XdM-U (dM6[[U 5XU5 g [S 5eg![an[SU-5UeSnAff=f![an[S U-5UeSnAff=f)a.Parses 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) startswithrZr rrQrrr!r^rparse_multipart_form_datar )r,rrrrb uri_argumentserrRfieldsfieldrBrrCs r$rrsxBCC )W4 2W=O5PP  V*44HM*//1LDv$$T2.55f=2  !6 7 7 )W4 2W=O5PP  O!'',F!KKM33C8  ?qq-d1gtN  %%CDD 8  V !IA!MNTU U V& O !BQ!FGQ N OsA D(9::eh&6&>?r!STT && ' - -eh.>.H IE ii $ "9 !FG G##D#J$5$5g$>?kk"7< #0#= + %T]]7-C-C !>? ?1Wr"v&& !CD D6" ??: & &KK0EFE   T2 & - -(45   r * 1 1% 8/r2tsc[U[[45(aUnO[U[[R 45(a[ R"U5nOR[U[R5(a%[ R"UR55nO[SU-5e[RRUSS9$)ayFormats 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)r>rrr!r struct_timecalendartimegmdatetime utctimetupler$emailutils formatdate)rXtime_nums r$format_timestamprd^s"sEl## B 0 01 2 2??2& B)) * *??2??#454r9:: ;; ! !(4 ! 88r2r)rrrz^HTTP/1\.[0-9]$rTcURS5upn[R U5(d[SU-5e[ XU5$![a [S5ef=f)zReturns a (method, path, version) tuple for an HTTP 1.x request line. The response is a `collections.namedtuple`. >>> parse_request_start_line("GET /foo HTTP/1.1") RequestStartLine(method='GET', path='/foo', version='HTTP/1.1') rVzMalformed HTTP request linez/Malformed HTTP version in HTTP Request-Line: %r)r!r]rZ_http_version_rematchr)rTrrrs r$parse_request_start_linerh~so< $ 3g  ! !' * * = G   F' 22 <:;;>> parse_response_start_line("HTTP/1.1 200 OK") ResponseStartLine(version='HTTP/1.1', code=200, reason='OK') z!Error parsing response start liner9rr)r _http_response_line_rergrZrgroupr)rTrgs r$parse_response_start_linernsY d D " ( ( .E @AA U[[^SQ-@%++a. QQr2sc## SnURSU5U:XaUS- nURSU5nUSpCUS:aNX@RSX25URSX25- - nUS-S:XaOX0RSUS-5p2US:aMNUS:a [U5nXUnUR5v UnURSU5U:XaMgg7f)Nrr?r9"z\"r)rMcountr=r^)ror5r6inddifffs r$ _parseparamrvs E &&e  %  ffS% 1TAg GGC*QWWUC-EE EDax1}FF3a0 Ag 7a&C CLggi &&e  %sBC  ?C  C c4[SU-5n[U5nS/nUHnnURS5nUS:dMUSUR5R 5nXES-SR5nUR U[ U545 Mp [RRU5nURS5 0n UHNupj[RRU 5n[U5S:aUSS:XaUS S:XaUSS nXyU'MP X)4$) a1Parse 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?)DummyrDrrNr9rrqrW) rvnextrMr^rrGr r`ra decode_paramsrFcollapse_rfc2231_valuer=) rTrQkeyparamspirrDdecoded_paramspdict decoded_values r$rOrOs  d #E u+C !F  FF3K 6Ra5;;=&&(D!egJ$$&E MM4E!23 4  [[..v6Nq E- 22=A u:?uQx3593C!BKEd . :r2r|rcU(dU$U/n[UR55H3up4UcURU5 MURU<SU<35 M5 SRU5$)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' rz; )sortedrQrGr )r|routrBrCs r$_encode_headerrs]  %Cu{{}% 9 JJqM JJ!Q' ( & 99S>r2usernamepasswordc[U[5(a[R"SU5n[U[5(a[R"SU5n[ U5S-[ U5-$)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:)r>r unicodedata normalizer )rrs r$encode_username_passwordrsZ(L))((9(L))((9 >D 4> 11r2c*SSKnUR5$)Nr)doctest DocTestSuite)rs r$doctestsrs    !!r2z ^(.+):(\d+)$netlocc[RU5nU(a.URS5n[URS55nX#4$UnSnX#4$)z{Returns ``(host, port)`` tuple from ``netloc``. Returned ``port`` will be ``None`` if not present. .. versionadded:: 4.1 r9rN) _netloc_rergrmr)rrgrports r$rrsT   V $E {{1~5;;q>" < <r2qsc#Z# UR5HupUHnX4v M M g7f)z_Generator converting a result of ``parse_qs`` back to name-value pairs. .. versionadded:: 5.0 N)rQ)rrBvsrCs r$ qs_to_qslr0s* A&Ls)+z\\(?:([0-3][0-7][0-7])|(.))mcPUS(a[[USS55$US$)Nr9r)chrr)rs r$_unquote_replacer=s't3qtQ<  t r2c|Ub[U5S:aU$USS:wd USS:waU$USSn[[U5$)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. rrrqrWr9)r= _unquote_subr)ros r$_unquote_cookierDsO yCFQJts{aesl !BA (! ,,r2cookiec60nUR[S55Hxn[S5U;aUR[S5S5up4O [S5UpCUR5UR5pCU(d U(dMk[U5X'Mz U$)aCParse 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?rr9r)r!rpr^r)r cookiedictrr|r<s r$rr_sJc#h' s8u {{3s8Q/HC2w99; S ##-c2JO( r2r+)arr\collections.abc collectionsrr^ email.utilsr` functoolsr http.clientr http.cookiesrresslrrr urllib.parserrrr tornado.escaper r r tornado.utilr rrrrrrrrrrrrr TYPE_CHECKINGrasynciorunittestr\rpr%abcMutableMappingr'rrrrZrrrrr)rrr7r;r0rrrBrr!r[rd namedtuplercompilerfrhrrlrnrvrOrrrrrrsubrMatchrrrr,r2r$rs   !  CC;;1        4?C?C??w+//00wt[:[:| Y  i  6 :+ &+ \+$V+$\, ,  d38nd5c?3U5c?C;O5PP ,  ,^ z  00 eHSM8C=0120f 2hsm 2(3- 2 2PS 2chsm&* +O+O +OCe$%+O T(^# $ +O k " +O  +O\3939 39Ce$%39 T(^# $ 39  39l9 c5%!1!183D3DDE990))5 ::01333+;3* **6 $GH RC R,= RB39S$_5$  c4S>&9 : FDcNs( 2CJ 2+0e+< 2  2 "ZZ ( c8C=.@(A"$sDL()huS&[7I.Jzz89== S-s-s-6c3hr2