File: //opt/saltstack/salt/lib/python3.10/site-packages/aiohttp/__pycache__/web_response.cpython-310.pyc
o
;j?x � @ sl d dl Z d dlZd dlZd dlZd dlZd dlZd dlZd dlZd dlm Z m
Z
d dl m Z d dl
mZ d dlmZ d dlmZmZmZmZmZmZ d dlmZmZ dd lm Z m Z dd
l m Z dd l m!Z!m"Z" dd l#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z. dd
l
m/Z/m0Z0m1Z1 ddl m2Z2 ddl3m4Z4m5Z5m6Z6 dd� eD �Z7dZ8er�ddl9m:Z: e
e;ef Z<nej j
Z<ed�Z=G dd� dej>�Z?dd� e?D �Z@G dd� de
e;e(e B ef e'�ZAG dd� deA�ZBe,fddd ddd ejCd �d ed e;dB d!eDdB d"eEd#e;dB d$e6dB d%e;d&e5d'eBfd(d)�ZFe,fdd ddd d*�d ed&e4d!eDdB d"eEd#e;dB d$e6dB d%e;d'eBfd+d,�ZGdS )-� N)�Iterator�MutableMapping)�Executor)�
HTTPStatus)� SimpleCookie)�
TYPE_CHECKING�Any�Optional�TypeVar�cast�overload)� CIMultiDict�istr� )�hdrs�payload)�AbstractStreamWriter)�MAX_SYNC_CHUNK_SIZE�ZLibCompressor) �ETAG_ANY�QUOTED_ETAG_RE�ETag� HeadersMixin� ResponseKey�must_be_empty_body�parse_http_date�rfc822_formatted_time�sentinel� should_remove_content_length�validate_etag_value)�SERVER_SOFTWARE�
HttpVersion10�
HttpVersion11)�Payload)�JSONBytesEncoder� JSONEncoder� LooseHeadersc C s i | ]}|j |j�qS � )�value�phrase)�.0Z http_statusr' r' �H/opt/saltstack/salt/lib/python3.10/site-packages/aiohttp/web_response.py�
<dictcomp>% s r, )�
ContentCoding�StreamResponse�Response�
json_response�json_bytes_response)� BaseRequest�_Tc @ s e Zd ZdZdZdZdS )r- �deflate�gzip�identityN)�__name__�
__module__� __qualname__r4 r5 r6 r' r' r' r+ r- < s r- c C s i | ]}|j |�qS r' �r( )r* �codingr' r' r+ r, F s c s� e Zd ZU deB eB eB ed< dZdZdZ e
dB ed< dZ e
ed< dZ e
ed< dZ
edB ed< dZedB ed < dZed
ed < dZedB ed < dZe
ed
< dZe
dB ed< dZdZedB ed< dZe� Z ee ed< ddddd�dede dB de dB de e dB ddf
dd�Z e!de
fdd ��Z"e!d�d d ��Z#e!defd d!��Z$e!de
fd"d#��Z%e!de
fd$d%��Z&e!de fd&d'��Z' d�dede dB ddfd(d)�Z(dede dB ddfd*d+�Z)e!de
dB fd,d-��Z*d�d.d/�Z+e!defd0d1��Z,e!defd2d3��Z-d�d4edB ddfd5d6�Z. d�d7e
eB dB d8edB ddfd9d:�Z/e!d�d<d=��Z0e!defd>d?��Z1dddd@ddddddA� dBe dCe dDe dB dEe dB dFee B dB dGe dHe
dB dIe
dB dJe dB dKe dB dLe
dB ddfdMdN�Z2dd@ddddO�dBe dEe dB dGe dHe
dB dIe
dB dKe dB ddfdPdQ�Z3e!dedB f� fdRdS� �Z4e4j5dCedB ddfdTdS��Z4e!de f� fdUdV� �Z6e6j5dCe ddfdWdV��Z6e!de dB f� fdXdY� �Z7e7j5dCe dB ddfdZdY��Z7e!de8j8dB fd[d\��Z9e9j5dCee:B e8j8B e B dB ddfd]d\��Z9e!de;dB fd^d_��Z<e<j5dCe;e B dB ddfd`d_��Z<e=j>fdae?ddfdbdc�Z@ddeddfdedf�ZAd�dhdi�ZBdgd
dedB fdjdk�ZCdgd
defdldm�ZDd�dndo�ZEd�dpdq�ZFdreeB eGB ddfdsdt�ZHd�dudv�ZId�dreddfdxdy�ZJde fdzd{�ZKeLd|eMeN deNfd}d~��ZOeLd|e dePfdd~��ZOd|e eMeN B dePfd�d~�ZOeLd|eMeN dCeNddfd�d���ZQeLd|e dCePddfd�d���ZQd|e eMeN B dCePddfd�d��ZQd|e eMeN B ddfd�d��ZRdefd�d��ZSdeTe eMeP B fd�d��ZUdefd�d��ZVd�eWde
fd�d��ZXde
fd�d��ZY� ZZS )�r. N�_bodyT� _keep_aliveF�_chunked� _compression�_compression_strategy�_compression_forcer2 �_req�_payload_writer� _eof_sent�_must_be_empty_bodyr �_cookies�_seen_str_keys�� )�status�reason�headers�
_real_headersrI rJ rK rL �returnc C sB i | _ |dur || _n|durt|�| _nt� | _| �||� dS )a; Initialize a new stream response object.
_real_headers is an internal parameter used to pass a pre-populated
headers object. It is used by the `Response` class to avoid copying
the headers when creating a new response object. It is not intended
to be used by external code.
N)�_state�_headersr
� _set_status)�selfrI rJ rK rL r' r' r+ �__init__` s zStreamResponse.__init__c C s | j p| jd uS �N)rD rC �rQ r' r' r+ �preparedz s zStreamResponse.prepared�asyncio.Task[None] | Nonec C s | j r| j jS d S rS )rB �taskrT r' r' r+ rW ~ s zStreamResponse.taskc C � | j S rS )�_statusrT r' r' r+ rI � � zStreamResponse.statusc C rX rS )r> rT r' r' r+ �chunked� rZ zStreamResponse.chunkedc C rX rS )r? rT r' r' r+ � compression� rZ zStreamResponse.compressionc C rX rS )�_reasonrT r' r' r+ rJ � rZ zStreamResponse.reasonc C s | j rJ d��| �||� d S )NzGCannot change the response status code after the headers have been sent)rU rP �rQ rI rJ r' r' r+ �
set_status� s
��zStreamResponse.set_statusc C sD t |�| _|d u rt�| jd�}n d|v sd|v r td��|| _d S )N� �
�
z Reason cannot contain \r or \n)�intrY �REASON_PHRASES�get�
ValueErrorr] r^ r' r' r+ rP � s
zStreamResponse._set_statusc C rX rS �r= rT r' r' r+ �
keep_alive� rZ zStreamResponse.keep_alivec C s
d| _ d S )NFrg rT r' r' r+ � force_close� �
zStreamResponse.force_closec C rX rS )� _body_lengthrT r' r' r+ � body_length� rZ zStreamResponse.body_lengthc C s t �dt� | js J �| jjS )Nzoutput_length is deprecated)�warnings�warn�DeprecationWarningrC Z buffer_sizerT r' r' r+ �
output_length� s
z StreamResponse.output_length�
chunk_sizec C s2 t j| jv r
td��|durt�dt� d| _dS )z,Enables automatic chunked transfer encoding.z>You can't enable chunked encoding when a content length is setNz Chunk size is deprecated #1615T)r �CONTENT_LENGTHrO � RuntimeErrorrm rn ro r> )rQ rq r' r' r+ �enable_chunked_encoding� s �
z&StreamResponse.enable_chunked_encoding�force�strategyc C sX t |t�r|r
tjntj}t�dt� n
|dur!t |t�s!J d��d| _|| _ || _
dS )z&Enables response compression encoding.z+Using boolean for force is deprecated #3318Nz1force should one of None, bool or ContentEncodingT) �
isinstance�boolr- r4 r6 rm rn ro r? rA r@ )rQ ru rv r' r' r+ �enable_compression� s
���
z!StreamResponse.enable_compression�CIMultiDict[str]c C rX rS )rO rT r' r' r+ rK � rZ zStreamResponse.headersc C s | j d u r t� | _ | j S rS )rF r rT r' r' r+ �cookies� s
zStreamResponse.cookies�/) �expires�domain�max_age�path�secure�httponly�version�samesite� partitioned�namer( r} r~ r r� r� r� r� r� r� c
C s� | j du r t� | _ || j |< | j | } |dur || d< n
| �d�dkr&| d= |dur.|| d< |dur9t|�| d< nd| v r@| d= || d< |durL|| d< |durT|| d< | dur\| | d < |
durd|
| d
< | durn| | d < dS dS ) z�Set or update response cookie.
Sets new cookie or updates existent with new value.
Also updates only those params which are not None.
Nr} � Thu, 01 Jan 1970 00:00:00 GMTr~ zmax-ager� r� r� r� r� r� )rF r re �str)
rQ r� r( r} r~ r r� r� r� r� r� r� �cr' r' r+ �
set_cookie� s4
�zStreamResponse.set_cookie)r~ r� r� r� r� c C s8 | j dur | j �|d� | j|ddd|||||d� dS )zBDelete cookie.
Creates new empty expired cookie.
Nr` r r� )r r} r~ r� r� r� r� )rF �popr� )rQ r� r~ r� r� r� r� r' r' r+ �
del_cookie s
�zStreamResponse.del_cookiec � t � jS rS )�super�content_lengthrT �� __class__r' r+ r� 3 � z StreamResponse.content_lengthc C sF |d urt |�}| jrtd��t|�| jtj< d S | j�tjd � d S )Nz<You can't set content length when chunked encoding is enable)rc r> rs r� rO r rr r� �rQ r( r' r' r+ r� 8 s �c r� rS )r� � content_typerT r� r' r+ r� D r� zStreamResponse.content_typec C s | j t|�| _| �� d S rS )r� r� �
_content_type� _generate_content_type_headerr� r' r' r+ r� I s
c r� rS )r� �charsetrT r� r' r+ r� O r� zStreamResponse.charsetc C sZ | j }|dkr td��| jd usJ �|d u r | j�dd � n t|��� | jd< | �� d S )N�application/octet-streamzYSetting charset for application/octet-stream doesn't make sense, setup content_type firstr� )r� rs �
_content_dictr� r� �lowerr� )rQ r( �ctyper' r' r+ r� T s � c C s t | j�tj��S )zuThe value of Last-Modified HTTP header, or None.
This header is represented as a `datetime` object.
)r rO re r �
LAST_MODIFIEDrT r' r' r+ �
last_modifiedc s z StreamResponse.last_modifiedc C s� |d u r| j �tjd � d S t|ttf�r't�dt� t
� |���| j tj< d S t|t j �r;t�d|�
� �| j tj< d S t|t�rH|| j tj< d S dt|�j� �}t|��)Nz%a, %d %b %Y %H:%M:%S GMTz$Unsupported type for last_modified: )rO r� r r� rw rc �float�time�strftime�gmtime�math�ceil�datetime� utctimetupler� �typer7 � TypeError)rQ r( �msgr' r' r+ r� k s � �
c C sZ | j �tj�}|s d S |tkrttd�S t�|�}|s d S |�dd�\}}tt |�|d�S )Nr: r � )�is_weakr( )
rO re r �ETAGr r r � fullmatch�grouprx )rQ Z quoted_value�matchr� r( r' r' r+ �etag s
�zStreamResponse.etagc C s� |d u r| j �tjd � d S t|t�r|tks!t|t�r)|jtkr)t| j tj< d S t|t�r>t |� d|� d�| j tj< d S t|t�rgt|jt�rgt |j� |j
rXd|j� d�nd|j� d�}|| j tj< d S t dt |�� d���)N�"zW/"zUnsupported etag type: z . etag must be str, ETag or None)
rO r� r r� rw r� r r r( r r� rf r� )rQ r( Z hdr_valuer' r' r+ r� � s" �
"�� CONTENT_TYPEc C s^ | j d usJ �| jd usJ �d�dd� | j �� D ��}|r%| jd | }n| j}|| j|< d S )Nz; c s s" � | ] \}}|� d |� �V qdS )�=Nr' )r* �k�vr' r' r+ � <genexpr>� s � z?StreamResponse._generate_content_type_header.<locals>.<genexpr>)r� r� �join�itemsrO )rQ r� �paramsr� r' r' r+ r� � s z,StreamResponse._generate_content_type_headerr; c � sR �|t ju rd S | jd usJ �|j| jtj< | j�|j| j� | j� tj
d � d S rS ) r- r6 rC r( rO r �CONTENT_ENCODINGry r@ Zpopallrr )rQ r; r' r' r+ �_do_start_compression� s �
�z$StreamResponse._do_start_compression�requestc � sf �| j r| �| j �I d H d S |j�tjd��� }t�� D ]\}}||v r0| �|�I d H d S q d S )Nr` ) rA r� rK re r ZACCEPT_ENCODINGr� �CONTENT_CODINGSr� )rQ r� Zaccept_encodingr( r; r' r' r+ �_start_compression� s ���z!StreamResponse._start_compressionc � s< �| j rd S | jd ur| jS t|j| j�| _| �|�I d H S rS )rD rC r �methodrI rE �_start)rQ r� r' r' r+ �prepare� s �
zStreamResponse.preparec � sD �|| _ |j }| _| �� I d H |�| �I d H | �� I d H |S rS )rB rC �_prepare_headersZ
_prepare_hook�_write_headers)rQ r� �writerr' r' r+ r� � s � zStreamResponse._startc � s� �| j }|d us
J �| j}|d usJ �| j}|d u r |j}|| _|j}| j}| jrB| j�� D ]}|jdd�dd � }|� t
j |� q.| j rM| �
|�I d H | jro|tkrbtd|jj� d|jj� ���| jsn|�� d|t
j< n"| jr�| j|_|jd u r�|tkr�| js�|�� d|t
j< n| js�d}| jr�t
j|v r�t|j| j �r�|t
j= t
j|v r�|t
j= n| jr�|jn| jdkr�|� t
j d � |� t
j t � � |� t
j!t"� t
j#|vr�|r�|t$kr�d
|t
j#< d S d S |tkr�d |t
j#< d S d S d S ) Nr` )�headerr z-Using chunked encoding is forbidden for HTTP/�.r[ Fr r� z
keep-alive�close)%rB rC r= rh r� rO rF �values�output�addr Z
SET_COOKIEr? r� r> r" rs �major�minorrE Zenable_chunkingZTRANSFER_ENCODING�
_length_checkr� �lengthrr r r� rI �
setdefaultr� ZDATEr ZSERVERr Z
CONNECTIONr! )rQ r� r� rh r� rK Zcookier( r' r' r+ r� � sz � ���
�
� �
�
��z StreamResponse._prepare_headersc � s~ �| j }|d us
J �| j}|d usJ �|j}d|d � d|d � d| j� d| j� �}|�|| j�I d H | jr=|�� d S d S )NzHTTP/r r� r � ) rB rC r� rY r] Z
write_headersrO �_send_headers_immediatelyZ send_headers)rQ r� r� r� Z status_liner' r' r+ r� s � ( �z StreamResponse._write_headers�datac � sX �t |tttf�sJ dt|� ��| jrtd��| jd u r!td��| j�|�I d H d S )N�#data argument must be byte-ish (%r)z%Cannot call write() after write_eof()z$Cannot call write() before prepare()) rw �bytes� bytearray�
memoryviewr� rD rs rC �write�rQ r� r' r' r+ r� ( s �
�
�
zStreamResponse.writec � sF �| j rJ d��| jd usJ d��tjdtdd� | j�� I d H d S )NzEOF has already been sent� Response has not been startedz2drain method is deprecated, use await resp.write()r� )�
stacklevel)rD rC rm rn ro �drainrT r' r' r+ r� 4 s ��zStreamResponse.drain� c � sp �t |tttf�sJ dt|� ��| jrd S | jd us J d��| j�|�I d H d| _d | _| jj | _
d | _d S )Nr� r� T) rw r� r� r� r� rD rC � write_eofrB Z output_sizerk r� r' r' r+ r� > s �
�
�
zStreamResponse.write_eofc C s\ | j rd}n| jr | jd usJ �| jj� d| jj� d�}nd}d| jj� d| j� d|� d�S )N�eofr� z not prepared�<�>)rD rU rB r� r� r� r7 rJ )rQ �infor' r' r+ �__repr__N s zStreamResponse.__repr__�keyc C � d S rS r' �rQ r� r' r' r+ � __getitem__X � zStreamResponse.__getitem__c C r� rS r' r� r' r' r+ r� [ r� c C s
| j | S rS �rN r� r' r' r+ r� ^ rj c C r� rS r' �rQ r� r( r' r' r+ � __setitem__a r� zStreamResponse.__setitem__c C r� rS r' r� r' r' r+ r� d r� c C sJ t |t�s |tjvr ddlm} tj�|� tjd|dd� || j |< d S )Nr )�NotAppKeyWarningz�It is recommended to use web.ResponseKey instances for keys.
https://docs.aiohttp.org/en/stable/web_advanced.html#response-s-storager� )�categoryr� )
rw r r. rG Zweb_exceptionsr� r� rm rn rN )rQ r� r( r� r' r' r+ r� g s �
�c C s | j |= d S rS r� r� r' r' r+ � __delitem__y � zStreamResponse.__delitem__c C �
t | j�S rS )�lenrN rT r' r' r+ �__len__| rj zStreamResponse.__len__c C r� rS )�iterrN rT r' r' r+ �__iter__ rj zStreamResponse.__iter__c C s t t| ��S rS )�hash�idrT r' r' r+ �__hash__� r� zStreamResponse.__hash__�otherc C s | |u S rS r' )rQ r� r' r' r+ �__eq__� s zStreamResponse.__eq__c C s dS )NTr' rT r' r' r+ �__bool__� r� zStreamResponse.__bool__)rM rV rS )rM N)NN)rM rz )r� r2 rM N�r� )[r7 r8 r9 r� r� r# �__annotations__r� r< r= rx r> r? r@ rc rA r- rB r rC r rD rE rk rF r r� �setrG r� r& r
rR �propertyrU rW rI r[ r\ rJ r_ rP rh ri rl rp rt ry rK r{ r� r� r� �setterr� r� r� r� r� r r� r r� r r� r� r� r� r� r� r� r� r� r� r� r� r r r3 r� r r� r� r� r r� r� �objectr� r� �
__classcell__r' r' r� r+ r. M sp
����
�
� ���
�
�
��
�
�����
�� �
� � �
�
�9�������
� � � ��
�
A
r. c sd e Zd ZU dZedB ed< dZdddddddedd� dede de
dB d e
dB d
e dB d e
dB d e
dB d
e de dB ddf� fdd�Z
edeeB eB dB fdd��Zejdeddfdd��Zede
dB fdd��Zejd e
ddfdd��Zede dB fdd��Zejde dB ddfdd��Zd'd eddf� fd d �
Zd d!def� fd"d#� Zd$eddf� fd%d&� Z� ZS )(r/ N�_compressed_bodyFrH ) �bodyrI rJ �textrK r� r� �zlib_executor_size�
zlib_executorr rI rJ r rK r� r� r r rM c sB |d ur |d ur t d��|d u rt� }
nt|�}
|d ur$d|v r$t d��|d ur`tj|
v r6|s1|r5t d��nOt|t�sCtdt|� ��|d u rId}|d u rOd}|d | |
tj< |�|�}d }n%tj|
v rr|d usm|d urqt d��n|d ur�|d ur�|d| 7 }||
tj< t � j
|||
d � |d ur�|| _ n|| _ || _
| | _d S )
Nz&body and text are not allowed togetherr� z,charset must not be in content_type argumentzPpassing both Content-Type header and content_type or charset params is forbidden� text argument must be str (%r)�
text/plain�utf-8z
; charset=)rI rJ rL )rf r
r r� rw r� r� r� �encoder� rR r r �_zlib_executor_size�_zlib_executor) rQ r rI rJ r rK r� r� r r Z real_headersr� r' r+ rR � sN
��
��
zResponse.__init__c C rX rS )r< rT r' r' r+ r � rZ z
Response.bodyc C s� |d u rd | _ nJt|ttf�r|| _ n?z tj�|� | _ }W n tjy. tdt |� ��w | j
}t j |vr=|j
|t j < |jrR|j�� D ] \}}||vrQ|||< qEd | _d S )NzUnsupported body type %r)r< rw r� r� r ZPAYLOAD_REGISTRYre � LookupErrorrf r� rO r r� r� rK r� r )rQ r rK r� r( r' r' r+ r � s$ �
�
c C s | j d u rd S | j �| jpd�S )Nr )r< �decoder� rT r' r' r+ r � s
z
Response.textc C sZ |d u st |t�sJ dt|� ��| jdkrd| _| jd u r!d| _|�| j�| _d | _d S )Nr r� r r )rw r� r� r� r� r r< r )rQ r r' r' r+ r � s
�
�
c C sb | j rd S tj| jv rt| jtj �S | jd ur t| j�S t| jt �r%d S | jd ur/t| j�S dS )Nr )
r> r rr rO rc r r� rw r< r# rT r' r' r+ r� s
zResponse.content_lengthr( c C s t d��)Nz#Content length is set automatically)rs r� r' r' r+ r� s r� r� c � s� �| j rd S | jd u r| j}n| j}|rJ d|����| jd us"J �| jd us)J �|d u s0| jr:t� �� I d H d S t| jt �rhz| j�
| j�I d H W | j� � I d H n | j� � I d H w t� �� I d H d S t� �t t
|��I d H d S )Nz data arg is not supported, got )rD r r< rB rC rE r� r� rw r# r� r� r r� )rQ r� r r� r' r+ r� s" �
$ zResponse.write_eofr� r2 c � s� �t j| jv rt|j| j�r| jt j= n;| jsOt| jt �r.| jj
}d ur-t |�| jt j< n!| jr6t | j�nd}|dksG| jdkrO|jt j
vrOt |�| jt j< t� �|�I d H S )N�0i0 )r rr rO r r� rI r> rw r< r# �sizer� r� Z
METH_HEAD_ALLr� r� )rQ r� r Zbody_lenr� r' r+ r� 3 s �
� �zResponse._startr; c � s� �| j s
t| jt�rt� �|�I d H S |tju rd S t|j | j
| j d�}| jd us+J �|� | j�I d H |�
� | _|j | jtj< tt| j��| jtj< d S )N)�encodingZmax_sync_chunk_size�executor)r> rw r< r# r� r� r- r6 r r( r r
�compress�flushr rO r r� r� r� rr )rQ r; Z
compressorr� r' r+ r� E s �
��z Response._do_start_compressionr� )r7 r8 r9 r r� r� r� r r rc r� r& r rR r� r� r# r r� r r� r� r r� r- r� r� r' r' r� r+ r/ � s`
������� �
� � �A
r/ rH zapplication/json)r r rI rJ rK r� �dumpsr� r r rI rJ rK r� r rM c C s4 | t ur|s|r td��|| �}t||||||d�S )Nz3only one of data, text, or body should be specified)r r rI rJ rK r� �r rf r/ )r� r r rI rJ rK r� r r' r' r+ r0 Y s �r0 �r rI rJ rK r� c C s2 | t ur|dur td��|| �}t|||||d�S )z�Create a JSON response using a bytes-returning encoder.
Use this when your JSON encoder (like orjson) returns bytes
instead of str, avoiding the encode/decode overhead.
Nz,only one of data or body should be specifiedr r )r� r r rI rJ rK r� r' r' r+ r1 s s �r1 )HZasyncio�collections.abc� collectionsr� �enum�jsonr� r� rm r r �concurrent.futuresr �httpr Z http.cookiesr �typingr r r r
r r Z multidictr
r r` r r �abcr Zcompression_utilsr r Zhelpersr r r r r r r r r r r r r! r" r# Ztypedefsr$ r% r& rd �__all__Z web_requestr2 r� Z BaseClassr3 �Enumr- r� r. r/ r r� rc r0 r1 r' r' r' r+ �<module> s� 4
" C O��������� �
���������� �