codekingpro/portable-devtools
114k
1�
2 ��j#0 � �� � S r SSKJr SSKrSSKrSSKJrJr SSKJ r SSK3J r SSK J
r
SS KJr " S4 S \R 5 rSS jr " S
S5 r " S S\\ \\4 \4 5 rSS jrg)a 5h2/settings6~~~~~~~~~~~7 8This module contains a HTTP/2 settings object. This object provides a simple9API for manipulating HTTP/2 settings, keeping track of both the current active10state of the settings and the unacknowledged future values of the settings.11� )� annotationsN)�Iterator�MutableMapping)�Union)�
SettingsFrame� )�12ErrorCodes)�InvalidSettingsValueErrorc �� � \ rS rSrSr\R r\R r\R r\R r \R r13\R r \R r Sr
g)� SettingCodes� z:14All known HTTP/2 setting codes.15 16.. versionadded:: 2.6.017� N)�__name__�18__module__� __qualname__�__firstlineno__�__doc__r �HEADER_TABLE_SIZE� ENABLE_PUSH�MAX_CONCURRENT_STREAMS�INITIAL_WINDOW_SIZE�MAX_FRAME_SIZE�MAX_HEADER_LIST_SIZE�ENABLE_CONNECT_PROTOCOL�__static_attributes__r � �QD:\code\apps\devtools\python\user_packages\Python313\site-packages\h2/settings.pyr r sg � �� &�7�7�� �+�+�K� +� A� A�� (�;�;�� #�1�1�N� )�=�=�� ,� C� C�r r c �> � [ U 5 $ ! [ a U s $ f = f)z�19Given an integer setting code, returns either one of :class:`SettingCodes20<h2.settings.SettingCodes>` or, if not present in the known set of codes,21returns the integer directly.22)r �23ValueError)�codes r �_setting_code_from_intr! < s& � � ��D�!�!�� � �� ��s �24
� � c �( � \ rS rSrSS jrSS jrSrg)�ChangedSetting�H c �( � Xl X l X0l g �N��setting�original_value� new_value)�selfr( r) r* s r �__init__�ChangedSetting.__init__J s � �25 � � -�� #�r c �X � SU R < SU R SU R S3$ )NzChangedSetting(setting=z, original_value=z , new_value=�)r' �r+ s r �__repr__�ChangedSetting.__repr__W s6 � �%�d�l�l�%5�5F�t�GZ�GZ�F[�[g�hl�hv�hv�gw�wx� y� 26r )r* r) r( N)r( �SettingCodes | intr) �27int | Noner* �int�return�None)r6 �str)r r r r r, r1 r r r r r# r# H s � � #�28r r# c � � \ rS rSrSrS S S jjrS S jr\S S j5 r\R S S j5 r\S S j5 r29\30R S S j5 r31\S S32 j5 r \ R S S j5 r \S S j5 r \ R S S
j5 r \S S j5 r
\
R S S j5 r
\S!S j5 r\R S S j5 r\S S j5 r\R S S j5 rS"S jrS#S jrS$S jrS%S jrS S jrS&S jrS&S jrSrg)'�Settings�] a 33An object that encapsulates HTTP/2 settings state.34 35HTTP/2 Settings are a complex beast. Each party, remote and local, has its36own settings and a view of the other party's settings. When a settings37frame is emitted by a peer it cannot assume that the new settings values38are in place until the remote peer acknowledges the setting. In principle,39multiple settings changes can be "in flight" at the same time, all with40different values.41 42This object encapsulates this mess. It provides a dict-like interface to43settings, which return the *current* values of the settings in question.44Additionally, it keeps track of the stack of proposed values: each time an45acknowledgement is sent/received, it updates the current values with the46stack of proposed values. On top of all that, it validates the values to47make sure they're allowed, and raises :class:`InvalidSettingsValueError48<h2.exceptions.InvalidSettingsValueError>` if they are not.49 50Finally, this object understands what the default values of the HTTP/251settings are, and sets those defaults appropriately.52 53.. versionchanged:: 2.2.054 Added the ``initial_values`` parameter.55 56.. versionchanged:: 2.5.057 Added the ``max_header_list_size`` property.58 59:param client: (optional) Whether these settings should be defaulted for a60 client implementation or a server implementation. Defaults to ``True``.61:type client: ``bool``62:param initial_values: (optional) Any initial values the user would like63 set, rather than RFC 7540's defaults.64:type initial_vales: ``MutableMapping``65Nc �` � [ R [ R " S/5 [ R [ R " [ U5 /5 [ R [ R " S/5 [ R [ R " S/5 [ R [ R " S/5 0U l Ubb UR 5 HM u p4[ X45 nU( a SU SU 3n[ UUS9e[ R " U/5 U R U' MO g g )Ni i�� � @ r �Setting � has invalid value ��66error_code)
r r � collections�dequer r5 r r r � _settings�items�_validate_settingr67 )r+ �client�initial_values�key�value�invalid�msgs r r, �Settings.__init__� s� � �
� *� *�K�,=�,=�t�f�,E� � $� $�k�&7�&7��V��
�&F� � ,� ,�k�.?�.?���.H� � '� '��):�):�E�7�)C� � 0� 0�+�2C�2C�Q�C�2H� L68��� � %� ,� 2� 2� 4�69��+�C�7��� $�S�E�)<�U�G�D�C�3��#*�� � '2�&7�&7���&@����s�#� 5� &r c � � 0 nU R R 5 H9 u p#[ U5 S:� d M UR 5 nUS n[ X$U5 X' M; U$ )z�70The settings have been acknowledged, either by the user (remote71settings) or by the remote peer (local settings).72 73:returns: A dict of {setting: ChangedSetting} that were applied.74r r )rD rE �len�popleftr# )r+ �changed_settings�k�v� old_setting� new_settings r � acknowledge�Settings.acknowledge� sa � � FH�� �N�N�(�(�*�D�A��1�v��z� �i�i�k� � ��d� �&4��K�'� �#� +� � r c �( � U [ R $ )zj75The current value of the :data:`HEADER_TABLE_SIZE76<h2.settings.SettingCodes.HEADER_TABLE_SIZE>` setting.77�r r r0 s r �header_table_size�Settings.header_table_size� s � � �L�2�2�3�3r c �( � X[ R ' g r& rY �r+ rJ s r rZ r[ � s � �/4�\�
+�
+�,r c �( � U [ R $ )z^78The current value of the :data:`ENABLE_PUSH79<h2.settings.SettingCodes.ENABLE_PUSH>` setting.80�r r r0 s r � enable_push�Settings.enable_push� s � � �L�,�,�-�-r c �( � X[ R ' g r& r_ r] s r r` ra � s � �).�\�
%�
%�&r c �( � U [ R $ )zn81The current value of the :data:`INITIAL_WINDOW_SIZE82<h2.settings.SettingCodes.INITIAL_WINDOW_SIZE>` setting.83�r r r0 s r �initial_window_size� Settings.initial_window_size� s � � �L�4�4�5�5r c �( � X[ R ' g r& rd r] s r re rf � s � �16�\�
-�
-�.r c �( � U [ R $ )zd84The current value of the :data:`MAX_FRAME_SIZE85<h2.settings.SettingCodes.MAX_FRAME_SIZE>` setting.86�r r r0 s r �max_frame_size�Settings.max_frame_size� s � � �L�/�/�0�0r c �( � X[ R ' g r& ri r] s r rj rk � s � �,1�\�
(�
(�)r c �B � U R [ R S5 $ )zt87The current value of the :data:`MAX_CONCURRENT_STREAMS88<h2.settings.SettingCodes.MAX_CONCURRENT_STREAMS>` setting.89l )�getr r r0 s r �max_concurrent_streams� Settings.max_concurrent_streams� s � � �x�x� �;�;�W�E�Er c �( � X[ R ' g r& )r r r] s r ro rp � s � �49�\�
0�
0�1r c �B � U R [ R S5 $ )z�90The current value of the :data:`MAX_HEADER_LIST_SIZE91<h2.settings.SettingCodes.MAX_HEADER_LIST_SIZE>` setting. If not set,92returns ``None``, which means unlimited.93 94.. versionadded:: 2.5.095N)rn r r r0 s r �max_header_list_size� Settings.max_header_list_size� s � � �x�x� �9�9�4�@�@r c �( � X[ R ' g r& )r r r] s r rs rt � s � �27�\�
.�
.�/r c �( � U [ R $ )zv96The current value of the :data:`ENABLE_CONNECT_PROTOCOL97<h2.settings.SettingCodes.ENABLE_CONNECT_PROTOCOL>` setting.98�r r r0 s r �enable_connect_protocol� Settings.enable_connect_protocol� s � � �L�8�8�9�9r c �( � X[ R ' g r& rw r] s r rx ry s � �5:�\�
1�
1�2r c �< � U R U S nUc [ eU$ )Nr )rD �KeyError)r+ rI �vals r � __getitem__�Settings.__getitem__ s& � ��n�n�S�!�!�$�� �;��N��99r c �� � [ X5 nU( a SU SU 3n[ UUS9e U R U nUR
U5 g ! [ a( [ R100 " S /5 nXPR U' NCf = f)Nr> r? r@ )rF r101 rD r| rB rC �append)r+ rI rJ rK rL rE s r � __setitem__�Settings.__setitem__ s� � �#�C�/�� � �S�E�!4�U�G�<�C�+��"��
�102 (��N�N�3�'�E�103 � � �U��� � (� �%�%�t�f�-�E�"'�N�N�3� � (�s �A �/A9�8A9c � � U R U g r& �rD )r+ rI s r � __delitem__�Settings.__delitem__# s � � �N�N�3� r c �6 � U R R 5 $ r& )rD �__iter__r0 s r r� �Settings.__iter__& s � ��~�~�&�&�(�(r c �, � [ U R 5 $ r& )rO rD r0 s r �__len__�Settings.__len__) s � ��4�>�>�"�"r c �j � [ U[ 5 ( a U R UR :H $ [ $ r& )�104isinstancer: rD �NotImplemented�r+ �others r �__eq__�Settings.__eq__, s( � � �e�X� &� &��>�>�U�_�_�4� 4� � r c �B � [ U[ 5 ( a X:X + $ [ $ r& )r� r: r� r� s r �__ne__�Settings.__ne__1 s � � �e�X� &� &��$� $� � r r� )TN)rG �boolrH z dict[SettingCodes, int] | Noner6 r7 )r6 z(dict[SettingCodes | int, ChangedSetting])r6 r5 )rJ r5 r6 r7 )r6 r4 )rI r3 r6 r5 )rI r3 rJ r5 r6 r7 )rI r3 r6 r7 )r6 z Iterator[SettingCodes | int])r� �objectr6 r� )r r r r r r, rV �propertyrZ �setterr` re rj ro rs rx r~ r� r� r� r� r� r� r r r r r: r: ] s| � �!�FA�2 �, �4� �4� � � �5� �5� �.� �.� ���/� �/� �6� �6� � � �7� �7� �1� �1� ���2� �2� �F� �F� �"�"�:� #�:� �A� �A� � � �8� !�8� �:� �:� �#�#�;� $�;�� �" �)�#� �105 r r: c � � U [ R :X a' US; a [ R $ [ R $ U [ R :X a@ SUs=:: a S:: d" [ R106 $ [ R107 $ [ R $ U [ R :X a@ SUs=:: a S:: d" [ R $ [ R $ [ R $ U [ R :X a' US: a [ R $ [ R $ U [ R :X a US; a [ R $ [ R $ )z�108Confirms that a specific setting has a well-formed value. If the setting is109invalid, returns an error code. Otherwise, returns 0 (NO_ERROR).110)r r r i���r= i��� )111r r r �PROTOCOL_ERRORr �FLOW_CONTROL_ERRORr r r �NO_ERROR)r( rJ s r rF rF 7 s8 � �112 �,�*�*�*� �� � �,�,� ,� � � � � � 113�L�4�4� 4��E�'�Z�'� �0�0� 0� (� �0�0� 0� (� � � � � 114�L�/�/� /���)��)� �,�,� ,� *� �,�,� ,� *� � � � �
115�L�5�5� 5� �1�9� �,�,� ,� �116 � � � � 117�L�8�8� 8�U�&�=P��(�(�(� � � � r )r r5 r6 r3 )r( r3 rJ r5 r6 r )r �118__future__r rB �enum�collections.abcr r �typingr �hyperframe.framer �errorsr �119exceptionsr120 �IntEnumr r! r# r5 r: rF r r r �<module>r� sn ��� #� � � 4� � *� � 1�#D�4�<�<� #D�L �121� 122�*W �~�e�L�#�$5� 6�� ;�<� W �t r