o
    ¨Ýj^  ã                   @  s´  d Z ddlmZ ddlZddlZddlZddlmZmZ ddl	m
Z
 ddlmZmZ er8ddlmZ dd	lmZ d
d„ edƒD ƒZG dd„ dƒZG dd„ dƒZdZdZdZdZdZeZdZdZdZdZdZ dZ!dZ"G dd„ de
ƒZ#G dd„ de
ƒZ$e$j%e$j&e$j'fZ(dZ)dZ*d Z+d!Z,d"Z-d#Z.d$Z/d$Z0e 1d%d¡Z2G d&d'„ d'e3ƒZ4G d(d)„ d)eƒZ5G d*d+„ d+eƒZ6G d,d-„ d-eƒZ7d=d3d4„Z8G d5d6„ d6ƒZ9G d7d8„ d8ƒZ:G d9d:„ d:ƒZ;G d;d<„ d<ƒZ<dS )>zY
wsproto/frame_protocol
~~~~~~~~~~~~~~~~~~~~~~

WebSocket frame protocol implementation.
é    )ÚannotationsN)ÚIncrementalDecoderÚgetincrementaldecoder)ÚIntEnum)ÚTYPE_CHECKINGÚ
NamedTuple)Ú	Generatoré   )Ú	Extensionc                   s&   g | ]‰ t ‡ fd d„tdƒD ƒƒ‘qS )c                 3  s   � | ]}|ˆ A V  qd S ©N© )Ú.0Úa©Úbr   úQ/var/www/html/chatgpt/venv/lib/python3.10/site-packages/wsproto/frame_protocol.pyÚ	<genexpr>   ó   € z<listcomp>.<genexpr>é   )ÚbytesÚrange)r   r   r   r   Ú
<listcomp>   s   & r   r   c                   @  s    e Zd Zddd„Zdd	d
„ZdS )ÚXorMaskerSimpleÚmasking_keyúbytearray | bytesÚreturnÚNonec                 C  s
   || _ d S r   )Ú_masking_key)Úselfr   r   r   r   Ú__init__   ó   
zXorMaskerSimple.__init__ÚdataÚ	bytearrayc                 C  sÒ   t |ƒ}|rg|}dd„ | jD ƒ\}}}}|d d d…  |¡|d d d…< |dd d…  |¡|dd d…< |dd d…  |¡|dd d…< |dd d…  |¡|dd d…< t|ƒd }| j|d … | jd |…  | _|S |S )Nc                 s  s   � | ]}t | V  qd S r   )Ú
_XOR_TABLE)r   Únr   r   r   r   !   r   z*XorMaskerSimple.process.<locals>.<genexpr>é   r	   é   é   )r"   r   Ú	translateÚlen)r   r!   Z
data_arrayr   r   ÚcÚdZkey_rotationr   r   r   Úprocess   s   ÿzXorMaskerSimple.processN)r   r   r   r   ©r!   r"   r   r"   )Ú__name__Ú
__module__Ú__qualname__r   r,   r   r   r   r   r      s    
r   c                   @  s   e Zd Zddd„ZdS )ÚXorMaskerNullr!   r"   r   c                 C  s   |S r   r   ©r   r!   r   r   r   r,   3   s   zXorMaskerNull.processNr-   )r.   r/   r0   r,   r   r   r   r   r1   2   s    r1   é~   é   é}   iÿÿ  l   ÿÿÿÿ é€   é@   é    é   é   c                   @  s2   e Zd ZdZdZdZdZdZdZdZ	dd
d„Z
dS )ÚOpcodez7
    RFC 6455, Section 5.2 - Base Framing Protocol
    r   r	   r&   é   é	   é
   r   Úboolc                 C  s   t | d@ ƒS )Nr<   )r?   ©r   r   r   r   Ú	iscontrold   s   zOpcode.iscontrolN©r   r?   )r.   r/   r0   Ú__doc__ÚCONTINUATIONÚTEXTÚBINARYÚCLOSEÚPINGÚPONGrA   r   r   r   r   r;   M   s    r;   c                   @  sH   e Zd ZdZdZdZdZdZdZdZ	dZ
d	Zd
ZdZdZdZdZdZdS )ÚCloseReasonz8
    RFC 6455, Section 7.4.1 - Defined Status Codes
    éè  ié  iê  ië  ií  iî  iï  ið  iñ  iò  ió  iô  iõ  i÷  N)r.   r/   r0   rC   ÚNORMAL_CLOSUREZ
