101 lines
2.1 KiB
Python
101 lines
2.1 KiB
Python
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."
|