codekingpro/portable-devtools
114k
1�
2 p�j�@ � �L � S SK Jr S SKrS SKrS SKrS SKrS SKJr S SKJ r J3r4J r SSK J
r
Jr SSKJrJrJrJrJrJr / SQr\5" S 5 rS6S . S-S jjrS.S
jr\R2 " S5 rS/S jr\R2 " S5 r S0S jr \R2 " S5 r \R2 " S5 r S0S jr \R2 " S5 r!\R2 " S5 r"S1S jr# S2S jr$ S3S jr%S4S jr&\R2 " S5 r' S5S jr(S6S jr) S7S jr* S8S jr+S9S jr,\,r- S:S! jr.S;S" jr/\/r0 S<S# jr1S=S$ jr2\2r3S>S% jr4\4r5S?S& jr6S@S' jr7\R2 " S(5 r8S0S) jr9SAS* jr:SBS+ jr;SCS, jr<g)D� )� annotationsN)�Sequence)�Callable�TypeVar�cast� )�InvalidHeaderFormat�InvalidHeaderValue)�ConnectionOption�ExtensionHeader�
ExtensionName�ExtensionParameter� Subprotocol�UpgradeProtocol) �7build_host�parse_connection�
parse_upgrade�parse_extension�build_extension�parse_subprotocol�build_subprotocol�validate_subprotocols� build_www_authenticate_basic�parse_authorization_basic�build_authorization_basic�TF)�always_include_portc � � [ R " U 5 nUR S:X a SU S3n U( d X( a SOS:w a U SU 3n U $ ! [ a N*f = f)z8Build a ``Host`` header.9 10� �[�]i� �P �:)� ipaddress�11ip_address�version�12ValueError)�host�port�securer �addresss �XD:\code\apps\devtools\python\user_packages\Python313\site-packages\websockets/headers.pyr r ' si � � ��&�&�t�,�� �?�?�a� ��t�f�A�;�D��d�f�s�"� =���q��� �� �K�� �
� �
�s �A � 13A�Ac �, � U[ U 5 :X a S$ X $ )z�14Return the next character from ``header`` at the given position.15 16Return :obj:`None` at the end of ``header``.17 18We never need to peek more than one character ahead.19 20N)�len)�header�poss r, �21peek_aheadr1 I s � � �#�f�+�%�4�6�6�;�6� z[\t ]*c �V � [ R X5 nUc eUR 5 $ )z�22Parse optional whitespace from ``header`` at the given position.23 24Return the new position.25 26The whitespace itself isn't returned because it isn't significant.27 28)�_OWS_re�match�end)r/ r0 r5 s r, � parse_OWSr7 X s* � �
�M�M�&� &�E� � � � � �9�9�;�r2 z [-!#$%&\'*+.^_`|~0-9a-zA-Z]+c � � [ R X5 nUc
[ USX5 eUR 5 UR 5 4$ )z�29Parse a token from ``header`` at the given position.30 31Return the token value and the new position.32 33Raises:34 InvalidHeaderFormat: On invalid inputs.35 36zexpected token)� _token_rer5 r �groupr6 �r/ r0 � header_namer5 s r, � parse_tokenr= j s> � �
�O�O�F� (�E� �}�!�+�/?��M�M� �;�;�=�%�)�)�+� %�%r2 zC"(?:[\x09\x20-\x21\x23-\x5b\x5d-\x7e]|\\[\x09\x20-\x7e\x80-\xff])*"z \\([\x09\x20-\x7e\x80-\xff])c � � [ R X5 nUc
[ USX5 e[ R SUR 5 SS 5 UR
5 4$ )z�37Parse a quoted string from ``header`` at the given position.38 39Return the unquoted value and the new position.40 41Raises:42 InvalidHeaderFormat: On invalid inputs.43 44zexpected quoted stringz\1r �����)�_quoted_string_rer5 r � _unquote_re�subr: r6 r; s r, �parse_quoted_stringrC � sR � �
� #� #�F� 0�E� �}�!�+�/G��U�U� �?�?�5�%�+�+�-��"�"5� 6�� � � � C�Cr2 z[\x09\x20-\x7e\x80-\xff]*z ([\x22\x5c])c � � [ R U 5 nUc [ S5 eS[ R SU 5 - S- $ )z\45Format ``value`` as a quoted string.46 47This is the reverse of :func:`parse_quoted_string`.48 49z-invalid characters for quoted-string encoding�"z\\\1)� _quotable_re� fullmatchr' � _quote_rerB )�valuer5 s r, �build_quoted_stringrJ � s@ � �
� "� "�5� )�E� �}��H�I�I� �� � �w��.� .�� 4�4r2 c �� � [ X5 S:X a [ XS- 5 n[ X5 S:X a M / n U " XU5 u pRUR U5 [ X5 nU[ U5 :X a Ok[ X5 S:X a [ XS- 5 nO
[ USX5 e[ X5 S:X a [ XS- 5 n[ X5 S:X a M U[ U5 :X a OM� U[ U5 :X d eU$ )a� 50Parse a comma-separated list from ``header`` at the given position.51 52This is appropriate for parsing values with the following grammar:53 54 1#item55 56``parse_item`` parses one item.57 58``header`` is assumed not to start or end with whitespace.59 60(This function is designed for parsing an entire header value and61:func:`~websockets.http.read_headers` strips whitespace from values.)62 63Return a list of items.64 65Raises:66 InvalidHeaderFormat: On invalid inputs.67 68�,r zexpected comma)r1 r7 �appendr. r )�69parse_itemr/ r0 r< �items�items r, �70parse_listrQ � s� � �> �V�71!�S�72(���a��(�� �V�73!�S�74(�
�E�75� �v�K�8� ��
� � �T����$�� �#�f�+� � � �f� "�c� )��F�!�G�,�C�%�k�3C�V�Q� Q� ��%��,��F�!�G�,�C� ��%��,� �#�f�+� � �- �4 �#�f�+� � � � �Lr2 c �B � [ XU5 u p1[ [ U5 U4$ )z�76Parse a Connection option from ``header`` at the given position.77 78Return the protocol value and the new position.79 80Raises:81 InvalidHeaderFormat: On invalid inputs.82 83)r= r r �r/ r0 r< rP s r, �parse_connection_optionrT � s% � � �F��5�I�D� � �$� '�� ,�,r2 c �& � [ [ U SS5 $ )z�84Parse a ``Connection`` header.85 86Return a list of HTTP connection options.87 88Args89 header: value of the ``Connection`` header.90 91Raises:92 InvalidHeaderFormat: On invalid inputs.93 94r �95Connection)rQ rT �r/ s r, r r � s � � �-�v�q�,� G�Gr2 z>[-!#$%&\'*+.^_`|~0-9a-zA-Z]+(?:/[-!#$%&\'*+.^_`|~0-9a-zA-Z]+)?c � � [ R X5 nUc
[ USX5 e[ [ UR 5 5 UR
5 4$ )z�96Parse an Upgrade protocol from ``header`` at the given position.97 98Return the protocol value and the new position.99 100Raises:101 InvalidHeaderFormat: On invalid inputs.102 103zexpected protocol)� _protocol_rer5 r r r r: r6 r; s r, �parse_upgrade_protocolrZ sG � �
� � �v� +�E� �}�!�+�/B�F�P�P� ����� � /����� <�<r2 c �& � [ [ U SS5 $ )z�104Parse an ``Upgrade`` header.105 106Return a list of HTTP protocols.107 108Args:109 header: Value of the ``Upgrade`` header.110 111Raises:112 InvalidHeaderFormat: On invalid inputs.113 114r �Upgrade)rQ rZ rW s r, r r s � � �,�f�a�� C�Cr2 c �4 � [ XU5 u p1[ X5 nSn[ X5 S:X aj [ XS- 5 n[ X5 S:X a4 Un[ XU5 u pA[ R U5 c
[
USX5 eO[ XU5 u pA[ X5 nX44U4$ )z�115Parse a single extension parameter from ``header`` at the given position.116 117Return a ``(name, value)`` pair and the new position.118 119Raises:120 InvalidHeaderFormat: On invalid inputs.121 122N�=r rE z invalid quoted header content)r= r7 r1 rC r9 rG r )r/ r0 r< �namerI �123pos_befores r, �parse_extension_item_paramra . s� � � �F��5�I�D�124�F�125 �C� �E��&� �#�%���a��(�� �f� "�c� )� �J�,�V�+�F�J�E� �"�"�5�)�1�)� �!@�&�� � 2�126 %�V�+�>�J�E���$�� �=�#� � r2 c �� � [ XU5 u p1[ X5 n/ n[ X5 S:X a> [ XS- 5 n[ XU5 u pQUR U5 [ X5 S:X a M> [ [ U5 U4U4$ )z�127Parse an extension definition from ``header`` at the given position.128 129Return an ``(extension name, parameters)`` pair, where ``parameters`` is a130list of ``(name, value)`` pairs, and the new position.131 132Raises:133 InvalidHeaderFormat: On invalid inputs.134 135�;r )r= r7 r1 ra rM r r
)r/ r0 r< r_ �136parameters� parameters r, �parse_extension_itemrf R s� � � �F��5�I�D�137�F�138 �C��J�139�V�140!�S�141(���a��(��3�F��M�� ����)�$� �V�142!�S�143(�
� �� %�z� 2�C� 7�7r2 c �& � [ [ U SS5 $ )a� 144Parse a ``Sec-WebSocket-Extensions`` header.145 146Return a list of WebSocket extensions and their parameters in this format::147 148 [149 (150 'extension name',151 [152 ('parameter name', 'parameter value'),153 ....154 ]155 ),156 ...157 ]158 159Parameter values are :obj:`None` when no value is provided.160 161Raises:162 InvalidHeaderFormat: On invalid inputs.163 164r zSec-WebSocket-Extensions)rQ rf rW s r, r r k s � �. �*�F�A�7Q� R�Rr2 c 165 � � SR [ [ U 5 /U V Vs/ s H u pUc U OU SU 3PM snn - 5 $ s snn f )zW166Build an extension definition.167 168This is the reverse of :func:`parse_extension_item`.169 170z; r^ )�joinr �str)r_ rd rI s r, �build_extension_itemrk � s` � � �9�9�
�c�4� �� *� 171� *� �� �M�D�$��q���'8� 8� )� 172� 173� � �� 174s �A c �2 � SR S U 5 5 $ )z`175Build a ``Sec-WebSocket-Extensions`` header.176 177This is the reverse of :func:`parse_extension`.178 179�, c 3 �< # � U H u p[ X5 v � M g 7f)N)rk )�.0r_ rd s r, � <genexpr>�"build_extension.<locals>.<genexpr>� s � � � �GQ�3C�4� �T�.�.�z�s � �ri )�180extensionss r, r r � s" � � �9�9� �GQ�� � r2 c �B � [ XU5 u p1[ [ U5 U4$ )z�181Parse a subprotocol from ``header`` at the given position.182 183Return the subprotocol value and the new position.184 185Raises:186 InvalidHeaderFormat: On invalid inputs.187 188)r= r r rS s r, �parse_subprotocol_itemru � s$ � � �F��5�I�D� � �T� "�C� '�'r2 c �& � [ [ U SS5 $ )z�189Parse a ``Sec-WebSocket-Protocol`` header.190 191Return a list of WebSocket subprotocols.192 193Raises:194 InvalidHeaderFormat: On invalid inputs.195 196r zSec-WebSocket-Protocol)rQ ru rW s r, r r � s � � �,�f�a�9Q� R�Rr2 c �$ � SR U 5 $ )z`197Build a ``Sec-WebSocket-Protocol`` header.198 199This is the reverse of :func:`parse_subprotocol`.200 201rm rr )� subprotocolss r, r r � s � � �9�9�\� "�"r2 c �� � [ U [ 5 ( d [ S5 e[ U [ 5 ( a [ S5 eU H+ n[ R U5 ( a M [
SU 35 e g)zL202Validate that ``subprotocols`` is suitable for :func:`build_subprotocol`.203 204zsubprotocols must be a listz&subprotocols must be a list, not a strzinvalid subprotocol: N)�205isinstancer � TypeErrorrj r9 rG r' )rx � subprotocols r, r r � sd � �206 �l�H� -� -��5�6�6��,��$�$��@�A�A�#� ��"�"�;�/�/� � 4�[�M� B�C� C� $r2 c �> � [ U 5 n [ S5 nSU SU 3$ )zq207Build a ``WWW-Authenticate`` header for HTTP Basic Auth.208 209Args:210 realm: Identifier of the protection space.211 212zUTF-8z Basic realm=z213, charset=)rJ )�realm�charsets r, r r � s+ � �
�� &�E�!�'�*�G�
�%��214�7�)� 4�4r2 z[A-Za-z0-9-._~+/]+=*c � � [ R X5 nUc
[ USX5 eUR 5 UR 5 4$ )z�215Parse a token68 from ``header`` at the given position.216 217Return the token value and the new position.218 219Raises:220 InvalidHeaderFormat: On invalid inputs.221 222zexpected token68)� _token68_rer5 r r: r6 r; s r, �
parse_token68r� � s@ � �
� � �f� *�E� �}�!�+�/A�6�O�O� �;�;�=�%�)�)�+� %�%r2 c �< � U[ U 5 : a
[ USX5 eg)z0223Check that parsing reached the end of header.224 225z
trailing dataN)r. r )r/ r0 r< s r, � parse_endr� s$ � �226 �S��[��!�+���L�L� r2 c �� � [ U SS5 u pUR 5 S:w a [ SSU 35 e[ X5 S:w a
[ SSX5 eUS-
n[ XS5 u p2[
XS5 [ R " UR 5 5 R 5 n UR S227S5 u pVXV4$ ! [ R a [ SS5 S ef = f! [ a [ SS 5 S ef = f) a 228Parse an ``Authorization`` header for HTTP Basic Auth.229 230Return a ``(username, password)`` tuple.231 232Args:233 header: Value of the ``Authorization`` header.234 235Raises:236 InvalidHeaderFormat: On invalid inputs.237 InvalidHeaderValue: On unsupported inputs.238 239r �
Authorization�basiczunsupported scheme: � zexpected space after schemer z#expected base64-encoded credentialsNr# z&expected username:password credentials)r= �lowerr240 r1 r r� r� �base64� b64decode�encode�decode�binascii�Error�splitr' )r/ �schemer0 �basic_credentials� user_pass�username�passwords r, r r s% � � �f�a� �9�K�F�
�|�|�~�� � � �"�6�(� +�241� 242� �&� �#�%�!� � :�F�243� 244� �1�H�C� *�6�� H���
�f�?�+���$�$�%6�%=�%=�%?�@�G�G�I� � � &�_�_�S�!� 4��� � � �� �>�>� � � � 1�245� � ��� � � � � 4�246� � ��s �/2B9 �"C �9"C� C6c � � SU ; d eU SU 3n[ R " UR 5 5 R 5 nSU- $ )zt247Build an ``Authorization`` header for HTTP Basic Auth.248 249This is the reverse of :func:`parse_authorization_basic`.250 251r# zBasic )r� � b64encoder� r� )r� r� r� r� s r, r r ? sQ � � �h� � � ��*�A�h�Z�(�I� �(�(��)9�)9�);�<�C�C�E�� �'� '�'r2 )252r( rj r) �intr* �boolr r� �returnrj )r/ rj r0 r� r� z253str | None)r/ rj r0 r� r� r� )r/ rj r0 r� r< rj r� ztuple[str, int])rI rj r� rj )254rN z(Callable[[str, int, str], tuple[T, int]]r/ rj r0 r� r< rj r� zlist[T])r/ rj r0 r� r< rj r� z tuple[ConnectionOption, int])r/ rj r� zlist[ConnectionOption])r/ rj r0 r� r< rj r� ztuple[UpgradeProtocol, int])r/ rj r� zlist[UpgradeProtocol])r/ rj r0 r� r< rj r� z tuple[ExtensionParameter, int])r/ rj r0 r� r< rj r� ztuple[ExtensionHeader, int])r/ rj r� zlist[ExtensionHeader])r_ r
rd z Sequence[ExtensionParameter]r� rj )rs zSequence[ExtensionHeader]r� rj )r/ rj r0 r� r< rj r� ztuple[Subprotocol, int])r/ rj r� zlist[Subprotocol])rx �Sequence[Subprotocol]r� rj )rx r� r� �None)r~ rj r� rj )r/ rj r0 r� r< rj r� r� )r/ rj r� ztuple[str, str])r� rj r� rj r� rj )=�255__future__r r� r� r$ �re�collections.abcr �typingr r r �256exceptionsr r257 r r r
r r r �__all__r r r1 �compiler4 r7 r9 r= r@ rA rC rF rH rJ rQ rT r rY rZ r ra rf r �parse_extension_listrk r �build_extension_listru r �parse_subprotocol_listr �build_subprotocol_listr r r� r� r� r r � r2 r, �<module>r� s� �� "�
� � � � $� *� *� ?�� � �� �C�L�� !&� �258
��259
��
��260 � � �
�D 7�
�*�*�Y�261 �� �
�J�J�6� 7� �
&� �J�J�J�� �262 �j�j�8�9� �
D� �z�z�6�7� �
�J�J�� '� �2635�?�8�?� �?� 264
�?� � ?�265
� ?�D
-� �
-��
-�(+�
-�!�
-�
H� �z�z�E�� �266=� �=��=�(+�=� �=�$
D� ! � �! ��! �(+�! �#�! �H8� �8��8�(+�8� �8�2S�4 '� ��267��%A����& � '� �
(� �
(��
(�(+�
(� �
(� 268S� +� �#� +� � D� 5� �j�j�0�1� �
&� M�- �` (r2