summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/tools/third_party/websockets/src/websockets/legacy/framing.py
diff options
context:
space:
mode:
Diffstat (limited to 'testing/web-platform/tests/tools/third_party/websockets/src/websockets/legacy/framing.py')
-rw-r--r--testing/web-platform/tests/tools/third_party/websockets/src/websockets/legacy/framing.py42
1 files changed, 22 insertions, 20 deletions
diff --git a/testing/web-platform/tests/tools/third_party/websockets/src/websockets/legacy/framing.py b/testing/web-platform/tests/tools/third_party/websockets/src/websockets/legacy/framing.py
index c4de7eb28b..b77b869e3f 100644
--- a/testing/web-platform/tests/tools/third_party/websockets/src/websockets/legacy/framing.py
+++ b/testing/web-platform/tests/tools/third_party/websockets/src/websockets/legacy/framing.py
@@ -1,6 +1,5 @@
from __future__ import annotations
-import dataclasses
import struct
from typing import Any, Awaitable, Callable, NamedTuple, Optional, Sequence, Tuple
@@ -10,12 +9,11 @@ from ..exceptions import PayloadTooBig, ProtocolError
try:
from ..speedups import apply_mask
-except ImportError: # pragma: no cover
+except ImportError:
from ..utils import apply_mask
class Frame(NamedTuple):
-
fin: bool
opcode: frames.Opcode
data: bytes
@@ -53,16 +51,16 @@ class Frame(NamedTuple):
Read a WebSocket frame.
Args:
- reader: coroutine that reads exactly the requested number of
+ reader: Coroutine that reads exactly the requested number of
bytes, unless the end of file is reached.
- mask: whether the frame should be masked i.e. whether the read
+ mask: Whether the frame should be masked i.e. whether the read
happens on the server side.
- max_size: maximum payload size in bytes.
- extensions: list of extensions, applied in reverse order.
+ max_size: Maximum payload size in bytes.
+ extensions: List of extensions, applied in reverse order.
Raises:
- PayloadTooBig: if the frame exceeds ``max_size``.
- ProtocolError: if the frame contains incorrect values.
+ PayloadTooBig: If the frame exceeds ``max_size``.
+ ProtocolError: If the frame contains incorrect values.
"""
@@ -130,14 +128,14 @@ class Frame(NamedTuple):
Write a WebSocket frame.
Args:
- frame: frame to write.
- write: function that writes bytes.
- mask: whether the frame should be masked i.e. whether the write
+ frame: Frame to write.
+ write: Function that writes bytes.
+ mask: Whether the frame should be masked i.e. whether the write
happens on the client side.
- extensions: list of extensions, applied in order.
+ extensions: List of extensions, applied in order.
Raises:
- ProtocolError: if the frame contains incorrect values.
+ ProtocolError: If the frame contains incorrect values.
"""
# The frame is written in a single call to write in order to prevent
@@ -147,8 +145,11 @@ class Frame(NamedTuple):
# Backwards compatibility with previously documented public APIs
-
-from ..frames import Close, prepare_ctrl as encode_data, prepare_data # noqa
+from ..frames import ( # noqa: E402, F401, I001
+ Close,
+ prepare_ctrl as encode_data,
+ prepare_data,
+)
def parse_close(data: bytes) -> Tuple[int, str]:
@@ -156,14 +157,15 @@ def parse_close(data: bytes) -> Tuple[int, str]:
Parse the payload from a close frame.
Returns:
- Tuple[int, str]: close code and reason.
+ Close code and reason.
Raises:
- ProtocolError: if data is ill-formed.
- UnicodeDecodeError: if the reason isn't valid UTF-8.
+ ProtocolError: If data is ill-formed.
+ UnicodeDecodeError: If the reason isn't valid UTF-8.
"""
- return dataclasses.astuple(Close.parse(data)) # type: ignore
+ close = Close.parse(data)
+ return close.code, close.reason
def serialize_close(code: int, reason: str) -> bytes: