Code

Code/venv/lib/python3.13/site-packages/aioquic/h3/events.py

@@ -0,0 +1,100 @@
+from dataclasses import dataclass
+from typing import List, Optional, Tuple
+
+Headers = List[Tuple[bytes, bytes]]
+
+
+class H3Event:
+    """
+    Base class for HTTP/3 events.
+    """
+
+
+@dataclass
+class DataReceived(H3Event):
+    """
+    The DataReceived event is fired whenever data is received on a stream from
+    the remote peer.
+    """
+
+    data: bytes
+    "The data which was received."
+
+    stream_id: int
+    "The ID of the stream the data was received for."
+
+    stream_ended: bool
+    "Whether the STREAM frame had the FIN bit set."
+
+    push_id: Optional[int] = None
+    "The Push ID or `None` if this is not a push."
+
+
+@dataclass
+class DatagramReceived(H3Event):
+    """
+    The DatagramReceived is fired whenever a datagram is received from the
+    the remote peer.
+    """
+
+    data: bytes
+    "The data which was received."
+
+    stream_id: int
+    "The ID of the stream the data was received for."
+
+
+@dataclass
+class HeadersReceived(H3Event):
+    """
+    The HeadersReceived event is fired whenever headers are received.
+    """
+
+    headers: Headers
+    "The headers."
+
+    stream_id: int
+    "The ID of the stream the headers were received for."
+
+    stream_ended: bool
+    "Whether the STREAM frame had the FIN bit set."
+
+    push_id: Optional[int] = None
+    "The Push ID or `None` if this is not a push."
+
+
+@dataclass
+class PushPromiseReceived(H3Event):
+    """
+    The PushedStreamReceived event is fired whenever a pushed stream has been
+    received from the remote peer.
+    """
+
+    headers: Headers
+    "The request headers."
+
+    push_id: int
+    "The Push ID of the push promise."
+
+    stream_id: int
+    "The Stream ID of the stream that the push is related to."
+
+
+@dataclass
+class WebTransportStreamDataReceived(H3Event):
+    """
+    The WebTransportStreamDataReceived is fired whenever data is received
+    for a WebTransport stream.
+    """
+
+    data: bytes
+    "The data which was received."
+
+    stream_id: int
+    "The ID of the stream the data was received for."
+
+    stream_ended: bool
+    "Whether the STREAM frame had the FIN bit set."
+
+    session_id: int
+    "The ID of the session the data was received for."

Code/venv/lib/python3.13/site-packages/aioquic/h3/exceptions.py

@@ -0,0 +1,17 @@
+class H3Error(Exception):
+    """
+    Base class for HTTP/3 exceptions.
+    """
+
+
+class InvalidStreamTypeError(H3Error):
+    """
+    An action was attempted on an invalid stream type.
+    """
+
+
+class NoAvailablePushIDError(H3Error):
+    """
+    There are no available push IDs left, or push is not supported
+    by the remote party.
+    """