103 lines
2.9 KiB
Python
103 lines
2.9 KiB
Python
"""
|
|
``msgio`` is an implementation of `https://github.com/libp2p/go-msgio`.
|
|
|
|
from that repo: "a simple package to r/w length-delimited slices."
|
|
|
|
NOTE: currently missing the capability to indicate lengths by "varint" method.
|
|
"""
|
|
# TODO unify w/ https://github.com/libp2p/py-libp2p/blob/1aed52856f56a4b791696bbcbac31b5f9c2e88c9/libp2p/utils.py#L85-L99 # noqa: E501
|
|
from typing import Optional, cast
|
|
|
|
from libp2p.io.abc import (
|
|
Closer,
|
|
ReadCloser,
|
|
Reader,
|
|
ReadWriteCloser,
|
|
WriteCloser,
|
|
Writer,
|
|
)
|
|
from libp2p.io.utils import read_exactly
|
|
|
|
SIZE_LEN_BYTES = 4
|
|
BYTE_ORDER = "big"
|
|
|
|
|
|
async def read_length(reader: Reader) -> int:
|
|
length_bytes = await read_exactly(reader, SIZE_LEN_BYTES)
|
|
return int.from_bytes(length_bytes, byteorder=BYTE_ORDER)
|
|
|
|
|
|
def encode_msg_with_length(msg_bytes: bytes) -> bytes:
|
|
len_prefix = len(msg_bytes).to_bytes(SIZE_LEN_BYTES, "big")
|
|
return len_prefix + msg_bytes
|
|
|
|
|
|
# NOTE: temporary for this PR
|
|
encode = encode_msg_with_length
|
|
|
|
|
|
# NOTE: temporary for this PR
|
|
async def read_next_message(reader: Reader) -> bytes:
|
|
length = await read_length(reader)
|
|
return await reader.read(length)
|
|
|
|
|
|
class MsgIOWriter(Writer, Closer):
|
|
write_closer: WriteCloser
|
|
|
|
def __init__(self, write_closer: WriteCloser) -> None:
|
|
super().__init__()
|
|
self.write_closer = write_closer
|
|
|
|
async def write(self, data: bytes) -> int:
|
|
await self.write_msg(data)
|
|
return len(data)
|
|
|
|
async def write_msg(self, msg: bytes) -> None:
|
|
data = encode_msg_with_length(msg)
|
|
await self.write_closer.write(data)
|
|
|
|
async def close(self) -> None:
|
|
await self.write_closer.close()
|
|
|
|
|
|
class MsgIOReader(Reader, Closer):
|
|
read_closer: ReadCloser
|
|
next_length: Optional[int]
|
|
|
|
def __init__(self, read_closer: ReadCloser) -> None:
|
|
# NOTE: the following line is required to satisfy the
|
|
# multiple inheritance but `mypy` does not like it...
|
|
super().__init__(read_closer) # type: ignore
|
|
self.read_closer = read_closer
|
|
self.next_length = None
|
|
|
|
async def read(self, n: int = -1) -> bytes:
|
|
return await self.read_msg()
|
|
|
|
async def read_msg(self) -> bytes:
|
|
length = await self.next_msg_len()
|
|
|
|
data = await read_exactly(self.read_closer, length)
|
|
if len(data) < length:
|
|
self.next_length = length - len(data)
|
|
else:
|
|
self.next_length = None
|
|
return data
|
|
|
|
async def next_msg_len(self) -> int:
|
|
if self.next_length is None:
|
|
self.next_length = await read_length(self.read_closer)
|
|
return self.next_length
|
|
|
|
async def close(self) -> None:
|
|
await self.read_closer.close()
|
|
|
|
|
|
class MsgIOReadWriter(MsgIOReader, MsgIOWriter, Closer):
|
|
def __init__(self, read_write_closer: ReadWriteCloser) -> None:
|
|
super().__init__(cast(ReadCloser, read_write_closer))
|
|
|
|
async def close(self) -> None:
|
|
await self.read_closer.close()
|