GOING_AWAYÚPROTOCOL_ERRORZUNSUPPORTED_DATAÚNO_STATUS_RCVDÚABNORMAL_CLOSUREÚINVALID_FRAME_PAYLOAD_DATAZPOLICY_VIOLATIONZMESSAGE_TOO_BIGZMANDATORY_EXTÚINTERNAL_ERRORZSERVICE_RESTARTZTRY_AGAIN_LATERÚTLS_HANDSHAKE_FAILEDr   r   r   r   rJ   h   s     		rJ   rK   i·  i¸  iŸ  i   i‡  z!Ic                      s$   e Zd Zejfd	‡ fdd„Z‡  ZS )
ÚParseFailedÚmsgÚstrÚcoderJ   r   r   c                   s   t ƒ  |¡ || _d S r   )Úsuperr   rV   )r   rT   rV   ©Ú	__class__r   r   r   Ö   s   
zParseFailed.__init__)rT   rU   rV   rJ   r   r   )r.   r/   r0   rJ   rM   r   Ú__classcell__r   r   rX   r   rS   Õ   s    ÿrS   c                   @  s&   e Zd ZU ded< ded< ded< dS )ÚRsvBitsr?   Úrsv1Úrsv2Úrsv3N©r.   r/   r0   Ú__annotations__r   r   r   r   r[   Ý   s   
 r[   c                   @  s6   e Zd ZU ded< ded< ded< ded< d	ed
< dS )ÚHeaderr?   Úfinr[   Úrsvr;   ÚopcodeÚintÚpayload_lenúbytes | Noner   Nr_   r   r   r   r   ra   ã   s   
 ra   c                   @  s.   e Zd ZU ded< ded< ded< ded< dS )	ÚFramer;   rd   zbytes | str | tuple[int, str]Úpayloadr?   Úframe_finishedÚmessage_finishedNr_   r   r   r   r   rh   ë   s
   
 rh   r!   r   Únbytesre   r   c                 C  s0   t | ƒ|kr| S | d |… } | jddd� d¡S )Núutf-8Úignore)Úerrors)r)   ÚdecodeÚencode)r!   rl   r   r   r   Ú_truncate_utf8ò   s   rr   c                   @  sT   e Zd Zdddd„Zdd
d„Zddd„Zddd„Zddd„Zddd„Zd dd„Z	dS )!ÚBufferNÚinitial_bytesrg   r   r   c                 C  s$   t ƒ | _d| _|r|  |¡ d S d S ©Nr   )r"   ÚbufferÚ
bytes_usedÚfeed)r   rt   r   r   r   r     s
   ÿzBuffer.__init__Ú	new_bytesr   c                 C  s   |  j |7  _ d S r   )rv   )r   ry   r   r   r   rx     s   zBuffer.feedrl   re   r"   c                 C  s6   |st ƒ S | j| j| j| … }|  jt|ƒ7  _|S r   )r"   rv   rw   r)   )r   rl   r!   r   r   r   Úconsume_at_most  s
   zBuffer.consume_at_mostúbytearray | Nonec                 C  s"   t | jƒ| j |k rd S |  |¡S r   )r)   rv   rw   rz   )r   rl   r   r   r   Úconsume_exactly  s   
zBuffer.consume_exactlyc                 C  s   | j d | j…= d| _d S ru   )rv   rw   r@   r   r   r   Úcommit  s   
zBuffer.commitc                 C  s
   d| _ d S ru   )rw   r@   r   r   r   Úrollback  r    zBuffer.rollbackc                 C  s
   t | jƒS r   )r)   rv   r@   r   r   r   Ú__len__!  r    zBuffer.__len__r   )rt   rg   r   r   )ry   r   r   r   )rl   re   r   r"   )rl   re   r   r{   ©r   r   )r   re   )
r.   r/   r0   r   rx   rz   r|   r}   r~   r   r   r   r   r   rs     s    




rs   c                   @  s    e Zd Zd
dd„Zddd„Zd	S )ÚMessageDecoderr   r   c                 C  s   d | _ d | _d S r   )rd   Údecoderr@   r   r   r   r   &  s   
zMessageDecoder.__init__Úframerh   c              
   C  s  |j  ¡ rJ ‚| j d u r|j tju rd}t|ƒ‚|j | _ n|j tjur-d|j ›�}t|ƒ‚|j tju r9tdƒƒ | _|jo>|j	}| jd u rH|j
}n)t|j
ttfƒsRJ ‚z
| j |j
|¡}W n typ } ztt|ƒtjƒ‚d }~ww t| j ||j|ƒ}|r‚d | _ d | _|S )Nzunexpected CONTINUATIONzexpected CONTINUATION, got rm   )rd   rA   r;   rD   rS   rE   r   r‚   rj   rk   ri   Ú
isinstancer   r"   rp   ÚUnicodeDecodeErrorrU   rJ   rP   rh   )r   rƒ   rT   Úfinishedr!   Úexcr   r   r   Úprocess_frame*  s4   


