U <{f@sddlmZddlmZmZmZmZmZmZm Z m Z m Z m Z dddgZ GdddeZGddde eefZGdd d e Ze eeeefee eefefZd S) ) annotations) AnyDictIterableIteratorListMappingMutableMappingProtocolTupleUnionHeaders HeadersLikeMultipleValuesErrorcs&eZdZdZddfdd ZZS)rzT Exception raised when :class:`Headers` has more than one value for a key. strreturncs&t|jdkrt|jdStSNr)lenargsreprsuper__str__self __class__X/var/www/html/Darija-Ai-API/env/lib/python3.8/site-packages/websockets/datastructures.pyrszMultipleValuesError.__str__)__name__ __module__ __qualname____doc__r __classcell__rrrrrscseZdZdZddgZdddddd Zdd d d Zdd d dZdd ddZdd ddZ dddddZ dd ddZ dd ddZ ddddd Z dddd!d"d#Zdddd$d%Zd&dd'd(d)Zdd d*d+Zddddfd,d- Zdd.dd/d0Zd1d d2d3ZZS)4r a Efficient data structure for manipulating HTTP headers. A :class:`list` of ``(name, values)`` is inefficient for lookups. A :class:`dict` doesn't suffice because header names are case-insensitive and multiple occurrences of headers with the same name are possible. :class:`Headers` stores HTTP headers in a hybrid data structure to provide efficient insertions and lookups while preserving the original data. In order to account for multiple values with minimal hassle, :class:`Headers` follows this logic: - When getting a header with ``headers[name]``: - if there's no value, :exc:`KeyError` is raised; - if there's exactly one value, it's returned; - if there's more than one value, :exc:`MultipleValuesError` is raised. - When setting a header with ``headers[name] = value``, the value is appended to the list of values for that header. - When deleting a header with ``del headers[name]``, all values for that header are removed (this is slow). Other methods for manipulating headers are consistent with this logic. As long as no header occurs multiple times, :class:`Headers` behaves like :class:`dict`, except keys are lower-cased to provide case-insensitivity. Two methods support manipulating multiple values explicitly: - :meth:`get_all` returns a list of all values for a header; - :meth:`raw_items` returns an iterator of ``(name, values)`` pairs. _dict_listrrNone)rkwargsrcOsi|_g|_|j||dSN)r%r&updaterrr(rrr__init__JszHeaders.__init__rcCsddd|jDdS)Ncss"|]\}}|d|dVqdS)z:  Nr).0keyvaluerrr Psz"Headers.__str__..r.)joinr&rrrrrOszHeaders.__str__cCs|jjd|jdS)N())rr r&rrrr__repr__RszHeaders.__repr__cCs$|}|j|_|j|_|Sr))rr%copyr&)rr7rrrr7Us  z Headers.copybytescCs t|Sr))rencoderrrr serialize[szHeaders.serializeobjectboolr0rcCst|to||jkSr)) isinstancerlowerr%rr0rrr __contains__aszHeaders.__contains__z Iterator[str]cCs t|jSr))iterr%rrrr__iter__dszHeaders.__iter__intcCs t|jSr))rr%rrrr__len__gszHeaders.__len__cCs.|j|}t|dkr"|dSt|dSr)r%r?rrrr0r1rrr __getitem__ls zHeaders.__getitem__)r0r1rcCs,|j|g||j||fdSr))r% setdefaultr?appendr&rFrrr __setitem__sszHeaders.__setitem__cs.||jfdd|jD|_dS)Ncs$g|]\}}|kr||fqSr)r?)r/kv key_lowerrr {s z'Headers.__delitem__..)r?r% __delitem__r&r@rrMrrPws zHeaders.__delitem__r)otherrcCst|tstS|j|jkSr))r>r NotImplementedr%)rrQrrr__eq__}s zHeaders.__eq__cCsi|_g|_dS)z& Remove all headers. N)r%r&rrrrclearsz Headers.clearcs$tdd|D}tj||dS)zT Update from a :class:`Headers` instance and/or keyword arguments. css$|]}t|tr|n|VqdSr))r>r raw_items)r/argrrrr2sz!Headers.update..N)tuplerr*r+rrrr*szHeaders.updatez List[str]cCs|j|gS)z| Return the (possibly empty) list of all values for a header. Args: key: header name. )r%getr?r@rrrget_allszHeaders.get_allzIterator[Tuple[str, str]]cCs t|jS)zO Return an iterator of all values as ``(name, value)`` pairs. )rBr&rrrrrUszHeaders.raw_items)r r!r"r# __slots__r,rr6r7r:rArCrErGrJrPrSrTr*rYrUr$rrrrr !s$%  c@s.eZdZdZddddZddddd Zd S) SupportsKeysAndGetItemz_ Dict-like types with ``keys() -> str`` and ``__getitem__(key: str) -> str`` methods. z Iterable[str]rcCsdSr)rrrrrkeysszSupportsKeysAndGetItem.keysrr=cCsdSr)rr@rrrrGsz"SupportsKeysAndGetItem.__getitem__N)r r!r"r#r\rGrrrrr[sr[N) __future__rtypingrrrrrrr r r r __all__ LookupErrorrrr r[rrrrrs 0