hy"SrSSKJr SSKJrJrJrJrJrJ r J r J r J r J r JrJr SSKJrJr SSKJr "SS\5r\ "S5rSS jr\"S S 55r"S S 5r\"5rS /rg)z2 An API for storing HTTP header names and values. ) annotations) AnyStrClassVarDictIteratorListMappingOptionalSequenceTupleTypeVarUnionoverload)cmp comparable)_istokenc\rSrSrSrSrg)InvalidHeaderNamez= HTTP header names must be tokens, per RFC 9110 section 5.1. N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r_/root/1688_scrapy/alibaba-scraper/venv/lib/python3.13/site-packages/twisted/web/http_headers.pyrrsrr_Tc@SRUR55$)z Replace linear whitespace (C{\n}, C{\r\n}, C{\r}) in a header value with a single space. @param headerComponent: The header value to sanitize. @return: The sanitized header value.  )join splitlines)headerComponents r_sanitizeLinearWhitespacer%&s 99_//1 22rc\rSrSrSrS/rSSSjjrSSjrSrSSjr SS jr SS jr SS jr SS jr \SS j5r\SSj5rSSSjjrSSjrSrg)Headers2a Stores HTTP headers in a key and multiple value format. When passed L{str}, header names (e.g. 'Content-Type') are encoded using ISO-8859-1 and header values (e.g. 'text/html;charset=utf-8') are encoded using UTF-8. Some methods that return values will return them in the same type as the name given. If the header keys or values cannot be encoded or decoded using the rules above, using just L{bytes} arguments to the methods of this class will ensure no decoding or encoding is done, and L{Headers} will treat the keys and values as opaque byte strings. @ivar _rawHeaders: A L{dict} mapping header names as L{bytes} to L{list}s of header values as L{bytes}. _rawHeadersNcn0UlUb+UR5Hup#URX#5 M ggN)r)items setRawHeaders)self rawHeadersnamevaluess r__init__Headers.__init__Gs:68  ! * 0 0 2 ""40!3 "rcbSRURRUR5$)zB Return a string fully describing the headers set on this object. z{}({!r}))format __class__rr)r.s r__repr__Headers.__repr__Ps-  NN # #     rc[U[5(aN[[URR 55[URR 555$[ $)z] Define L{Headers} instances as being equal to each other if they have the same raw headers. ) isinstancer'rsortedr)r,NotImplemented)r.others r__cmp__Headers.__cmp__YsS eW % %t''--/0&9J9J9P9P9R2S rc8URUR5$)zO Return a copy of itself with the same headers set. @return: A new L{Headers} )r6r)r7s rcopy Headers.copyds~~d..//rcF[RU5UR;$)z Check for the existence of a given header. @param name: The name of the HTTP header to check for. @return: C{True} if the header exists, otherwise C{False}. ) _nameEncoderencoder)r.r0s r hasHeaderHeaders.hasHeaderns ""4(D,<,<< ? #0rcURR[RU5/5R [ [ U[5(aURS5OU55 g)z Add a new raw value for the given header. @param name: The name of the header for which to set the value. @param value: The value to set for the named header. rON)r) setdefaultrErFrQr%r;rP)r.r0values r addRawHeaderHeaders.addRawHeadersR ##L$7$7$=rBII %(25#(>(> V$E  rcgr+rrGs r getRawHeadersHeaders.getRawHeaders rcgr+r)r.r0defaults rr]r^r_rc[RU5nURRU/5nU(dU$[ U[ 5(a!UVs/sHoUR S5PM sn$U$s snf)aE Returns a sequence of headers matching the given name as the raw string given. @param name: The name of the HTTP header to get the values of. @param default: The value to return if no header with the given C{name} exists. @return: If the named header is present, a sequence of its values. Otherwise, C{default}. rO)rErFr)getr;rPdecode)r.r0ra encodedNamer1rTs rr]r^sg#))$/ !!%%k26N dC .45fHHV$f5 5 6sA3cH[URR55$)z Return an iterator of key, value pairs of all headers contained in this object, as L{bytes}. The keys are capitalized in canonical capitalization. )iterr)r,r7s rgetAllRawHeadersHeaders.getAllRawHeaderss D$$**,--r)r)r+)r/z+Optional[Mapping[AnyStr, Sequence[AnyStr]]]returnNone)rjrP)rjr')r0rrjbool)r0rrjrk)r0Union[str, bytes]r1zSequence[Union[str, bytes]]rjrk)r0rmrYrmrjrk)r0rrjzOptional[Sequence[AnyStr]])r0rrarrjzUnion[Sequence[AnyStr], _T])r0rraz Optional[_T]rjz%Union[Sequence[AnyStr], Optional[_T]])rjz'Iterator[Tuple[bytes, Sequence[bytes]]])rrrrr __slots__r2r8r?rBrHrLr-rZrr]rhrrrrr'r'2s"ICG1?1 1  0=>0%0/J0 06      59%1 .0.rr'cd\rSrSr%SrSrS\S'SSSS S S S S .rS\S'SrS\S'Sr SSjr Sr g) _NameEncodera| C{_NameEncoder} converts HTTP header names to L{bytes} and canonicalizies their capitalization. @cvar _caseMappings: A L{dict} that maps conventionally-capitalized header names to their canonicalized representation, for headers with unconventional capitalization. @cvar _canonicalHeaderCache: A L{dict} that maps header names to their canonicalized representation. _canonicalHeaderCachezDict[Union[bytes, str], bytes]rss Content-MD5sDNTsETagsP3PsTEsWWW-AuthenticatesX-XSS-Protection)s Content-Md5sDntsEtagsP3psTesWww-AuthenticatesX-Xss-ProtectionzClassVar[Dict[bytes, bytes]] _caseMappingsi'z ClassVar[int]_MAX_CACHED_HEADERSc0Ulgr+rrr7s rr2_NameEncoder.__init__s %'"rcURRU5=n(aU$[U[5(aUR S5OUn[ U5(d [ U5eSRURS5Vs/sHoDR5PM sn5nXPR;aURUn[UR5UR:aXPRU'U$s snf)aL Encode the name of a header (eg 'Content-Type') to an ISO-8859-1 bytestring if required. It will be canonicalized to Http-Header-Case. @raises InvalidHeaderName: If the header name contains invalid characters like whitespace or NUL. @param name: An HTTP header name @return: C{name}, encoded if required, in Header-Case z iso-8859-1-) rsrcr;rPrFrrr"split capitalizertlenru)r.r0 canonicalName bytes_namewordresults rrF_NameEncoder.encodes!66::4@ @= @ 2rs #    2&   T] 3 ^.^. ^.BBBJ~  +r