€ÿzMessageDecoder.process_frameNr€   ©rƒ   rh   r   rh   )r.   r/   r0   r   rˆ   r   r   r   r   r�   %  s    
r�   c                   @  sL   e Zd Z	dddd	„Zd dd„Zd!dd„Zd"dd„Zd#dd„Zd$dd„ZdS )%ÚFrameDecoderNÚclientr?   Ú
extensionsúlist[Extension] | Noner   r   c                 C  s:   || _ |pg | _tƒ | _d | _d | _d | _d| _d| _d S ru   )	r‹   rŒ   rs   rv   ÚheaderÚeffective_opcodeÚmaskerÚpayload_requiredÚpayload_consumed©r   r‹   rŒ   r   r   r   r   N  s   

zFrameDecoder.__init__r!   r   c                 C  ó   | j  |¡ d S r   )rv   rx   r2   r   r   r   Úreceive_bytes\  ó   zFrameDecoder.receive_bytesúFrame | Nonec           
      C  s„  | j s	|  ¡ s	d S | j d usJ ‚| jd usJ ‚| jd usJ ‚t| jƒ| jk r(d S | j j| j }| j 	|¡}|s?| j jdkr?d S | j 
¡  |  jt|ƒ7  _| j| j jk}| j |¡}| jD ]}| | t|ƒ¡}t|tƒrsd}t||ƒ‚t|ƒ}q]|r£tƒ }| jD ]}| | | j j¡}t|tƒr–d}t||ƒ‚|d urž||7 }q€||7 }t| jt|ƒ|| j jƒ}	|r¼d | _ d | _d | _|	S tj| _|	S )Nr   úerror in extension)rŽ   Úparse_headerr�   r�   r)   rv   r‘   rf   r’   rz   r}   r,   rŒ   Zframe_inbound_payload_datar   r„   rJ   rS   r"   Zframe_inbound_completerb   rh   r;   rD   )
r   Zpayload_remainingri   r†   Ú	extensionZpayload_rT   ÚfinalÚresultrƒ   r   r   r   Úprocess_buffer_  sP   







€þzFrameDecoder.process_bufferc           
      C  s²  | j  d¡}|d u r| j  ¡  dS t|d t@ ƒ}tt|d t@ ƒt|d t@ ƒt|d t@ ƒƒ}|d t	@ }zt
