| Server IP : 178.105.222.151 / Your IP : 216.73.216.38 Web Server : nginx/1.28.3 System : Linux MNK 7.0.0-15-generic #15-Ubuntu SMP PREEMPT_DYNAMIC Wed Apr 22 16:06:43 UTC 2026 x86_64 User : www-data ( 33) PHP Version : 8.5.4 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : OFF Directory : /lib/python3/dist-packages/botocore/__pycache__/ |
Upload File : |
+
��i7O � �@ � R t ^ RIHt ^ RIHt ^ RIHt ^ tR tR t ! R R]
4 t ! R R] 4 t ! R R ] 4 t
! R
R ] 4 t ! R R
] 4 t ! R R] 4 t ! R R4 tR R lt ! R R4 t ! R R4 t ! R R4 t ! R R4 t ! R R 4 tR # )!z Binary Event Stream Decoding)�crc32)�unpack)�EventStreamErrorc � � ] tR t^tRtRtR# )� ParserErrorz,Base binary flow encoding parsing exception.� N)�__name__�
__module__� __qualname__�__firstlineno__�__doc__�__static_attributes__r � �6/usr/lib/python3/dist-packages/botocore/eventstream.pyr r s � �6�r r c �6 a a� ] tR t^ t oRtV 3R ltRtVtV ;t# )�DuplicateHeaderz$Duplicate header found in the event.c �2 <� R V R2p\ SV ` V4 R# )zDuplicate header present: "�"N��super�__init__)�self�header�message� __class__s && �r r �DuplicateHeader.__init__# s �� �/��x�q�9��
����!r r � r r r
r r r r
�__classdictcell__�
__classcell__�r �
__classdict__s @@r r r s �� � �.�"� "r r c �6 a a� ] tR t^(t oRtV 3R ltRtVtV ;t# )�InvalidHeadersLengthz*Headers length is longer than the maximum.c �> <� R V R\ 2p\ SV ` V4 R# )zHeader length of � exceeded the maximum of N)�_MAX_HEADERS_LENGTHr r �r �lengthr r s && �r r � InvalidHeadersLength.__init__+ s% �� �%�f�X�-F�GZ�F[�\��
����!r r r r s @@r r" r" ( � �� � �4�"� "r r" c �6 a a� ] tR t^0t oRtV 3R ltRtVtV ;t# )�InvalidPayloadLengthz*Payload length is longer than the maximum.c �> <� R V R\ 2p\ SV ` V4 R# )zPayload length of r$ N)�_MAX_PAYLOAD_LENGTHr r r& s && �r r � InvalidPayloadLength.__init__3 s% �� �&�v�h�.G�H[�G\�]��
����!r r r r s @@r r+ r+ 0 r) r r+ c �6 a a� ] tR t^8t oRtV 3R ltRtVtV ;t# )�ChecksumMismatchz8Calculated checksum did not match the expected checksum.c �: <� R VR
RVR
2p\ SV ` V4 R# )z Checksum mismatch: expected 0x�08xz, calculated 0xNr )r �expected�
calculatedr r s &&& �r r �ChecksumMismatch.__init__; s) �� �2�8�C�.��PZ�[^�O_�`��
����!r r r r s @@r r0 r0 8 s �� � �B�"� "r r0 c �6 a a� ] tR t^@t oRtV 3R ltRtVtV ;t# )�NoInitialResponseErrorz�An event of type initial-response was not received.
This exception is raised when the event stream produced no events or
the first event in the stream was not of the initial-response type.
c �* <� R p\ SV ` V4 R# )z0First event was not of the initial-response typeNr )r r r s & �r r � NoInitialResponseError.__init__G s �� �D��
����!r r r r s @@r r7 r7 @ s �� � �� "� "r r7 c � a � ] tR t^Lt o RtRtRtRtRtRt Rt
Rt R t ^]^]^]/t
]R
4 t]R 4 t]R 4 t]R
4 t]R 4 t]R 4 t]R 4 t]R 4 t]RR l4 t]RR l4 t]R 4 t]R 4 tRtV t R# )� DecodeUtilsz�Unpacking utility functions used in the decoder.
All methods on this class take raw bytes and return a tuple containing
the value parsed from the bytes and the number of bytes consumed to parse
that value.
z!Bz!Hz!Iz!bz!hz!iz!qz!IIIc � � R# )z�This method consumes none of the provided bytes and returns True.
:type data: bytes
:param data: The bytes to parse from. This is ignored in this method.
:rtype: tuple
:rtype: (bool, int)
:returns: The tuple (True, 0)
)T� r ��datas &r � unpack_true�DecodeUtils.unpack_trued s � � �r c � � R# )z�This method consumes none of the provided bytes and returns False.
:type data: bytes
:param data: The bytes to parse from. This is ignored in this method.
:rtype: tuple
:rtype: (bool, int)
:returns: The tuple (False, 0)
)Fr= r r> s &r � unpack_false�DecodeUtils.unpack_falseq s � � �r c �Z � \ \ P V R, 4 ^ , pV^3# )z�Parse an unsigned 8-bit integer from the bytes.
:type data: bytes
:param data: The bytes to parse from.
:rtype: (int, int)
:returns: A tuple containing the (parsed integer value, bytes consumed)
�N� N)r r; �UINT8_BYTE_FORMAT�r? �values & r � unpack_uint8�DecodeUtils.unpack_uint8~ s( � � �{�4�4�d�2�h�?��B���a�x�r c �Z � \ \ P V R, 4 ^ , pV^3# )z�Parse an unsigned 32-bit integer from the bytes.
:type data: bytes
:param data: The bytes to parse from.
:rtype: (int, int)
:returns: A tuple containing the (parsed integer value, bytes consumed)
�N� N)r r; �UINT32_BYTE_FORMATrI s & r �
unpack_uint32�DecodeUtils.unpack_uint32� s( � � �{�5�5�t�B�x�@��C���a�x�r c �Z � \ \ P V R, 4 ^ , pV^3# )z�Parse a signed 8-bit integer from the bytes.
:type data: bytes
:param data: The bytes to parse from.
:rtype: (int, int)
:returns: A tuple containing the (parsed integer value, bytes consumed)
rF )r r; �INT8_BYTE_FORMATrI s & r � unpack_int8�DecodeUtils.unpack_int8� s( � � �{�3�3�T�"�X�>�q�A���a�x�r c �Z � \ \ P V R, 4 ^ , pV^3# )z�Parse a signed 16-bit integer from the bytes.
:type data: bytes
:param data: The bytes to parse from.
:rtype: tuple
:rtype: (int, int)
:returns: A tuple containing the (parsed integer value, bytes consumed)
:N� N)r r; �INT16_BYTE_FORMATrI s & r � unpack_int16�DecodeUtils.unpack_int16� �( � � �{�4�4�d�2�h�?��B���a�x�r c �Z � \ \ P V R, 4 ^ , pV^3# )z�Parse a signed 32-bit integer from the bytes.
:type data: bytes
:param data: The bytes to parse from.
:rtype: tuple
:rtype: (int, int)
:returns: A tuple containing the (parsed integer value, bytes consumed)
rN )r r; �INT32_BYTE_FORMATrI s & r � unpack_int32�DecodeUtils.unpack_int32� r\ r c �Z � \ \ P V R, 4 ^ , pV^3# )z�Parse a signed 64-bit integer from the bytes.
:type data: bytes
:param data: The bytes to parse from.
:rtype: tuple
:rtype: (int, int)
:returns: A tuple containing the (parsed integer value, bytes consumed)
:N� N)r r; �INT64_BYTE_FORMATrI s & r � unpack_int64�DecodeUtils.unpack_int64� r\ r c �x � \ P V, p\ W RV 4 ^ , pW1, pWV pWT3# )aC Parse a variable length byte array from the bytes.
The bytes are expected to be in the following format:
[ length ][0 ... length bytes]
where length is an unsigned integer represented in the smallest number
of bytes to hold the maximum length of the array.
:type data: bytes
:param data: The bytes to parse from.
:type length_byte_size: int
:param length_byte_size: The byte size of the preceding integer that
represents the length of the array. Supported values are 1, 2, and 4.
:rtype: (bytes, int)
:returns: A tuple containing the (parsed byte array, bytes consumed).
N)r; �UINT_BYTE_FORMATr )r? �length_byte_size�uint_byte_formatr' � bytes_end� array_bytess && r �unpack_byte_array� DecodeUtils.unpack_byte_array� sJ � �& '�7�7�8H�I���(�/@�0@�*A�B�1�E���-� ��I�6� ��%�%r c �V � \ P W4 w r#VP R4 V3# )ap Parse a variable length utf-8 string from the bytes.
The bytes are expected to be in the following format:
[ length ][0 ... length bytes]
where length is an unsigned integer represented in the smallest number
of bytes to hold the maximum length of the array and the following
bytes are a valid utf-8 string.
:type data: bytes
:param bytes: The bytes to parse from.
:type length_byte_size: int
:param length_byte_size: The byte size of the preceding integer that
represents the length of the array. Supported values are 1, 2, and 4.
:rtype: (str, int)
:returns: A tuple containing the (utf-8 string, bytes consumed).
zutf-8)r; rl �decode)r? rh rk �consumeds && r �unpack_utf8_string� DecodeUtils.unpack_utf8_string� s2 � �( !,� =� =� �!
� � � �!�!�'�*�H�4�4r c � � V R, ^3# )z�Parse a 16-byte uuid from the bytes.
:type data: bytes
:param data: The bytes to parse from.
:rtype: (bytes, int)
:returns: A tuple containing the (uuid bytes, bytes consumed).
:N� Nr r> s &r � unpack_uuid�DecodeUtils.unpack_uuid s � � �C�y�"�}� r c �B � \ \ P V 4 \ 3# )aM Parse the prelude for an event stream message from the bytes.
The prelude for an event stream message has the following format:
[total_length][header_length][prelude_crc]
where each field is an unsigned 32-bit integer.
:rtype: ((int, int, int), int)
:returns: A tuple of ((total_length, headers_length, prelude_crc),
consumed)
)r r; �PRELUDE_BYTE_FORMAT�_PRELUDE_LENGTHr> s &r �unpack_prelude�DecodeUtils.unpack_prelude
s � � �{�6�6��=��O�Or r N)rX ) r r r
r r rH �UINT16_BYTE_FORMATrP rT rY r^ rc rx rg � staticmethodr@ rC rK rQ rU rZ r_ rd rl rq ru rz r
r �r s @r r; r; L sJ �� � �� �� �� ���� �� �� �� ��
� � � � � ��� �
� �
� �
� �
� �
� �
� �
� �
� �
� �
� � � � � � � � � � � � � �&� �&�0 �5� �5�0 � � � � � P� � Pr r; c �L � \ W4 R , pW8w d \ W4 hR# )l �� N)r r0 )r? �checksum�crc�computed_checksums &&& r �_validate_checksumr� s* � � �d�(�:�5���$� �x�;�;� %r c �Z a � ] tR tRt o RtR t]R 4 t]R 4 t]R 4 t Rt
V t R# ) �MessagePreludei$ z2Represents the prelude of an event stream message.c �* � Wn W n W0n R # �N)� total_length�headers_lengthr� )r r� r� r� s &&&&r r �MessagePrelude.__init__' s � � (�� ,���r c �` � V P V P ,
\ ,
^,
# )z�Calculates the total payload length.
The extra minus 4 bytes is for the message CRC.
:rtype: int
:returns: The total payload length.
)r� r� ry �r s &r �payload_length� MessagePrelude.payload_length, s% � � � � �4�#6�#6�6� �H�1�L�Lr c �( � V P ^,
# )z�Calculates the byte offset for the end of the message payload.
The extra minus 4 bytes is for the message CRC.
:rtype: int
:returns: The byte offset from the beginning of the event stream
message to the end of the payload.
)r� r� s &r � payload_end�MessagePrelude.payload_end7 s � � � � �1�$�$r c �0 � \ V P , # )z�Calculates the byte offset for the end of the message headers.
:rtype: int
:returns: The byte offset from the beginning of the event stream
message to the end of the headers.
)ry r� r� s &r � headers_end�MessagePrelude.headers_endC s � � ��!4�!4�4�4r )r� r� r� N) r r r
r r r �propertyr� r� r� r
r r~ s @r r� r� $ sK �� � �<��
�M� �M� � %� � %� �5� �5r r� c �4 a � ] tR tRt o RtR tRR ltRtV tR# )�EventStreamMessageiN z#Represents an event stream message.c �6 � Wn W n W0n W@n R # r� )�prelude�headers�payloadr� )r r� r� r� r� s &&&&&r r �EventStreamMessage.__init__Q s � � � � � � � ��r c � � V P P R 4 pVR8X g VR8X d RpRVRV P RV P /# )z
:message-type�error� exceptioni� � status_coder� �body)r� �getr� )r r� � message_types && r �to_response_dict�#EventStreamMessage.to_response_dictW sK � ��|�|�'�'��8� � �7� "�l�k�&A� �K� �;� �t�|�|� �D�L�L�
�
r )r� r� r� r� N)�� ) r r r
r r r r� r
r r~ s @r r� r� N s �� � �-��
�
r r� c �H a � ] tR tRt o Rt^ ]P ^]P ^]P ^]P ^]P ^]P ^]P ^]P ^]P ^ ]P /
tR tR tR tR tR tR tR tR
tR tV tR # )
�EventStreamHeaderParserib z�Parses the event headers from an event stream message.
Expects all of the header data upfront and creates a dictionary of headers
to return. This object can be reused multiple times to parse the headers
from multiple event stream messages.
c � � R V n R # r� ��_datar� s &r r � EventStreamHeaderParser.__init__� s � ���
r c �. � Wn V P 4 # )z�Parses the event stream headers from an event stream message.
:type data: bytes
:param data: The bytes that correspond to the headers section of an
event stream message.
:rtype: dict
:returns: A dictionary of header key, value pairs.
)r� �_parse_headers�r r? s &&r �parse� EventStreamHeaderParser.parse� s � � �
��"�"�$�$r c � � / pV P ' d* V P 4 w r#W!9 d \ V4 hW1V& K; V# r� )r� �
_parse_headerr )r r� �namerJ s & r r� �&EventStreamHeaderParser._parse_headers� s< � ����j�j�j� �,�,�.�K�D���%�d�+�+� !�D�M��r c �H � V P 4 pV P 4 pW3# r� )� _parse_name� _parse_value)r r� rJ s & r r� �%EventStreamHeaderParser._parse_header� s& � �� � �!���!�!�#���{�r c �l � \ P V P ^4 w rV P V4 V# )rG )r; rq r� �
_advance_data)r r� rp s & r r� �#EventStreamHeaderParser._parse_name� s- � �$�7�7��
�
�A�F��� ���8�$�� r c �j � \ P V P 4 w rV P V4 V# r� )r; rK r� r� )r �typerp s & r � _parse_type�#EventStreamHeaderParser._parse_type� s+ � �$�1�1�$�*�*�=��� ���8�$�� r c � � V P 4 pV P V, pV! V P 4 w r4V P V4 V# r� )r� �_HEADER_TYPE_MAPr� r� )r � header_type�value_unpackerrJ rp s & r r� �$EventStreamHeaderParser._parse_value� sC � ��&�&�(� � �.�.�{�;��(����4��� ���8�$�� r c �. � V P VR V n R # r� r� )r rp s &&r r� �%EventStreamHeaderParser._advance_data� s � ��Z�Z�� �*��
r r� N)r r r
r r r; r@ rC rU rZ r_ rd rl rq ru r� r r� r� r� r� r� r� r� r
r r~ s @r r� r� b s� �� � ��
�;� "� "� �;� #� #� �;� "� "� �;� #� #� �;� #� #� �;� #� #� �;� (� (� �;� )� )� �;� #� #� �;� "� "�)��.� %���
�
�
�+� +r r� c �x a � ] tR tRt o RtR tR tR tR tR t R t
R t R
t R t
R tR
tR tR tR tRtV tR# )�EventStreamBufferi� z�Streaming based event stream buffer
A buffer class that wraps bytes from an event stream providing parsed
messages as they become available via an iterable interface.
c �@ � R V n RV n \ 4 V n R# )r N)r� �_preluder� �_header_parserr� s &r r �EventStreamBuffer.__init__� s � ���
� ��
� 5� 7��r c �8 � V ;P V,
un R# )zoAdd data to the buffer.
:type data: bytes
:param data: The bytes to add to the buffer to be used when parsing
Nr� r� s &&r �add_data�EventStreamBuffer.add_data� s � �
�
�
�d��
r c � � VP \ 8� d \ VP 4 hVP \ 8� d \ VP 4 hR # r� )r� r% r" r� r- r+ )r r� s &&r �_validate_prelude�#EventStreamBuffer._validate_prelude� sG � � � !� !�$7� 7�&�w�'=�'=�>� >� � !� !�$7� 7�&�w�'=�'=�>� >� 8r c �� � V P R \ p\ P V4 w r#\ V! p\ VR \ ^,
VP 4 V P V4 V# r� )r� ry r; rz r� r� r� r� )r �
prelude_bytes� raw_prelude�_r� s & r �_parse_prelude� EventStreamBuffer._parse_prelude� s] � � �
�
�#3�O�4�
�$�3�3�M�B�� � �+�.���=�)>�?�Q�+>�?����M� � � �w�'��r c � � V P \ V P P pV P P V4 # r� )r� ry r� r� r� r� )r � header_bytess & r r� � EventStreamBuffer._parse_headers� s3 � ��z�z�/�D�M�M�4M�4M�N� ��"�"�(�(� �6�6r c �d � V P pV P VP VP pV# r� )r� r� r� r� )r r� �
payload_bytess & r �_parse_payload� EventStreamBuffer._parse_payload� s- � ��-�-�� �
�
�7�#6�#6��9L�9L�M�
� � r c � � V P pV P VP VP p\ P V4 w r4V# r� )r� r� r� r� r; rQ )r r� � crc_bytes� message_crcr� s & r �_parse_message_crc�$EventStreamBuffer._parse_message_crc� s? � ��-�-���J�J�w� 2� 2�W�5I�5I�J� �$�2�2�9�=�� ��r c �b � V P \ ^,
V P P pV# )rO )r� ry r� r� )r �
message_bytess & r �_parse_message_bytes�&EventStreamBuffer._parse_message_bytes� s, � � �
�
� �a� �$�-�-�";�";�
�
� � r c � � V P 4 pV P 4 p\ W!V P P R 7 V# ))r� )r� r� r� r� r� )r r� r� s & r �_validate_message_crc�'EventStreamBuffer._validate_message_crc� s8 � ��-�-�/� � �1�1�3�
��=�4�=�=�;L�;L�M��r c � � V P 4 pV P 4 pV P 4 p\ V P W#V4 pV P 4 V# r� )r� r� r� r� r� �_prepare_for_next_message)r r� r� r� r s & r �_parse_message� EventStreamBuffer._parse_message� sO � ��(�(�*���%�%�'���%�%�'��$�T�]�]�G�c�J�� �&�&�(��r c �d � V P V P P R V n R V n R # r� )r� r� r� r� s &r r� �+EventStreamBuffer._prepare_for_next_message� s& � ��Z�Z��
�
� :� :� <�=��
� ��
r c �( � \ V P 4 \ 8 d \ 4 hV P f V P 4 V n \ V P 4 V P P 8 d \ 4 hV P 4 # )zProvides the next available message parsed from the stream
:rtype: EventStreamMessage
:returns: The next event stream message
)�lenr� ry �
StopIterationr� r� r� r� r� s &r �next�EventStreamBuffer.next sg � � �t�z�z�?�_� ,� �/� !� �=�=� � � /� /� 1�D�M� �t�z�z�?�T�]�]� 7� 7� 7� �/� !��"�"�$�$r c �" � V P 4 # r� )r� r� s &r �__next__�EventStreamBuffer.__next__ s � ��y�y�{�r c � � V # r� r r� s &r �__iter__�EventStreamBuffer.__iter__ s � �� r )r� r� r� N)r r r
r r r r� r� r� r� r� r� r� r� r� r� r� r� r� r
r r~ s @r r� r� � sU �� � �� 8�
�?��7� �
� �� � �
%�"�� r r� c �H a � ] tR tRt o RtR tR tR tR tR t R t
R t V t R
# ) � EventStreami a< Wrapper class for an event stream body.
This wraps the underlying streaming body, parsing it for individual events
and yielding them as they come available through the iterator interface.
The following example uses the S3 select API to get structured data out of
an object stored in S3 using an event stream.
**Example:**
::
from botocore.session import Session
s3 = Session().create_client('s3')
response = s3.select_object_content(
Bucket='bucketname',
Key='keyname',
ExpressionType='SQL',
RequestProgress={'Enabled': True},
Expression="SELECT * FROM S3Object s",
InputSerialization={'CSV': {}},
OutputSerialization={'CSV': {}},
)
# This is the event stream in the response
event_stream = response['Payload']
end_event_received = False
with open('output', 'wb') as f:
# Iterate over events in the event stream as they come
for event in event_stream:
# If we received a records event, write the data to a file
if 'Records' in event:
data = event['Records']['Payload']
f.write(data)
# If we received a progress event, print the details
elif 'Progress' in event:
print(event['Progress']['Details'])
# End event indicates that the request finished successfully
elif 'End' in event:
print('Result is complete')
end_event_received = True
if not end_event_received:
raise Exception("End event not received, request incomplete.")
c �` � Wn W n W@n W0n V P 4 V n R # r� )� _raw_stream�
_output_shape�_operation_name�_parser�_create_raw_event_generator�_event_generator)r �
raw_stream� output_shape�parser�operation_names &&&&&r r �EventStream.__init__G s* � �%�� )�� -� � � � $� @� @� B�� r c # �r " � V P F" pV P V4 pV' g K Vx � K$ R # 5ir� )r � _parse_event)r �event� parsed_events & r r� �EventStream.__iter__N s0 � � ��*�*�E� �,�,�U�3�L��|�"�"� +�s �&7�
7c # � " � \ 4 pV P P 4 F pVP V4 T R j x�L
K R # L
5ir� )r� r �streamr� )r �event_stream_buffer�chunks & r r �'EventStream._create_raw_event_generatorT sA � � � /� 1���%�%�,�,�.�E� � (� (�� /�*� *� *� /� *�s �>A
� A � A
c � � VP 4 pV P P W P 4 pVR , ^�8X d V# \ W0P
4 h)r� )r� r r� r r r )r r �
response_dict�parsed_responses && r r
�EventStream._parse_eventZ sN � � �.�.�0�
� �,�,�,�,�]�<N�<N�O�� � � '�3� .�"� "�"�?�4H�4H�I� Ir c � � \ V P 4 pVP P R 4 pVR8X d V# \ 4 h \ d
\ 4 hi ; i)z :event-typezinitial-response)r� r r� r� r� r7 )r �
initial_event�
event_types & r �get_initial_response� EventStream.get_initial_responseb si � � � ��!6�!6� 7�M�&�.�.�2�2�=�A�J�� /�/�$�$� 0� %�&�&�� � � �$�&�&� �s �8A � A � A c �: � V P P 4 R# )z%Closes the underlying streaming body.N)r �closer� s &r r �EventStream.closel s � � ��� � � r )r r r r r N)
r r r
r r r r� r r
r r r
r r~ s @r r� r� s0 �� � �)�VC�#� +� J�'�!� !r r� Ni i �)r= )r �binasciir �structr �botocore.exceptionsr ry r% r- � Exceptionr r r" r+ r0 r7 r; r� r� r� r� r� r� r r r �<module>r& s� �� #� � � 0� �� � �&� � �)� � "�k� "�"�;� "�"�;� "�"�{� "� "�[� "�MP� MP�`<�'5� '5�T
�
�(Q+� Q+�hb� b�JS!� S!r