+ -IjuRt^RIt^RIt^RIt^RIt^RIt^RIt^RI H t ^RI H t ^RI t^RIt^RIHt^RIt^RIt^RIHtHtHtHt^RIHtHtHtHt^RIHtH t ] ^RI!t!^RI!H"t"H#t#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+H,t,]!PZ'd1^R I!H.t.^R I/H0t0^RI1t1]PdPf]4]43,t5M]PdPft5R t6]Pn!R 4t8!R R4t9] !R4RRl4t:!RR]54t;!RR4t<!RR]=4t>!RR]=4t?!RR4t@!RR4tA!RR4tBR R!ltC!R"R#]4tDR$R%ltER&R'ltFR(R)ltG]P!R*R+44tI]P!R,R-44tJ]J!4sKR.R/ltLRTR0R/R1R2llltMR0R/R3R4lltNR5R6ltO!R7R8]!P4tQR9R:ltR!R;R<]!P4tSR=R>ltTR?R@ltURARBltVRCRDltWRERFltXRGtY]Pn!RH4tZRIRJlt[RKRLlt\]Pn!RM4Pt^RNROlt_RPRQlt`RRRSltaR#)UzHTTP 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 ]tRt^NtRt]P !R4t]P !R4t]P !R4t ]P !R]P R]P R] P R24t ]P !R4t ]P !R 4t ]P !R 4t]P !R ] P R]P R 24t]P !R]P R]P R ]P R ]P 24t]P !R4t]P !]P R24t]t]t]P !R ] P R] P R24t]P !R4t]P !R] P R]P R24t]P !]P R24t]P !R]P R]P R]P R 24t]P !R4t]P !R]P R]P R]P R24tRtR#)_ABNFaiClass 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____firstlineno____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_line__static_attributes__r"2/usr/lib/python3/dist-packages/tornado/httputil.pyrrNsQZZ 34NZZ 01Njj!34Ozz ~--.a0F0F/GqI`I`HaacdHzz)$H JJ~ &Ezz.)H**EMM?!H4D4D3EQGHK**        K$7$7#8 @S@S?T VK JJ5 6E JJ5==/+ ,EJ F ::X--.eH4D4D3ERH ID::23LJJ)EMM?!HS>S=TTVWKr@ric0V^8dQhR\R\/#namereturnstr)formats"rA __annotate__rJs??C?C?r@cRPVPR4Uu.uFqP4NK up4#uupi)z]Map a header name to Http-Header-Case. >>> _normalize_header("coNtent-TYPE") 'Content-Type' -)joinsplit capitalize)rEws& rA_normalize_headerrQs1 88TZZ_=_\\^_= >>=s>c a]tRt^toRt]P V3RlRl4t]P V3RlRl4t]P V3RlRl4t]P V3RlR l4tV3R lR ltR R /V3RlRlltV3RlRlt V3RlRlt R R /V3RlRllt ] R R /V3RlRll4t V3RlRltV3RlRltV3RlRltV3RlRltV3R lR!ltV3R"lR#ltV3R$lR%lt]tV3R&lR'lt]tR(tVtR)#)* 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 cJ<V^8dQhRS[S[S[S[,3,RR/#rD_HTTPHeaders__argrFN)rrHr)rI __classdict__s"rArJHTTPHeaders.__annotate__s(  gc49n5 $ r@cR#Nr"selfrVs&&rA__init__HTTPHeaders.__init__ r@c:<V^8dQhRS[S[S[3,RR/#rU)rrH)rIrWs"rArJrXs$  gc3h/ D r@cR#rZr"r[s&&rAr]r^r_r@c:<V^8dQhRS[S[S[3,RR/#)rDargsrFN)rrH)rIrWs"rArJrXs#  eCHo $ r@cR#rZr")r\rcs&*rAr]r^r_r@c$<V^8dQhRS[RR/#)rDkwargsrFNrG)rIrWs"rArJrXs    r@c R#rZr")r\rfs&,rAr]r^r_r@c><V^8dQhRS[PRS[RR/#)rDrcrfrFN)typingAnyrH)rIrWs"rArJrXs&))fjj)C)D)r@c4/Vn/VnRVn\V4^8Xda\V4^8XdQ\ V^,\ 4'd4V^,P 4Fwr4VPW44K R#VP!V/VBR#rZ) _as_list_combined_cache _last_keylen isinstancerSget_alladdupdate)r\rcrfkvs&*, rAr]r^su/1 /1 t9>c&kQ.:d1g{3S3SQ)* KK ( (r@_chars_are_bytesTc0<V^8dQhRS[RS[RS[RR/#)rDrEvaluervrFNrHbool)rIrWs"rArJrXs)$$$C$d$d$r@c \PPV4'g\RV,4hV'dB\PP\ V44'g\RV,4hM-\ PV4'd\RV,4h\V4pW@n W@9dAVPPVR4VPV,PV4R#W V&R#)z#Adds a new value for the given key.zInvalid header name %rInvalid header value %rN)rr6 fullmatchHTTPInputErrorr3r _FORBIDDEN_HEADER_CHARS_REsearchrQrnrmpoprlappend)r\rErxrv norm_names&&&$ rArrHTTPHeaders.adds))$// !9D!@A A $$..z%/@AA%%>%FGGB *0077$%>%FGG%d+ "    $ $Y 5 MM) $ + +E 2#Or@c6<V^8dQhRS[RS[S[,/#rC)rHr)rIrWs"rArJrXs00S0T#Y0r@c P\V4pVPPV.4#)z2Returns all values for the given header as a list.)rQrlgetr\rErs&& rAget_listHTTPHeaders.get_lists#%d+ }}  B//r@cF<V^8dQhRS[S[S[S[3,,/#rDrF)rrrH)rIrWs"rArJrXs!$$%S/2$r@c# p"VPP4FwrVFpW3xK K R#5i)zReturns an iterable of all (name, value) pairs. If a header has multiple values, multiple pairs will be returned with the same name. N)rlitems)r\rEvaluesrxs& rArqHTTPHeaders.get_alls2 !MM//1LDm# 2s46c*<V^8dQhRS[RS[RR/#)rDlinervrFNry)rIrWs"rArJrXs"11s111r@c P\P!RV4;p'dVRVP4pV'gR#V^,\9EdVPf \ R4hRVP \4,pV'd@\PPVR,4'g\ RV,4hM-\PV4'd\ RV,4hVPVP,R ;;,V, uu&VPPVPR4R#VPR^4wrVTP!YVP \4TR 7R# \d \ R 4hi;i) afUpdates 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$Nz.first header line cannot start with whitespace :NNzInvalid header continuation %rr|:zno colon in header linerv)r(rstartHTTP_WHITESPACErnr~striprr3r}rrlrmrrN ValueErrorrr)r\rrvmnew_partrErxs&&$ rA parse_lineHTTPHeaders.parse_linesT( )T* *1 * !'')$D  7o %~~%$%UVVTZZ88H((228B<@@()IH)TUUA.44X>>()BX)MNN MM$.. )" - 9 -  $ $T^^T : @"jja0  HHkk/2EU   @$%>?? @s FF%c*<V^8dQhRS[RS[RR/#)rDheadersrvrFrSry)rIrWs"rArJrX(s"&&C&d&m&r@c V!4p^pVPRV4pVR8XdVPWRVR7V#WV^,pV^,pVPWbR7KZ)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`.  Nrr)findr)clsrrvhrlfrs&&$ rAparseHTTPHeaders.parse'sp8 EdE*BRx WV_?O P26*DFE LLL Ar@c*<V^8dQhRS[RS[RR/#)rDrErxrFNrG)rIrWs"rArJrXRs"+++C+D+r@cX\V4pW PV&V.VPV&R#rZrQrmrl)r\rErxrs&&& rA __setitem__HTTPHeaders.__setitem__Rs*%d+ */Y'$)7 i r@c&<V^8dQhRS[RS[/#rC)objectrz)rIrWs"rArJrXWs***D*r@cd\V\4'gR#\V4pW P9#F)rprHrQrlrs&& rA __contains__HTTPHeaders.__contains__Ws+$$$%d+ MM))r@c&<V^8dQhRS[RS[/#rCrG)rIrWs"rArJrX_s,,,,r@c\V4pW P9d0RPVPV,4VPV&VPV,#),)rQrmrMrl)r\rEheaders&& rA __getitem__HTTPHeaders.__getitem___sK"4( -- -+.88DMM&4I+JD  (##F++r@c$<V^8dQhRS[RR/#)rDrErFNrG)rIrWs"rArJrXes%%%%r@cP\V4pVPVVPVR#rZrrs&& rA __delitem__HTTPHeaders.__delitem__es&%d+   + MM) $r@c <V^8dQhRS[/#r)int)rIrWs"rArJrXjs"""r@c,\VP4#rZ)rorlr\s&rA__len__HTTPHeaders.__len__js4==!!r@cD<V^8dQhRS[S[P,/#r)rrirj)rIrWs"rArJrXms##(6::.#r@c,\VP4#rZ)iterrlrs&rA__iter__HTTPHeaders.__iter__msDMM""r@c<V^8dQhRR/#)rDrFrSr")rIrWs"rArJrXps!!m!r@c\V4#rZ)rSrs&rAcopyHTTPHeaders.copyps 4  r@c <V^8dQhRS[/#rrG)rIrWs"rArJrXysr@c.pVP4Fwr#VPV RV R24K RPV4#)z: r)rqrrM)r\linesrErxs& rA__str__HTTPHeaders.__str__ys@<<>KD LLD6E7"- .*wwu~r@)rlrmrnN)r#r$r%r&r'rioverloadr]rrrrqr classmethodrrrrrrrr__copy__r __unicode__r?__classdictcell__rWs@rArSrSs*8 __   __   __   __  ))($T$$(00 $$111f&T&&&T++ **,, %% ""##!!H Kr@rSca]tRtRtoRtRtRtRtRV3RlRllt] V3RlRl4t V3RlR lt V3R lR lt RV3R lR llt V3RlRltV3RlRltRtVtR#)HTTPServerRequestiaC 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``. .. deprecated:: 6.5.2 The ``host`` argument to the ``HTTPServerRequest`` constructor is deprecated. Use ``headers["Host"]`` instead. This argument was mistakenly removed in Tornado 6.5.0 and temporarily restored in 6.5.2. Nc <V^8dQhRS[S[,RS[S[,RS[RS[S[,RS[S[,RS[S[,RS[S[S[S[R,3,,R S[R ,R S[R ,R S[S[,RR/ #)rDr7uriversionrbodyr8filesHTTPFile connectionHTTPConnection start_lineRequestStartLineserver_connectionrFN)rrHrSbytesrrr)rIrWs"rArJHTTPServerRequest.__annotate__sA!A! A!c]A! A! +& A! uo A!smA!S$z"2234A!-.A!/0A!$F+A! A!r@c ,V eV wrpWnW nW0nT;'g \4VnT;'gRVn\ VRR4p \ V RR4Vn\ V RR4VnT;'gVPR,Vn \PPTP4'g\R TP,4hR TP9d\R TP,4h\TPP44^,TnT;'g/TnYnYn\(P(!4TnRTnTeTP/R 4wTnqn\5TP2RR7Tn\8P:!TP64Tn/TnR# \dTR8Xd RTn ELm\R 4hi;i)Nr@context remote_ipprotocolhttpHostHTTP/1.0z 127.0.0.1zMissing Host headerzInvalid Host header: %rrz%Multiple host headers not allowed: %r?Tkeep_blank_values) r7rrrSrrgetattrrrr8KeyErrorr~rr}split_host_and_portlower host_namerrrtime _start_time _finish_time partitionpathqueryr argumentsrdeepcopyquery_argumentsbody_arguments) r\r7rrrrr8rrrrrseps &&&&&&&&&&& rAr]HTTPServerRequest.__init__s  !#- F  //+- KKC *i6 +t<V<  <44 V 4DIzz##DII.. !:TYY!FG G $)) "!!H499!TU U,TYY__->?B[[b $!299;  ?),s); &DIsJ' dK#}}T^^< K <*$' $%:;;  i;i \dTP#i;i)z0A dictionary of ``http.cookies.Morsel`` objects._cookiesCookie) hasattrrr SimpleCookier r parse_cookier Exception)r\parsedrtrus& rArHTTPServerRequest.cookies-stZ(( ))+ M4<<' !)$,,x*@AF!' !/0MM!,!/}}t}} )!! ! !}}s$B6:B$$ B32B36 CCc <V^8dQhRS[/#rrG)rIrWs"rArJrDs<<#<V^8dQhRS[RS[RS[S[3,/#)rD binary_formrFN)rzrrr)rIrWs"rArJrOs) tT5 !r@c VPfR#VPPPPVR7# \dR#i;i)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&&rAget_ssl_certificate%HTTPServerRequest.get_ssl_certificateOsS* &??))00<<'=   sA/A AAc<V^8dQhRR/#rDrFNr")rIrWs"rArJrns 7 7T 7r@cD\VPPRR4VPVPVP VP4VPP 4F0wrVPPV.4PV4K2 R#) Content-TyperN) parse_body_argumentsrrrrrrr setdefaultextend)r\rtrus& rA _parse_bodyHTTPServerRequest._parse_bodynsx LL  ^R 0 II    JJ LL  ''--/DA NN % %a , 3 3A 60r@c <V^8dQhRS[/#rrG)rIrWs"rArJrzs44#4r@c RpRPVUu.uFq" R\W4: 2NK up4pVPP RV R2#uupi)rz, =r!r)rr8r7rrr)rMr __class__r#)r\attrsnrcs& rA__repr__HTTPServerRequest.__repr__zsWMyyuEu!Cq!1 45uEF..))*!D633FsA)r rrrrrrrrr8rr7rrrrrrrr) NNrNNNNNNNr)r#r$r%r&r'rr _body_futurer]propertyrrrr r)r1r?rrs@rArrsr_B D ELA!A!F,<<88> 7 744r@rc]tRtRtRtRtR#)r~izeException class for malformed HTTP requests or responses from remote sources. .. versionadded:: 4.0 r"Nr#r$r%r&r'r?r"r@rAr~r~s   r@r~c]tRtRtRtRtR#)HTTPOutputErrorizBException class for errors in HTTP output. .. versionadded:: 4.0 r"Nr6r"r@rAr8r8s   r@r8cHa]tRtRtoRtV3RlRltV3RlRltRtVtR#) HTTPServerConnectionDelegateizWImplement this interface to handle requests from `.HTTPServer`. .. versionadded:: 4.0 c(<V^8dQhRS[RRRR/#)rD server_conn request_connrrFHTTPMessageDelegater)rIrWs"rArJ)HTTPServerConnectionDelegate.__annotate__s% $ $! $1A $  $r@c \4h)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\r<r=s&&&rA start_request*HTTPServerConnectionDelegate.start_requests "##r@c$<V^8dQhRS[RR/#)rDr<rFNr?)rIrWs"rArJr@s  F t r@c R#)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\r<s&&rAon_close%HTTPServerConnectionDelegate.on_close r@r"N) r#r$r%r&r'rDrHr?rrs@rAr:r:s $ $  r@r:cla]tRtRtoRtV3RlRltV3RlRltV3RlRltV3R lR ltR t Vt R #) r>izWImplement this interface to handle an HTTP request or response. .. versionadded:: 4.0 cX<V^8dQhRS[R,RS[RS[S[R,,/#)rDrrrFNrResponseStartLine)rrSrr)rIrWs"rArJ HTTPMessageDelegate.__annotate__s8  AB   )D/ "  r@c R#)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\rrs&&&rAheaders_received$HTTPMessageDelegate.headers_receiveds" r@cD<V^8dQhRS[RS[S[R,,/#)rDchunkrFN)rrr)rIrWs"rArJrOs$  5 Xio-F r@c R#)zYCalled when a chunk of data has been received. May return a `.Future` for flow control. Nr"r\rTs&&rA data_received!HTTPMessageDelegate.data_receiveds r@c<V^8dQhRR/#r#r")rIrWs"rArJrOs   r@c R#)z6Called after the last chunk of data has been received.Nr"rs&rAfinishHTTPMessageDelegate.finishr_r@c<V^8dQhRR/#r#r")rIrWs"rArJrOs  T r@c R#)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&rAon_connection_close'HTTPMessageDelegate.on_connection_closerJr@r"N) r#r$r%r&r'rQrWr[r_r?rrs@rAr>r>s2   &      r@r>c^a]tRtRtoRtR V3RlRlltV3RlRltV3RlR ltR tVt R#) rizQApplications use this interface to write their responses. .. versionadded:: 4.0 NcN<V^8dQhRS[R,RS[RS[S[,RR/#)rDrrrTrF Future[None]rM)rrSrr)rIrWs"rArJHTTPConnection.__annotate__s=$$AB$$ $  $r@c \4h)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. rB)r\rrrTs&&&&rA write_headersHTTPConnection.write_headerss ,"##r@c$<V^8dQhRS[RR/#)rDrTrFrc)r)rIrWs"rArJrds $ $5 $^ $r@c \4h)zWrites a chunk of body data. Returns a future for flow control. .. versionchanged:: 6.0 The ``callback`` argument was removed. rBrVs&&rAwriteHTTPConnection.writes "##r@c<V^8dQhRR/#r#r")rIrWs"rArJrds$$$r@c \4h)z3Indicates that the last body data has been written.rBrs&rAr[HTTPConnection.finishs !##r@r"rZ) r#r$r%r&r'rfrjr[r?rrs@rArrs( $$0 $ $$$r@rc V^8dQhR\R\R\\\3,\\\\3,,\\\\3,R3,3,R\/#)rDurlrcN.rF)rHrrrr)rIs"rArJrJ s^,, ,  d38nd5c?3U5c?C;O5PP ,  ,r@c 4VfV#\V4p\V\4'd8\VPRR7pVP VP 44Mz\V\4'g\V\4'd*\VPRR7pVP V4M%RP\V44p\V4h\V4p\V^,V^,V^,V^,VV^,34pV#)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})rrpdictrrr(rlisttuplerItype TypeErrorrr)rprc parsed_url parsed_queryerr final_querys&& rA url_concatr{ s& | #J$ !1!1TJ DJJL) D$  :dE#:#: !1!1TJ D!GNN J nL)K  qM qM qM qM  qM   C Jr@c0a]tRtRtoRtV3RltRtVtR#)ri;zRepresents a file uploaded via a form. For backwards compatibility, its instance attributes are also accessible as dictionary keys. * ``filename`` * ``body`` * ``content_type`` c><V^8dQh/S[;R&S[;R&S[;R&#)rDfilenamer content_type)rHr)rIrWs"rArJHTTPFile.__annotate__;s*M Kr@r"N)r#r$r%r&r'__annotate_func__r?rrs@rArr;sr@rcV^8dQhR\R\\\\,\\,3,,/#)rD range_headerrF)rHrrr)rIs"rArJrJKs3000 eHSM8C=0120r@c:VPR4wrpVP4VP4r1VR8wdR#VPR4wrBp\V4p\V4pTeTfT^8wdT)pRpYg3#T^, pYg3# \dR#i;i)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 r-rNrL)rr _int_or_noner)runit_rxstart_bend_brends& rA_parse_request_rangerKs>"++C0NDU**, % w,GW%5!  =ax < 1HC < sB BBctV^8dQhR\\,R\\,R\R\/#)rDrrtotalrF)rrrH)rIs"rArJrJ~s1 * *hsm *(3- * *PS *r@cVT;'g^pT;'gT^, pRV RV RV 2#)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 zbytes rL/r")rrrs&&&rA_get_content_ranger~s8 JJQE <<%1 C E7!C5% ))r@cFV^8dQhR\R\\,/#)rDvalrF)rHrr)rIs"rArJrJschsmr@cJVP4pVR8XdR#\V4#)rN)rr)rs&rArrs ))+C by s8Or@cBa]tRtRtoRtRt^dtRtV3RltRt Vt R#)ParseMultipartConfigizThis class configures the parsing of ``multipart/form-data`` request bodies. Its primary purpose is to place limits on the size and complexity of request messages to avoid potential denial-of-service attacks. .. versionadded:: 6.5.5 Tc><V^8dQh/S[;R&S[;R&S[;R&#)rDenabled max_partsmax_part_header_size)rzr)rIrWs"rArJ!ParseMultipartConfig.__annotate__s,()4)5r@r"Ni() r#r$r%r&r'rrrrr?rrs@rArrs6GI !*7r@rcXa]tRtRtoRt]P !]R7tV3Rlt Rt Vt R#)ParseBodyConfigizNThis class configures the parsing of request bodies. .. versionadded:: 6.5.5 )default_factoryc&<V^8dQh/S[;R&#)rD multipart)r)rIrWs"rArJParseBodyConfig.__annotate__s$r@r"N) r#r$r%r&r' dataclassesfieldrrrr?rrs@rArrs, '2&7&7,'IDr@rc(V^8dQhR\RR/#)rDconfigrFN)r)rIs"rArJrJs((/(d(r@c VsR#)aSets the **global** default configuration for parsing request bodies. This global setting is provided as a stopgap for applications that need to raise the limits introduced in Tornado 6.5.5, or who wish to disable the parsing of multipart/form-data bodies entirely. Non-global configuration for this functionality will be introduced in a future release. >>> content_type = "multipart/form-data; boundary=foo" >>> multipart_body = b"--foo--\r\n" >>> parse_body_arguments(content_type, multipart_body, {}, {}) >>> multipart_config = ParseMultipartConfig(enabled=False) >>> config = ParseBodyConfig(multipart=multipart_config) >>> set_parse_body_config(config) >>> parse_body_arguments(content_type, multipart_body, {}, {}) Traceback (most recent call last): ... tornado.httputil.HTTPInputError: ...: multipart/form-data parsing is disabled >>> set_parse_body_config(ParseBodyConfig()) # reset to defaults .. versionadded:: 6.5.5 N)_DEFAULT_PARSE_BODY_CONFIGrs&rAset_parse_body_configrs ."(r@rcV^8dQhR\R\R\\\\,3,R\\\\,3,R\ \ ,R\ \,RR/#) rDrrrrrrrFN)rHrrrrrrSr)rIs"rArJrJs}4O4O4O 4OCe$%4O T(^# $ 4O k " 4O _ %4O 4Or@c Vf\pVPR4'd}V'd!RV9d\RVR,,4h\VRR7pTP 4F0wrT 'gKTP T.4PT 4K2 R#VPR4'dV'd!RV9d\RVR,,4hVPR 4p V ^,P4R8wd \R 4hV FZp V P4PR 4wrpV R 8XgK.V'gK8\\V4WW5PR 7R# \R4hR# \dp\RT,4ThRp?ii;i \dp\RT,4ThRp?ii;i)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. Nz!application/x-www-form-urlencodedzContent-Encodingz Unsupported Content-Encoding: %sTrz&Invalid x-www-form-urlencoded body: %szmultipart/form-data;zInvalid content typer-boundaryrzmultipart boundary not foundzInvalid multipart/form-data: %s)r startswithr~r rrr'r(rNrrparse_multipart_form_datar r)rrrrrr uri_argumentserErfieldsrrtrrus&&&&&$ rAr&r&s"~+BCC )W4 2W=O5PP  V*44HM*//1LDv$$T2.55f=2  !6 7 7 )W4 2W=O5PP  O!'',Fay $99$%;<<!KKM33C8  ?qq-Q%@P@P  %%CDD% 8  V !IA!MNTU U V0 O !BQ!FGQ N OsC FA#F)F)"F)4 F) F&F!!F&) G 4GG c V^8dQhR\R\R\\\\,3,R\\\\,3,R\ \ ,RR/#)rDrdatarrrrFN)rrrHrrrr)rIs"rArJrJsf?9?9?9 ?9Ce$%?9 T(^# $ ?9 ) * ?9 ?9r@c Vf\PpVP'g \R4hVP R4'dVP R4'dV^RpVP RV,R,4pVR8Xd \R4hVRVPRV,R,VP^,4p\V4VP8d \R4hVEFspV'gKVPR4pVR8Xd \R 4hWP8d \R 4h\PVRVPR 4R R 7p V PRR4p \!V 4wrV R8wgVP R4'g \R4hWx^,Rp V PR4'g \R4hV R,pV PR4'dIV PRR4pVP#V.4P%\'V R,WR74EKRVP#V.4P%V 4EKv R#)aAParses 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. Nz'multipart/form-data parsing is disabled"s--z4Invalid multipart/form-data: no final boundary founds z&multipart/form-data has too many partss z#multipart/form-data missing headersz)multipart/form-data part header too largezutf-8FrzContent-Dispositionrz form-datazInvalid multipart/form-datarEz multipart/form-data missing namer~r%zapplication/unknown)r~rrr)rrrr~rendswithrfindrNrrorrrSrdecoder _parse_headerr'rr)rrrrrfinal_boundary_indexpartsparteohr disp_header disposition disp_paramsrxrEctypes&&&&$ rArrs$&~+55 >>>FGG 4  X%6%6t%<%<Ab>::eh&6&>?r!STT && ' - - 7"F$4$4q$8 E 5zF$$$EFF ii $ "9 !FG G ,, , !LM M##D#J$5$5g$>QV#Wkk"7< #0#= + %T]]7-C-C !>? ?1Wr"v&& !CD D6" ??: & &KK0EFE   T2 & - -(45   r * 1 1% 83r@cV^8dQhR\\\\\P \ P 3,R\/#)rDtsrF)rrrrtr struct_timedatetimerH)rIs"rArJrJYs899 c5%!1!183D3DDE99r@c\V\\34'dTpM\V\\P 34'd\ P!V4pMW\V\P4'd&\ P!VP44pM\RV,4h\PPVRR7#)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)rprrrtrrcalendartimegmr utctimetuplervemailutils formatdate)rtime_nums& rAformat_timestamprYs"sEl## B 0 01 2 2??2& B)) * *??2??#454r9:: ;; ! !(4 ! 88r@c,a]tRtRtoV3RltRtVtR#)riqc><V^8dQh/S[;R&S[;R&S[;R&#)rDr7rrrG)rIrWs"rArJRequestStartLine.__annotate__qs% K ILr@r"Nr#r$r%r&rr?rrs@rArrqr@rc0V^8dQhR\R\/#rDrrF)rHr)rIs"rArJrJws  3 +; r@cX\PPV4pV'g \R4h\ VP ^4VP ^4VP ^44pVP PR4'g\RVP ,4hV#)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 lineHTTP/1Unexpected HTTP version %r)rr<r}r~rgrouprrrmatchrs& rAparse_request_start_linerws    ( ( .E :;;QQQHA 99   ) )9AIIEFF Hr@c,a]tRtRtoV3RltRtVtR#)rNic><V^8dQh/S[;R&S[;R&S[;R&#)rDrcodereason)rHr)rIrWs"rArJResponseStartLine.__annotate__s% L I Kr@r"Nrrs@rArNrNrr@rNc0V^8dQhR\R\/#r)rHrN)rIs"rArJrJs  C ,= r@cj\PPV4pV'g \R4h\ VP ^4\ VP ^44VP ^44pVPPR4'g\RVP,4hV#)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 linerr) rr>r}r~rNrrrrrs& rAparse_response_start_liners    ' ' -E @AA%++a.#ekk!n*=u{{1~NA 99   ) )9AIIEFF Hr@cLV^8dQhR\R\\RR3,/#)rDsrFN)rHr)rIs"rArJrJs%39S$_5r@c#"^pVPRV4V8XdV^, pVPRV4pT^rCV^8dZW@PRW24VPRW24, , pV^,^8XdMY0PRV^,4r2K`V^8d \V4pWVpVP4xTpKR#5i)r"z\"N)rcountror)rrrinddifffs& rA _parseparamrs E &&e  %  ffS% 1TAg GGC*QWWUC-EE EDax1}FF3a0 7a&C CLggi &sCCctV^8dQhR\R\\\\\3,3,/#r)rHrr)rIs"rArJrJs,   c4S>&9 : r@c\\RV,4p\V4pR.pVFspVPR4pV^8gKVRVP4P 4pWE^,RP4pVP V\ V434Ku \PPV4pVP^4/p VFYwrj\PPV 4p\V4^8d"V^,R8XdVR,R8XdV^RpWyV&K[ W)3#)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' rr-Nr)Dummyrxr) rnextrrrrr rr decode_paramsrcollapse_rfc2231_valuero) rrkeyparamspirErxdecoded_paramspdict decoded_values & rArrs  d #E u+C !F  FF3K 6Ra5;;=&&(D!egJ$$&E MM4E!23 4  [[..v6Nq E- 22=A u:?uQx3593C!BKEd . :r@c^V^8dQhR\R\\\3,R\/#)rDrrrFrHr)rIs"rArJrJs)DcNsr@cV'gV#V.p\VP44F2wr4VfVPV4KVPV RV 24K4 RPV4#)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' r-z; )sortedrrrM)rroutrtrus&& rA_encode_headerrsb  %Cu{{}% 9 JJqM JJ!AaSz " & 99S>r@cV^8dQhR\\\3,R\\\3,R\/#)rDusernamepasswordrF)rrHr)rIs"rArJrJs6 2 2CJ 2+0e+< 2  2r@c\V\4'd\P!RV4p\V\4'd\P!RV4p\ V4R,\ V4,#)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:)rpr unicodedata normalizer )rrs&&rAencode_username_passwordr sZ(L))((9(L))((9 >D 4> 11r@cB^RIpVPVPR7#)rN) optionflags)doctest DocTestSuiteELLIPSIS)rs rAdoctestsrs   G,<,<  ==r@z ^(.+):(\d+)$chV^8dQhR\R\\\\,3,/#)rDnetlocrF)rHrrr)rIs"rArJrJs(c8C=.@(Ar@c\PV4pV'd/VP^4p\VP^44pW#3#TpRpW#3#)z{Returns ``(host, port)`` tuple from ``netloc``. Returned ``port`` will be ``None`` if not present. .. versionadded:: 4.1 N) _netloc_rerrr)rrr8ports& rArrsT   V $E {{1~5;;q>" < <r@cV^8dQhR\\\\,3,R\\ \\3,,/#)rDqsrF)rrHrrrr)rIs"rArJrJ+s6$sDL()huS&[7I.Jr@c#\"VP4FwrVFpW3xK K R#5i)z_Generator converting a result of ``parse_qs`` back to name-value pairs. .. versionadded:: 5.0 N)r)rrtvsrus& rA qs_to_qslr+s* A&Ls*,z\\(?:([0-3][0-7][0-7])|(.))cDV^8dQhR\PR\/#)rDrrF)r(MatchrH)rIs"rArJrJ8sSr@cjV^,'d\\V^,^44#V^,#)r)chrr)rs&rA_unquote_replacer"8s)tt3qtQ<  t r@c0V^8dQhR\R\/#)rDrrFrG)rIs"rArJrJ?s--s-s-r@cVe\V4^8dV#V^,R8wgVR,R8wdV#V^Rp\\V4#)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. rr)ro _unquote_subr")rs&rA_unquote_cookier&?sO yCFQJts{aesl !BA (! ,,r@cRV^8dQhR\R\\\3,/#)rDcookierFr)rIs"rArJrJZs"c3hr@c/pVPR4F`pRV9dVPR^4wr4MRTrCVP4VP4rCV'g V'gKS\V4W&Kb V#)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 rr-r)rNrr&)r( cookiedictrTrrs& rAr r ZsnJc" %<{{3*HC599; S ##-c2JO# r@rZ)br'rcollections.abc collectionsrrr email.utilsr functoolsr http.clientr http.cookiesrr(sslrrr  urllib.parserrrrtornado.escaper r r r tornado.utilr rrirrrrrrrrrrr TYPE_CHECKINGrasynciorunittestabcMutableMappingrHStrMutableMappingrr)rrrQrSrrr~r8r:r>rr{rrrr dataclassrrrrr&rr NamedTuplerrrNrrrrr rrrrsubr%r"r&r r"r@rAr>s[   !  CCGG1      $66sCx@#66 ZZ(KL55p 4??o#od{4{4| Y  i   :+ + \+$+$\,^ z  0f * B  D D D-.(44O)-4O4On?9 .2 ?9D90v((  ,))  H$ F( 2 >ZZ ( "zz89== -6r@