|ƒ}W n tyN   d|d›�}t|ƒ‚w | ¡ r[|s[d}t|ƒ‚t|d t@ ƒ}|d t@ }|  ||¡}|d u rz| j  ¡  dS |  |||¡ |rŒ| jrŒd}t|ƒ‚|s—| js—d	}t|ƒ‚|r°| j  d
¡}	|	d u rª| j  ¡  dS t|	ƒ| _ntƒ | _| j  ¡  t||||d ƒ| _| jj| _| jj ¡ rÑ|| _nd| _d| _dS )Nr&   Fr   zInvalid opcode z#xz)Invalid attempt to fragment control framer	   z'client received unexpected masked framez)server received unexpected unmasked framer%   T)rv   r|   r~   r?   ÚFIN_MASKr[   Ú	RSV1_MASKÚ	RSV2_MASKÚ	RSV3_MASKÚOPCODE_MASKr;   Ú
ValueErrorrS   rA   Ú	MASK_MASKÚPAYLOAD_LEN_MASKÚparse_extended_payload_lengthÚextension_processingr‹   r   r�   r1   r}   ra   rŽ   rd   r�   r‘   r’   )
r   r!   rb   rc   rd   rT   Zhas_maskZpayload_len_shortrf   r   r   r   r   r™   ’  s`   
ýþ





zFrameDecoder.parse_headerrd   r;   rf   re   ú
int | Nonec                 C  s¼   |  ¡ r|tkrd}t|ƒ‚|tkr1| j d¡}|d u rd S t d|¡\}|tkr/d}t|ƒ‚|S |tkr\| j d¡}|d u rAd S t d|¡\}|t	krRd}t|ƒ‚|d? r\d	}t|ƒ‚|S )
Nz$Control frame with payload len > 125r&   ú!Hz6Payload length used 2 bytes when 1 would have sufficedr<   ú!Qz6Payload length used 8 bytes when 2 would have sufficedé?   z'8-byte payload length with non-zero MSB)
rA   ÚMAX_PAYLOAD_NORMALrS   ÚPAYLOAD_LENGTH_TWO_BYTErv   r|   ÚstructÚunpackÚPAYLOAD_LENGTH_EIGHT_BYTEÚMAX_PAYLOAD_TWO_BYTE)r   rd   rf   rT   r!   r   r   r   r¦   Ë  s8   ÿðÿz*FrameDecoder.parse_extended_payload_lengthrc   r[   c                 C  s†   g d¢}| j D ]%}| | |||¡}t|tƒrd}t||ƒ‚t|ƒD ]
\}}	|	r+d||< q!qt||ƒD ]\}
}|r@|
s@d}t|ƒ‚q2d S )N)FFFr˜   TzReserved bit set unexpectedly)rŒ   Zframe_inbound_headerr„   rJ   rS   Ú	enumerateÚzip)r   rd   rc   rf   Zrsv_usedrš   rœ   rT   ÚbitÚusedÚexpectedÚfoundr   r   r   r§   í  s"   


€þ€ýz!FrameDecoder.extension_processingr   )r‹   r?   rŒ   r�   r   r   ©r!   r   r   r   )r   r—   rB   )rd   r;   rf   re   r   r¨   )rd   r;   rc   r[   rf   re   r   r   )	r.   r/   r0   r   r•   r�   r™   r¦   r§   r   r   r   r   rŠ   M  s    ÿ


3
9"rŠ   c                   @  sˆ   e Zd Zd4dd„Zd5dd„Zd6dd„Zd7dd„Zd8dd„Zd9d:dd„Zd;d<d!d"„Z	d;d<d#d$„Z
	%d=d>d(d)„Zd?d/d0„Z	%d=d@d2d3„ZdS )AÚFrameProtocolr‹   r?   rŒ   úlist[Extension]r   r   c                 C  sB   || _ dd„ |D ƒ| _t| j | jƒ| _tƒ | _|  ¡ | _d | _d S )Nc                 S  ó   g | ]}|  ¡ r|‘qS r   ©Úenabled©r   Úextr   r   r   r     ó    z*FrameProtocol.__init__.<locals>.<listcomp>)	r‹   rŒ   rŠ   Ú_frame_decoderr�   Ú_message_decoderÚ_parse_more_genÚ_parse_moreÚ_outbound_opcoder“   r   r   r   r      s   

zFrameProtocol.__init__rƒ   rh   c              
   C  s6  |j }t|ttfƒsJ ‚|stjdf}n}t|ƒdkr d}t|ƒ‚t 	d|d d… ¡\}|t
k s3|tkr9d}t|ƒ‚t t¡� t|ƒ}W d   ƒ n1 sMw   Y  |tv r\d}t|ƒ‚t|tƒsk|tkrkd}t|ƒ‚z|dd …  d	¡}W n tyŒ } z
td
t|ƒ tjƒ‚d }~ww ||f}t|j||j|jƒS )NÚ r	   zCLOSE with 1 byte payloadr©   r&   zCLOSE with invalid codez#remote CLOSE with local-only reasonz CLOSE with unknown reserved coderm   zError decoding CLOSE reason: )ri   r„   r   r"   rJ   rN   r)   rS   r®   r¯   ÚMIN_CLOSE_REASONÚMAX_CLOSE_REASONÚ
contextlibÚsuppressr£   ÚLOCAL_ONLY_CLOSE_REASONSÚMAX_PROTOCOL_CLOSE_REASONrp   r…   rU   rP   rh   rd   rj   rk   )r   rƒ   r!   rT   rV   Úreasonr‡   r   r   r   Ú_process_close  s>   
ÿ
þ€ÿzFrameProtocol._process_closeú#Generator[Frame | None, None, None]c                 c  sr   � dd„ | j D ƒ| _ d}|s7| j ¡ }|d ur0|j ¡ s#| j |¡}n|jtjkr0|  	|¡}d}|V  |rd S d S )Nc                 S  r»   r   r¼   r¾   r   r   r   r   4  rÀ   z1FrameProtocol._parse_more_gen.<locals>.<listcomp>FT)
rŒ   rÁ   r�   rd   rA   rÂ   rˆ   r;   rG   rÎ   )r   Úclosedrƒ   r   r   r   rÃ   .  s   €


özFrameProtocol._parse_more_genr!   r   c                 C  r”   r   )rÁ   r•   r2   r   r   r   r•   C  r–   zFrameProtocol.receive_bytesúGenerator[Frame, None, None]c                 c  s&   � | j D ]}|d u r d S |V  qd S r   )rÄ   )r   Úeventr   r   r   Úreceived_framesF  s   €
üzFrameProtocol.received_framesNrV   r¨   rÍ   ú
str | Noner"   c                 C  s„   t ƒ }|tju r
d }|d u r|rd}t|ƒ‚|tv rtj}|d ur;|t t d|¡ƒ7 }|d ur;|t| 	d¡t
d ƒ7 }|  tj|¡S )Nz&cannot specify a reason without a coder©   rm   r&   )r"   rJ   rN   Ú	TypeErrorrË   rL   r®   Úpackrr   rq   r¬   Ú_serialize_framer;   rG   )r   rV   rÍ   ri   rT   r   r   r   ÚcloseM  s   
ÿzFrameProtocol.closeó    ri   c                 C  ó   |   tj|¡S r   )r×   r;   rH   ©r   ri   r   r   r   Úping_  ó   zFrameProtocol.pingc                 C  rÚ   r   )r×   r;   rI   rÛ   r   r   r   Úpongb  rÝ   zFrameProtocol.pongTúbytes | bytearray | strrb   c                 C  s†   t |tttfƒrtj}nt |tƒrtj}| d¡}nd}t	|ƒ‚| j
d u r)|| _
n| j
|ur4d}t	|ƒ‚tj}|r<d | _
|  |||¡S )Nrm   zMust provide bytes or textz!Data type mismatch inside message)r„   r   r"   Ú
memoryviewr;   rF   rU   rE   rq   rÕ   rÅ   rD   r×   )r   ri   rb   rd   rT   r   r   r   Ú	send_datae  s    


zFrameProtocol.send_datarc   r[   rd   r;   re   c                 C  sJ   t |ƒd> }t |jƒd> t |jƒd>  t |jƒd>  }t |ƒ}||B |B S )Né   é   é   r%   )re   r\   r]   r^   )r   rb   rc   rd   Zfin_bitsZrsv_bitsZopcode_bitsr   r   r   Ú_make_fin_rsv_opcode~  s   *z"FrameProtocol._make_fin_rsv_opcodeúbytes | bytearrayc                 C  s.  t |ƒ}tdddƒ}t| jƒD ]}| | ||t|ƒ|¡\}}q|  |||¡}t|ƒ}d}|tkr5|}	d }
n|t	kr>t
}	|}
nt}	|}
d}| jrK|	dO }	t ||	gƒ}|
d urv| ¡ r_d}t|ƒ‚|rl|t t d|
¡ƒ7 }n
|t t d|
¡ƒ7 }| jr‘t t d¡ƒ}t|ƒ}t || | t |ƒ¡ ƒS t || ƒS )NFTr6   z"payload too long for control framerª   r©   r%   )r"   r[   ÚreversedrŒ   Zframe_outboundr   rå   r)   r¬   r±   r­   r°   r‹   rA   r£   r®   rÖ   ÚosÚurandomr   r,   )r   rd   ri   rb   rc   rš   Zfin_rsv_opcodeZpayload_lengthZquad_payloadZfirst_payloadZsecond_payloadrŽ   rT   r   r�   r   r   r   r×   …  s>   zFrameProtocol._serialize_frame)r‹   r?   rŒ   rº   r   r   r‰   )r   rÏ   r¸   )r   rÑ   )NN)rV   r¨   rÍ   rÔ   r   r"   )rÙ   )ri   r   r   r"   )rÙ   T)ri   rß   rb   r?   r   r"   )rb   r?   rc   r[   rd   r;   r   re   )rd   r;   ri   ræ   rb   r?   r   r"   )r.   r/   r0   r   rÎ   rÃ   r•   rÓ   rØ   rÜ   rÞ   rá   rå   r×   r   r   r   r   r¹   ÿ  s    


#

ÿ
ÿr¹   )r!   r   rl   re   r   r   )=rC   Ú
__future__r   rÉ   rè   r®   Úcodecsr   r   Úenumr   Útypingr   r   Úcollections.abcr   rŒ   r
   r   r#   r   r1   r­   r°   r¬   r±   ZMAX_PAYLOAD_EIGHT_BYTEZMAX_FRAME_PAYLOADr¤   r¥   rž   rŸ   r    r¡   r¢   r;   rJ   rN   rO   rR   rË   rÇ   ZMIN_PROTOCOL_CLOSE_REASONrÌ   ZMIN_LIBRARY_CLOSE_REASONZMAX_LIBRARY_CLOSE_REASONZMIN_PRIVATE_CLOSE_REASONZMAX_PRIVATE_CLOSE_REASONrÈ   rÖ   Z	NULL_MASKÚ	ExceptionrS   r[   ra   rh   rr   rs   r�   rŠ   r¹   r   r   r   r   Ú<module>   sh    Yý
$( 3