add changelog, update tests

Author: Harshal96

CHANGELOG.rst

@@ -15,6 +15,9 @@ dev
 **API Changes (Backward Compatible)**
 
 - Support for Python 3.14 has been added.
+- ``H2Connection.receive_data`` now accepts any byte-like object that
+  implements the buffer protocol, such as ``bytes``, ``bytearray``, and
+  ``memoryview``. Existing ``bytes`` callers are unaffected.
 - Align CONNECT pseudo-header validation with RFC 9113 s8.3 and RFC 8441 s4.
   Ordinary CONNECT now requires ``:method=CONNECT`` and ``:authority``, and
   forbids ``:scheme``/``:path``. Extended CONNECT (e.g., WebSocket) requires

docs/source/basic-usage.rst

@@ -311,6 +311,10 @@ socket, in a loop. We then passed that data to the connection object, which
 returned us a single event object:
 :class:`RemoteSettingsChanged <h2.events.RemoteSettingsChanged>`.
 
+``receive_data`` accepts the ``bytes`` returned by ``recv`` as well as other
+byte-like objects that implement the buffer protocol, such as ``bytearray`` and
+``memoryview``.
+
 But what we didn't see was anything else. So it seems like all ``curl`` did
 was change its settings, but nothing else. If you look at the other ``curl``
 window, you'll notice that it hangs for a while and then eventually fails with
@@ -750,4 +754,4 @@ it, there are a few directions you could investigate:
 .. _PyOpenSSL: http://pyopenssl.readthedocs.org/
 .. _Eventlet example: https://github.com/python-hyper/h2/blob/master/examples/eventlet/eventlet-server.py
 .. _curl: https://curl.se/docs/http2.html
-.. _httpx: https://www.python-httpx.org/
+.. _httpx: https://www.python-httpx.org/

tests/test_basic_logic.py

@@ -1003,6 +1003,22 @@ def test_ignores_preamble(self) -> None:
         assert not events
         assert not c.data_to_send()
 
+    @pytest.mark.parametrize("data_wrapper", [bytearray, memoryview])
+    def test_receive_data_accepts_buffer_types(
+        self,
+        data_wrapper,
+        frame_factory,
+    ) -> None:
+        """
+        ``receive_data`` accepts byte-like buffers and handles their contents.
+        """
+        c = h2.connection.H2Connection(config=self.server_config)
+
+        events = c.receive_data(data_wrapper(frame_factory.preamble()))
+
+        assert not events
+        assert not c.data_to_send()
+
     @pytest.mark.parametrize("chunk_size", range(1, 24))
     def test_drip_feed_preamble(self, chunk_size) -> None:
         """

tests/typing/strict_bytes.py

@@ -1,17 +1,28 @@
 from __future__ import annotations
 
+from hyperframe.frame import Frame
+from typing_extensions import assert_type
+
 from h2.connection import H2Connection
+from h2.events import Event
 from h2.frame_buffer import FrameBuffer
 
 
-def receive_data_accepts_buffer_types(
-    connection: H2Connection,
-    frame_buffer: FrameBuffer,
-) -> None:
+def receive_data_accepts_buffer_types() -> None:
+    connection = H2Connection()
+    frame_buffer = FrameBuffer()
     bytearray_data = bytearray(b"")
     memoryview_data = memoryview(b"")
 
-    connection.receive_data(bytearray_data)
-    connection.receive_data(memoryview_data)
+    bytearray_events = connection.receive_data(bytearray_data)
+    memoryview_events = connection.receive_data(memoryview_data)
     frame_buffer.add_data(bytearray_data)
     frame_buffer.add_data(memoryview_data)
+    buffered_frames = list(frame_buffer)
+
+    assert_type(bytearray_events, list[Event])
+    assert_type(memoryview_events, list[Event])
+    assert_type(buffered_frames, list[Frame])
+    assert bytearray_events == []
+    assert memoryview_events == []
+    assert buffered_frames == []