o 2wi'@sNddlmZmZejZejZejZ ej Z ej Z ejZejZGdddeZdS))MappingMutableMappingc@seZdZdZd5ddZddZddZd d Zd d Zd dZ ddZ e j Z e j Z e jZeZefddZddZddZddZddZddZd5ddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)d*Zd+d,Zd-d.Zd/d0Z eZ!eZ"d1d2Z#d3d4Z$dS)6Headersa :param headers: An iterable of field-value pairs. :param kwargs: Additional field-value pairs to pass in to ``Headers.extend``. A ``dict`` like container for storing HTTP Headers. According to RFC 7230, header field names have to be treated case-insentitive. This means `SET-COOKIE` as header field denotes the same field as `set-cookie`. In order to implement this behavior efficiently, all header names are lowered and used as dictionary key for fast access of certain header lines. The original case-sensitive header field is stored alongside the values under the hood. Iterating over Header.items() returns all field-value pairs with the original cases. The order of the returned items matches the input order, except that headers with a matching header field are grouped. Use Header.__setitem__() and Header.update() for overwriting the content of matching header fields and .add() and .extend() for appending header lines instead of overwriting them. Note: b"asdf" and "asdf" are separate things. This class tries not to enforce the one or the other. >>> headers = Headers() >>> headers.add('Set-Cookie', 'foo=bar') >>> headers.add('set-cookie', 'baz=quxx') >>> headers['SET-cookie'] ['foo=bar', 'baz=quxx'] >>> headers['content-length'] = '7' >>> headers['Content-Length'] '7' >>> headers Headers({'Set-Cookie': 'foo=bar, baz=quxx', 'content-length': '7'}) NcKsLt||durt|t|r||n|||r$||dSdSN)dict__init__ isinstancetype _copy_fromextend)selfheaderskwargsrT/home/ubuntu/sommelier/.venv/lib/python3.10/site-packages/geventhttpclient/header.pyr4s   zHeaders.__init__cCst||||fSr) _dict_setitemlower)r fieldvaluerrr __setitem__>szHeaders.__setitem__cCs.t||}t|tr|dSdd|DS)NcSg|]}|dqSrr.0valrrr Ez'Headers.__getitem__..) _dict_getitemrrtupler rvalsrrr __getitem__As zHeaders.__getitem__cCt||Sr) _dict_delitemrr rrrr __delitem__GzHeaders.__delitem__cCr#r)_dict_containsrr%rrr __contains__Jr'zHeaders.__contains__csVtts tds dSttstfddDfddDkS)NkeysFci|]}||qSrr)rf1r rr Rz"Headers.__eq__..cr+rr)rf2)otherrrr.Rr/)rrhasattrr r r1r)r1r r__eq__Ms  $zHeaders.__eq__cCs || Sr)r4r3rrr__ne__Ts zHeaders.__ne__cCs:z||}Wnty||jur|YSw||=|S)zD.pop(field[,default]) -> value, remove specified field and return the corresponding value. If field is not found, d is returned if given, otherwise KeyError is raised. )KeyError_Headers__marker)r rdefaultrrrrpop]s   z Headers.popcCs"z||=WdStyYdSwr)r6r%rrrdiscardms   zHeaders.discardcCsf|}||f}t|||}||ur1t|tr!t||||gdSt|tr-||dStddS)zAdd a (field, value) pair without overwriting the value if it already exists. >>> headers = Headers(foo='bar') >>> headers.add('Foo', 'baz') >>> headers['foo'] 'bar, baz' zinvalid vals storedN)r_dict_setdefaultrrrlistappend TypeError)r rr field_lowernew_valsr!rrraddss    z Headers.addcOst|dkrtdt|dt|dkr|dnd}t|t|r3|D] \}}|||q'n5t|trF|D] }||||q:n"t|dr[|D] }||||qOn |D] \}}|||q]|D] \}}|||qldS)zGeneric import function for any type of header-like object. Adapted version of MutableMapping.update in order to insert items with self.add instead of self.__setitem__ rz.extend() takes at most 1 positional argument ( given)rrr*N) lenr>rr itemsrArr2r*r argsrr1rrrrrr s(     zHeaders.extendcOst|dkrtdt|dt|dkr|dnd}t|t|r1|D]\}}|||<q'n/t|trB|D]}||||<q8nt|drU|D]}||||<qKn |D]\}}|||<qW|D]\}}|||<qddS)zGeneric import function for any type of header-like object. Adapted version of MutableMapping.update in order to overwrite items while preserving case-sensitive header fields. rz.update() takes at most 1 positional argument (rBrrr*N)rCr>rr rDrr2r*rErrrupdates(        zHeaders.updatecCsLz t||}Wn tygYSwt|tr|dgSdd|DS)zxReturns a list of all the values for the named field. Returns an empty list if the field doesn't exist. rcSrrrrrrrrrz#Headers.getlist..)rrr6rrr rrrgetlists   zHeaders.getlistcCs||}|s |S|Sr)rH)r rfailobjvaluesrrrget_alls zHeaders.get_allcCs6|D]}t||}t|trt|}t|||qdSr)rrr<r)r r1rr!rrrr s   zHeaders._copy_fromcCst|}|||Sr)r r )r clonerrrcopys  z Headers.copycCstddt|DS)Ncss&|]}t|tr dnt|VqdSrN)rrrC)rr!rrr s$z"Headers.__len__..)sum _dict_valuesr-rrr__len__szHeaders.__len__cCst|jdt|dS)N())r __name__r itermergedr-rrr__repr__szHeaders.__repr__cCsddd|DS)zReturn a similar string as the original HTTP text received for parsing. Lines with matching header fields are grouped.  css"|] \}}|d|VqdS)z: Nr)rrrrrrrOs z"Headers.__str__..)joinrDr-rrr__str__szHeaders.__str__ccsft|D]+\}}t|tr|Vqt|ddtrdnd}|dd|dd|DfVqdS)zIterate over all headers, merging lines with duplicate header fields together into one item. The case of the first header field is preserved. rz, s, css|]}|dVqdSrNrrrrrrOsz%Headers.itermerged..N) _dict_itemsrrstrrY)r rr!seprrrrVs $zHeaders.itermergedcCs t|S)zCreate a dictionary. Header lines with duplicate field names are merged into one line. This can be used for exchange with other libraries. )rrVr-rrrcompatible_dicts zHeaders.compatible_dictccsJt|D]\}}t|tr||dfVq|D] }||dfVqqdS)zlIterate over all header lines, including duplicate ones. The header fields are all lowered. rNr[rr)r rr!rrrr iterlowers zHeaders.iterlowerccs4t|D]\}}t|tr|Vq|EdHqdS)z8Iterate over all header lines, including duplicate ones.Nr_r rrrrDs   z Headers.itemscCsddl}|dtd|S)NrzVThis is deprecated and will be removed in version v2.3.0. Use Headers.items() instead.)warningswarnDeprecationWarningrD)r rbrrr iteroriginalszHeaders.iteroriginalcCs ddl}|dtd||S)NrzXThis is deprecated and will be removed in version v2.3.0. Use Headers.getlist() instead.ra)rbrcrdrH)r rrbrrrigets z Headers.igetr)%rU __module__ __qualname____doc__rrr"r&r)r4r5rrJgetr*objectr7r9r:rAr rGrHrKr rMrRrWrZrVr^r`rD getheadersgetallmatchingheadersrerfrrrrr sB '       rN)collections.abcrrrrrr"rr&r$r)r( setdefaultr;rDr[rJrQrrrrrs