codekingpro/portable-devtools
114k
1�
2 p�jkW � � � S SK Jr S SKrS SKrS SKrS SKrS SKrS SKrS SK J3r4J r S SK J
r
JrJr SSKJrJr SSKJrJrJrJrJrJrJr SSKJ r J r SS K J r J r J!r!J"r"J#r# SS5K$J%r%J&r& SS K'J(r( SS K)J*r*J+r+J,r,J-r-J.r. SS
K J/r/J0r0J1r1J2r2J3r3J4r4J5r5 SSK6J7r7 S/r8 " S S\-5 r9 " S S\95 r:\(" \;" 5 SSSSSS.S9 g)� )� annotationsN)� Generator�Sequence)�Any�Callable�cast� )�Headers�MultipleValuesError)�InvalidHandshake�
InvalidHeader�InvalidHeaderValue�InvalidMessage�
InvalidOrigin�InvalidUpgrade�NegotiationError)� Extension�ServerExtensionFactory)�build_extension�parse_connection�parse_extension�parse_subprotocol�
parse_upgrade)�Request�Response)� lazy_import)�6CONNECTING�OPEN�SERVER�Protocol�State)�ConnectionOption�ExtensionHeader�7LoggerLike�Origin�8StatusLike� Subprotocol�UpgradeProtocol)�9accept_key�ServerProtocolc �� ^ � \ rS rSrSrSSSS\SSS. SU 4S jjjrSS jr SS jrSS jr SS10 jr11SS jr SS jr SS
jr
SS jrSU 4S jjrSrU =r$ )r* �0 a� 12Sans-I/O implementation of a WebSocket server connection.13 14Args:15 origins: Acceptable values of the ``Origin`` header. Values can be16 :class:`str` to test for an exact match or regular expressions17 compiled by :func:`re.compile` to test against a pattern. Include18 :obj:`None` in the list if the lack of an origin is acceptable.19 This is useful for defending against Cross-Site WebSocket20 Hijacking attacks.21 extensions: List of supported extensions, in order in which they22 should be tried.23 subprotocols: List of supported subprotocols, in order of decreasing24 preference.25 select_subprotocol: Callback for selecting a subprotocol among26 those supported by the client and the server. It has the same27 signature as the :meth:`select_subprotocol` method, including a28 :class:`ServerProtocol` instance as first argument.29 state: Initial state of the WebSocket connection.30 max_size: Maximum size of incoming messages in bytes.31 :obj:`None` disables the limit. You may pass a ``(max_message_size,32 max_fragment_size)`` tuple to set different limits for messages and33 fragments when you expect long messages sent in short fragments.34 logger: Logger for this connection;35 defaults to ``logging.getLogger("websockets.server")``;36 see the :doc:`logging guide <../../topics/logging>` for details.37 38Ni )�origins�39extensions� subprotocols�select_subprotocol�state�max_size�loggerc � >� [ TU ] [ UUUS9 Xl X l X0l Ub' [
U SUR X R 5 5 g g )N)�sider1 r2 r3 r0 ) �super�__init__r r- �available_extensions�available_subprotocols�setattr�__get__� __class__) �selfr- r. r/ r0 r1 r2 r3 r< s ��WD:\code\apps\devtools\python\user_packages\Python313\site-packages\websockets/server.pyr7 �ServerProtocol.__init__N sc �� �" ����� �� � 40� � �$.�!�&2�#� � )�
��$�"�*�*�4� � �@�
� *� c � � U R U5 u nnn[+ 5 n [, R. R1 SS9U S' S U S41' S42U S' X)S' Ub X9S' Ub XIS' [3 SSU 5 $ ! [ ao nXQl XPl U R ( a U R43 R SSS9 U R
[ R R SU S35 s SnA$ SnAf[ a� nXQl XPl U R ( a U R44 R SSS9 U R
[ R R SU S35 nS UR S45' Us SnA$ SnAf[ a� nXQl XPl U R ( a U R46 R S SS9 [ [ U5 nU nUR b# UR nUS U 3-
nUR b M# U R
[ R R" SU S35 s SnA$ SnAf[$ aZ nXQl XPl U R47 R' S
SS9 U R
[ R R( S5 s SnA$ SnAff = f)a] 48Create a handshake response to accept the connection.49 50If the handshake request is valid and the handshake successful,51:meth:`accept` returns an HTTP response with status code 101.52 53Else, it returns an HTTP response with another status code. This rejects54the connection, like :meth:`reject` would.55 56You must send the handshake response with :meth:`send_response`.57 58You may modify the response before sending it, typically by adding HTTP59headers.60 61Args:62 request: WebSocket handshake request received from the client.63 64Returns:65 WebSocket handshake response or HTTP response to send to the client.66 67z! invalid originT)�exc_infoz'Failed to open a WebSocket connection: z.68Nz! invalid upgradez^.69 70You cannot access a WebSocket server directly with a browser. You need a WebSocket client.71� websocket�Upgradez! invalid handshakez; zopening handshake failedzLFailed to open a WebSocket connection.72See server log for more information.73��usegmt�Date�74ConnectionzSec-WebSocket-Accept�Sec-WebSocket-Extensions�Sec-WebSocket-Protocol�e zSwitching Protocols)�process_requestr �75_exception�
handshake_exc�debugr3 �reject�http�76HTTPStatus� FORBIDDENr �UPGRADE_REQUIRED�headersr r �
BaseException� __cause__� BAD_REQUEST� Exception�error�INTERNAL_SERVER_ERRORr77 �email�utils�78formatdater )79r= �request�
accept_header�extensions_header�protocol_header�exc�response� exc_chain�exc_strrU s80 r> �accept�ServerProtocol.acceptq sv � �,9 �81 �$�$�W�-�
� �!� �n �)�� �+�+�0�0��0�=���� (�� �� )�� � �*7�&�'� � (�2C�.� /� � &�0?�,� -��� 2�G�<�<��} � �!$� �!$� ��z�z�� � �!�!�"4�t�!�D��;�;����)�)�9�#��c�B��
�� � �!$� �!$� ��z�z�� � �!�!�"5��!�E��{�{����0�0�=�c�U� CE� F��H� +6�H� � �Y� '��O�� �
�!$� �!$� ��z�z�� � �!�!�"7�$�!�G� �]�C�0�I�"� �G��%�%�1� %� /� /� ��R� �{�+�+�� �%�%�1� �;�;����+�+�9�'��#�F��
�� � � "%� �!$� � �K�K� � � 8�4� � H��;�;����5�5�=��
��
�s] �A* �*82J�4A$C �J�
J�+A5E&� J�&
J�3A8H �--H �J�
J�-AJ�<J�Jc � � UR n[ UR S5 Vs/ s H n[ U5 PM sn/ 5 n[ S U 5 5 ( d( [ SU( a SR
U5 5 eS5 e[ UR S5 Vs/ s H n[ U5 PM sn/ 5 n[ U5 S:X a US R 5 S:X d( [ SU( a SR
U5 5 eS5 e US n [ R " UR 5 S S 9n[ U5 S
:w a [% S U5 e[' U5 n US n83U84S:w a [% SU855 eU R) U5 U l U R- U5 u o�l U R1 U5 =o�l X�U 4$ s snf s snf ! [ a
[ S 5 Se[ a [ S S865 Sef = f! [ R" a n[% S U5 UeSnAff = f! [ a
[ S5 Se[ a [ SS875 Sef = f)a� 88Check a handshake request and negotiate extensions and subprotocol.89 90This function doesn't verify that the request is an HTTP/1.1 or higher91GET request and doesn't check the ``Host`` header. These controls are92usually performed earlier in the HTTP request handling code. They're93the responsibility of the caller.94 95Args:96 request: WebSocket handshake request received from the client.97 98Returns:99 ``Sec-WebSocket-Accept``, ``Sec-WebSocket-Extensions``, and100 ``Sec-WebSocket-Protocol`` headers for the handshake response.101 102Raises:103 InvalidHandshake: If the handshake request is invalid;104 then the server must return 400 Bad Request error.105 106rH c 3 �F # � U H oR 5 S :H v � M g7f)�upgradeN)�lower)�.0�values r> � <genexpr>�1ServerProtocol.process_request.<locals>.<genexpr>� s � � �F�:�%�;�;�=�I�-�:�s � !�, NrD r r rC zSec-WebSocket-Key�multiple valuesT)�validate� zSec-WebSocket-Version�13)rU �sum�get_allr �anyr �joinr �lenrl �KeyErrorr
r �base64� b64decode�encode�binascii�Errorr r) �process_origin�origin�process_extensionsr. �process_subprotocol� subprotocol)
r= r_ rU rn �107connectionrk �key�raw_keyrc r` �versionra rb s
r> rL � ServerProtocol.process_request� sZ � �0 �/�/��-0�29�/�/�,�2O� P�2O��
�e�
$�2O� P�RT�.108�109� �F�:�F�F�F� � �z�d�i�i�110� 3��
�GK��
� *-�/6���y�/I� J�/I�e�]�5�
!�/I� J�B�*111�� �G� ��!�g�a�j�&6�&6�&8�K�&G� ��'�D�I�I�g�,>�T� T�t�T� T� R��-�.�C�112 H� �&�&�s�z�z�|�d�C�G� �w�<�2� �$�%8�#�>� >�"�3��
� V� � 5�6�G�113 �d�?�$�%<�g�F� F��)�)�'�2�� �-1�-D�-D�W�-M�*��?�-1�-E�-E�g�-N�N��*� �/�B�B��W
Q��
K�� � ?� � 3�4�$� >�"� R� � 3�5F�G�T� Q� R�� �~�~� H�$�%8�#�>�C� G�� H�� � C� � 7�8�d� B�"� V� � 7�9J�K�QU� U� V�s; �F5�F:�F? � #G/ �H �?-G,�/H�
H�H�-Ic �\ � UR S5 nUb [ [ U5 nU R114 b^ U R115 HC nX2:X d: [
U[ R 5 ( d M) Uc M. UR U5 c MB U$ [ U5 eU$ ! [ a [ SS5 Sef = f)z�116Handle the Origin HTTP request header.117 118Args:119 headers: WebSocket handshake request headers.120 121Returns:122 origin, if it is acceptable.123 124Raises:125 InvalidHandshake: If the Origin header is invalid.126 InvalidOrigin: If the origin isn't acceptable.127 128r% rr N) �getr r
r r% r- �129isinstance�re�Pattern� fullmatchr )r= rU r� �origin_or_regexs r> r� � ServerProtocol.process_origin s� � �" G� �[�[��*�F� � ��&�&�)�F� �<�<� #�#'�<�<��"�,� ���130�131�;�;� �*�'�1�1�&�9�E�� �
� $0� $�F�+�+��
�� #� G� ��*;�<�$� F� G�s �B �B+c �� � Sn/ n/ nUR S5 nU( a� U R ( a� [ U Vs/ s H n[ U5 PM sn/ 5 nU Hb u p�U R HM n132U133R U:w a M U134R X�5 u p�UR X�45 UR U 5 M` Md U( a [ U5 nX$4$ s snf ! [ a M| f = f)a� 135Handle the Sec-WebSocket-Extensions HTTP request header.136 137Accept or reject each extension proposed in the client request.138Negotiate parameters for accepted extensions.139 140Per :rfc:`6455`, negotiation rules are defined by the specification of141each extension.142 143To provide this level of flexibility, for each extension proposed by144the client, we check for a match with each extension available in the145server configuration. If no match is found, the extension is ignored.146 147If several variants of the same extension are proposed by the client,148it may be accepted several times, which won't make sense in general.149Extensions must implement their own requirements. For this purpose,150the list of previously accepted extensions is provided.151 152This process doesn't allow the server to reorder extensions. It can153only select a subset of the extensions proposed by the client.154 155Other requirements, for example related to mandatory extensions or the156order of extensions, may be implemented by overriding this method.157 158Args:159 headers: WebSocket handshake request headers.160 161Returns:162 ``Sec-WebSocket-Extensions`` HTTP response header and list of163 accepted extensions.164 165Raises:166 InvalidHandshake: If the Sec-WebSocket-Extensions header is invalid.167 168NrI ) rw r8 rv r �name�process_request_paramsr �appendr )
r= rU �response_header_value�extension_headers�accepted_extensions�
header_values� header_value�parsed_header_valuesr� �request_params� ext_factory�response_params� extensions
r> r� �!ServerProtocol.process_extensions8 s� � �N -1� �35��/1�� ���(B�C�
� �T� 6� 6�:=�CP�Q�=�<� � �.�=�Q�SU�;� � )=�$��#'�#<�#<�K�"�'�'�4�/� �!�5@�5W�5W� *�6�2�� &�,�,�d�-D�E�'�.�.�y�9� �% $=� )=�2 �$3�4E�$F� !�$�9�9��? R�� ,� !� �!�s �C�?C�169C&�%C&c � � [ UR S5 Vs/ s H n[ U5 PM sn/ 5 nU R U5 $ s snf )aA 170Handle the Sec-WebSocket-Protocol HTTP request header.171 172Args:173 headers: WebSocket handshake request headers.174 175Returns:176 Subprotocol, if one was selected; this is also the value of the177 ``Sec-WebSocket-Protocol`` response header.178 179Raises:180 InvalidHandshake: If the Sec-WebSocket-Subprotocol header is invalid.181 182rJ )rv rw r r0 )r= rU r� r/ s r> r� �"ServerProtocol.process_subprotocol� sW � � /2� %,�O�O�4L�$M�
�$M�L� "�,�/�$M�
�
� /183� � �&�&�|�4�4��
s �Ac �� � U R ( d gU( d [ S5 e[ U5 nU R H nX2; d M184 Us $ [ SSR U R 5 - 5 e)a� 185Pick a subprotocol among those offered by the client.186 187If several subprotocols are supported by both the client and the server,188pick the first one in the list declared the server.189 190If the server doesn't support any subprotocols, continue without a191subprotocol, regardless of what the client offers.192 193If the server supports at least one subprotocol and the client doesn't194offer any, abort the handshake with an HTTP 400 error.195 196You provide a ``select_subprotocol`` argument to :class:`ServerProtocol`197to override this logic. For example, you could accept the connection198even if client doesn't offer a subprotocol, rather than reject it.199 200Here's how to negotiate the ``chat`` subprotocol if the client supports201it and continue without a subprotocol otherwise::202 203 def select_subprotocol(protocol, subprotocols):204 if "chat" in subprotocols:205 return "chat"206 207Args:208 subprotocols: List of subprotocols offered by the client.209 210Returns:211 Selected subprotocol, if a common subprotocol was found.212 213 :obj:`None` to continue without a subprotocol.214 215Raises:216 NegotiationError: Custom implementations may raise this exception217 to abort the handshake with an HTTP 400 error.218 219Nzmissing subprotocolz%invalid subprotocol; expected one of rq )r9 r �setry )r= r/ �proposed_subprotocolsr� s r> r0 �!ServerProtocol.select_subprotocol� st � �R �*�*�� �"�#8�9� 9� !$�L� 1� � �6�6�K��3�"�"� 7�220 � 3��i�i��3�3�4�
5�221� 222r@ c 223 � � [ R " U5 nUR 5 n[ S[ R224 R
SS94SS[ [ U5 5 4S/5 n[ UR UR XC5 $ )a� 225Create a handshake response to reject the connection.226 227A short plain text response is the best fallback when failing to228establish a WebSocket connection.229 230You must send the handshake response with :meth:`send_response`.231 232You may modify the response before sending it, for example by changing233HTTP headers.234 235Args:236 status: HTTP status code.237 text: HTTP response body; it will be encoded to UTF-8.238 239Returns:240 HTTP response to send to the client.241 242rG TrE )rH �closezContent-Length)z Content-Typeztext/plain; charset=utf-8) rQ rR r~ r243 r\ r] r^ �strrz r rn �phrase)r= �status�text�bodyrU s r> rP �ServerProtocol.reject� su � �* � � ��(���{�{�}�������/�/�t�/�<�=�'�!�3�s�4�y�>�2�=�
�244�� �� � �f�m�m�W�C�Cr@ c �J � U R ( a� UR UR p2U R R SX#5 UR R 5 H! u pEU R R SXE5 M# UR ( a/ U R R S[ UR 5 5 U R R UR 5 5 UR S:X a< U R [ L d e[ U l U R R S5 gU R R SUR UR 5 U R 5 U R! 5 U l [% U R" 5 g)zl245Send a handshake response to the client.246 247Args:248 response: WebSocket handshake response event to send.249 250z> HTTP/1.1 %d %sz> %s: %sz> [body] (%d bytes)rK zconnection openzconnection rejected (%d %s)N)rO � status_code�
reason_phraser3 rU � raw_itemsr� rz �writesr� � serializer1 r r �info�send_eof�discard�parser�next)r= rd �coder� r� rn s r> �
send_response� ServerProtocol.send_response� s) � � �:�:�#�/�/��1G�1G�&� �K�K� � � 0�$� ?� &� .� .� 8� 8� :�251��� � �!�!�*�c�9� ;��}�}�� � �!�!�"7��X�]�]�9K�L� � � ���8�-�-�/�0� � � �3� &��:�:��+� +�+� �D�J� �K�K� � � .� /�
�K�K� � �-��$�$��&�&�
�
�M�M�O� �,�,�.�D�K� ���� r@ c # �� ># � U R [ L a� [ R " U R R252 5 S h v�N nU R ( ae U R R SWR 5 UR" R% 5 H! u p4U R R SX45 M# U R& R) W5 [* TU ]
5 S h v�N g N�! [ ai n[ S5 U l X R l U R 5 U R 5 U l [ U R 5 S v � S nAGNS nAff = f N}7f)Nz$did not receive a valid HTTP requestz< GET %s HTTP/1.1z< %s: %s)r1 r r �parse�reader� read_linerY r rN rW r� r� r� r� rO r3 �pathrU r� �eventsr� r6 )r= r_ rc r� rn r< s �r> r� �ServerProtocol.parse s253 �� � � �:�:�� #�
�%,�]�]��K�K�)�)�&� �� �z�z�� � �!�!�"5�w�|�|�D�")�/�/�";�";�"=�J�C��K�K�%�%�j�#�=� #>�
�K�K� � �w� '��7�=�?�"�"�)�� �
�%3�:�&��"� 03�"�"�,��
�
�� "�l�l�n�� ��T�[�[�!����
��" #�sN �E,�-C4 �C2�C4 �254B"E,�,E*�-E,�2C4 �4255E'�>A E"� E,�"E'�'E,) r8 r9 r. rN r� r- r� r1 r� )r- z0Sequence[Origin | re.Pattern[str] | None] | Noner. z'Sequence[ServerExtensionFactory] | Noner/ z Sequence[Subprotocol] | Noner0 zLCallable[[ServerProtocol, Sequence[Subprotocol]], Subprotocol | None] | Noner1 r! r2 z*int | None | tuple[int | None, int | None]r3 zLoggerLike | None�return�None)r_ r r� r )r_ r r� z"tuple[str, str | None, str | None])rU r256 r� z
Origin | None)rU r257 r� z"tuple[str | None, list[Extension]])rU r258 r� �Subprotocol | None)r/ zSequence[Subprotocol]r� r� )r� r& r� r� r� r )rd r r� r� )r� zGenerator[None])�__name__�259__module__� __qualname__�__firstlineno__�__doc__r r7 rg rL r� r� r� r0 rP r� r� �__static_attributes__�
__classcell__�r< s @r> r* r* 0 s� �� ��@ EI�>B�59�
�!�?D�$(� !� B�!� <� !�260 3� !�
�!� �!� =� !� "� !� 261�!!� !�FZ=�xFC��FC� 262,�FC�P!�FO:��O:� 263,�O:�b5�0:264�+�:265� 266 �:267�x D�B �D#� #r@ c �, ^ � \ rS rSrSU 4S jjrSrU =r$ )�ServerConnectioni: c �\ >� [ R " S[ 5 [ TU ] " U0 UD6 g )Nz.ServerConnection was renamed to ServerProtocol)�warnings�warn�DeprecationWarningr6 r7 )r= �args�kwargsr< s �r> r7 �ServerConnection.__init__; s) �� ��
�
� <� � 268� ���$�)�&�)r@ � )r� r r� r r� r� )r� r� r� r� r7 r� r� r� s @r> r� r� : s
�� �*� *r@ r� z.legacy.server)�WebSocketServer�WebSocketServerProtocol� broadcast�serve�269unix_serve)�deprecated_aliases)<�270__future__r r| r � email.utilsr\ rQ r� r� �collections.abcr r �typingr r r �datastructuresr271 r �272exceptionsr r
r r r r r r. r r rU r r r r r �http11r r �importsr �protocolr r r r r! r" r# r$ r% r& r' r( r] r) �__all__r* r� �globalsr� r@ r> �<module>r� s� �� "�
� � � � � � /� &� &� 8�� � � :�� � &� � ?� ?�� � � � �273 ��G#�X� G#�T*�~� *� � �I� ,�#3�%�!�&�
�274r@