Vhy"dZddlmZddlmZmZmZmZmZm Z m Z m Z m Z m Z mZmZddlmZmZddlmZGddeZe dZdd ZeGd d ZGd d ZeZ d gZy)z2 An API for storing HTTP header names and values. ) annotations) AnyStrClassVarDictIteratorListMappingOptionalSequenceTupleTypeVarUnionoverload)cmp comparable)_istokenceZdZdZy)InvalidHeaderNamezE HTTP header names must be tokens, per RFC 9110 section 5.1. N)__name__ __module__ __qualname____doc__H/home/dcms/DCMS/lib/python3.12/site-packages/twisted/web/http_headers.pyrrsrr_Tc@dj|jS)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 22rceZdZdZdgZ d ddZddZdZddZddZ dd Z dd Z dd Z e dd Ze dd Z d ddZddZy)Headersa 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}. _rawHeadersNcli|_|+|jD]\}}|j||yyN)r%items setRawHeaders)self rawHeadersnamevaluess r__init__zHeaders.__init__GsC68  ! * 0 0 2 1 f""40 1 "rcbdj|jj|jS)zR Return a string fully describing the headers set on this object. z{}({!r}))format __class__rr%r*s r__repr__zHeaders.__repr__Ps-  NN # #     rct|trNtt|jj t|jj St S)zu 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__zHeaders.__cmp__YsP eW %t''--/0&9J9J9P9P9R2S rc8|j|jS)zg Return a copy of itself with the same headers set. @return: A new L{Headers} )r1r%r2s rcopyz Headers.copyds~~d..//rcDtj||jvS)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*r,s r hasHeaderzHeaders.hasHeaderns ""4(D,<,<<r?s r removeHeaderzHeaders.removeHeaderxs% \006=rctj|}g}|D]@}t|tr|jd}n|}|j t |B||j |<y)a Sets the raw representation of the given header. @param name: The name of the HTTP header to set the values for. @param values: A list of strings each one being a header value of the given name. @raise TypeError: Raised if C{values} is not a sequence of L{bytes} or L{str}, or if C{name} is not L{bytes} or L{str}. @return: L{None} utf8N)r=r>r5strappendr"r%)r*r,r-_name encodedValuesv_vs rr)zHeaders.setRawHeaderssm ##D)%'  @A!S!XXf%  !:2!> ?  @#0rc|jjtj|gj t t |tr|jdy|y)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. rEN)r% setdefaultr=r>rGr"r5rF)r*r,values r addRawHeaderzHeaders.addRawHeadersZ ##L$7$7$=rBII %(25#(> V$  DI  rcyr'rr?s r getRawHeaderszHeaders.getRawHeaders rcyr'r)r*r,defaults rrQzHeaders.getRawHeadersrRrctj|}|jj|g}|s|St |t r|Dcgc]}|j dc}S|Scc}w)a 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}. rE)r=r>r%getr5rFdecode)r*r,rT encodedNamer-rJs rrQzHeaders.getRawHeaderssb#))$/ !!%%k26N dC .45AHHV$5 5 6s A'cHt|jjS)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(r2s rgetAllRawHeaderszHeaders.getAllRawHeaderss D$$**,--rr')r+z+Optional[Mapping[AnyStr, Sequence[AnyStr]]]returnNone)r\rF)r\r$)r,rr\bool)r,rr\r])r,Union[str, bytes]r-zSequence[Union[str, bytes]]r\r])r,r_rNr_r\r])r,rr\zOptional[Sequence[AnyStr]])r,rrTrr\zUnion[Sequence[AnyStr], _T])r,rrTz Optional[_T]r\z%Union[Sequence[AnyStr], Optional[_T]])r\z'Iterator[Tuple[bytes, Sequence[bytes]]])rrrr __slots__r.r3r9r;r@rCr)rOrrQr[rrrr$r$2s"ICG1?1 1  0=>0%0/J0 06      59%1 .0.rr$cZeZdZUdZdZded<ddddd d d d Zd ed<dZded<dZddZ y) _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]rds Content-MD5sDNTsETagsP3PsTEsWWW-AuthenticatesX-XSS-Protection)s Content-Md5sDntsEtagsP3psTesWww-AuthenticatesX-Xss-ProtectionzClassVar[Dict[bytes, bytes]] _caseMappingsi'z ClassVar[int]_MAX_CACHED_HEADERSci|_yr'rcr2s rr.z_NameEncoder.__init__s %'"rc|jj|x}r|St|tr|j dn|}t |s t |dj|jdDcgc]}|jc}}||jvr|j|}t|j|jkr||j|<|Scc}w)a 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-) rdrVr5rFr>rrrsplit capitalizerelenrf)r*r, canonicalName bytes_namewordresults rr>z_NameEncoder.encodes!66::4@ @= @ 2rrrrbrbsQ +I99'003M/*0/(#rrbN)r!rqr\rq)r __future__rtypingrrrrrr r r r r rrtwisted.python.compatrrtwisted.web._abnfr ValueErrorrrr"r$rbr=__all__rrrrys #    2&   T] 3 ^.^. ^.BBBJ~  +r