o
�J�h� � @ s� d dl mZ d dlmZmZmZmZ d dlmZm Z m
Z
g d�Z G dd� de �Z
G dd� deeef �ZG d d
� d
e �Ze
eeeef eeeef ef Zd S ) � )� annotations)�Iterable�Iterator�Mapping�MutableMapping)�Any�Protocol�Union)�Headers� HeadersLike�MultipleValuesErrorc s" e Zd ZdZd� fdd� Z� ZS )r zP
Exception raised when :class:`Headers` has multiple values for a key.
�return�strc s& t | j�dkrt| jd �S t� �� S �N� r )�len�args�repr�super�__str__��self�� __class__� �WC:\pinokio\api\whisper-webui.git\app\env\lib\site-packages\websockets\datastructures.pyr s
zMultipleValuesError.__str__�r
r )�__name__�
__module__� __qualname__�__doc__r �
__classcell__r r r r r s r c s� e Zd ZdZddgZd5d
d �Zd6d d
�Zd6dd�Zd7dd�Zd8dd�Z d9dd�Z
d:dd �Z d;d d �Z d<d d!�Z
d=d#d$�Zd>d%d&�Zd?d)d*�Zd@d+d,�Zd5� fd-d.� ZdAd0d1�ZdBd3d4�Z� ZS )Cr
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�_listr r �kwargsr r
�Nonec O s i | _ g | _| j|i |�� d S �N)r" r# �update�r r r$ r r r �__init__D s zHeaders.__init__c C s d� dd� | jD ��d S )N� c s s$ � | ]
\}}|� d |� d�V qdS )z: �
Nr )�.0�key�valuer r r � <genexpr>J s �" z"Headers.__str__.<locals>.<genexpr>r+ )�joinr# r r r r r I s zHeaders.__str__c C s | j j� d| j�d�S )N�(�))r r r# r r r r �__repr__L s zHeaders.__repr__c C s$ | � � }| j�� |_| j�� |_|S r& )r r" �copyr# )r r4 r r r r4 O s z Headers.copy�bytesc C s t | ��� S r& )r �encoder r r r � serializeU s zHeaders.serializer- �object�boolc C s t |t�o |�� | jv S r& )�
isinstancer �lowerr" �r r- r r r � __contains__[ s zHeaders.__contains__�
Iterator[str]c C �
t | j�S r& )�iterr" r r r r �__iter__^ �
zHeaders.__iter__�intc C r? r& )r r" r r r r �__len__a rB zHeaders.__len__c C s* | j |�� }t|�dkr|d S t|��r )r" r; r r �r r- r. r r r � __getitem__f s zHeaders.__getitem__r. c C s, | j �|�� g ��|� | j�||f� d S r& )r" �
setdefaultr; �appendr# rE r r r � __setitem__m s zHeaders.__setitem__c s. |� � � | j�� � � fdd�| jD �| _d S )Nc s$ g | ]\}}|� � � kr||f�qS r )r; )r, �k�v�� key_lowerr r �
<listcomp>u s $ z'Headers.__delitem__.<locals>.<listcomp>)r; r" � __delitem__r# r< r rL r rO q s zHeaders.__delitem__�otherr c C s t |t�stS | j|jkS r& )r: r
�NotImplementedr" )r rP r r r �__eq__w s
zHeaders.__eq__c C s i | _ g | _dS )z&
Remove all headers.
N)r" r# r r r r �clear| s
z
Headers.clearc s( t dd� |D ��}t� j|i |�� dS )zT
Update from a :class:`Headers` instance and/or keyword arguments.
c s s& � | ]}t |t�r
|�� n|V qd S r& )r: r
� raw_items)r, �argr r r r/ � s �
�z!Headers.update.<locals>.<genexpr>N)�tupler r' r( r r r r' � s �zHeaders.update� list[str]c C s | j �|�� g �S )z|
Return the (possibly empty) list of all values for a header.
Args:
key: Header name.
)r" �getr; r< r r r �get_all� s zHeaders.get_all�Iterator[tuple[str, str]]c C r? )zO
Return an iterator of all values as ``(name, value)`` pairs.
)r@ r# r r r r rT � s
zHeaders.raw_items)r r r$ r r
r% r )r
r
)r
r5 )r- r8 r
r9 )r
r> )r
rC �r- r r
r )r- r r. r r
r% )r- r r
r% )rP r r
r9 )r
r% )r- r r
rW )r
rZ )r r r r � __slots__r) r r3 r4 r7 r= rA rD rF rI rO rR rS r' rY rT r! r r r r r
s& %
r
c @ s$ e Zd ZdZd dd�Zd dd �Zd
S )
�SupportsKeysAndGetItemz_
Dict-like types with ``keys() -> str`` and ``__getitem__(key: str) -> str`` methods.
r
�
Iterable[str]c C � d S r& r r r r r �keys� � zSupportsKeysAndGetItem.keysr- r c C r_ r& r r< r r r rF � ra z"SupportsKeysAndGetItem.__getitem__N)r
r^ r[ )r r r r r` rF r r r r r] � s
r] N)�
__future__r �collections.abcr r r r �typingr r r �__all__� LookupErrorr r r
r] rV r r r r r �<module> s
��