ble_server
読み取り中…
検索中…
一致する文字列を見つけられません
chunk_assembler.py
[詳解]
1"""BLE WriteValueで分割受信した改行区切りフレームを再構成する。"""
2
3from __future__ import annotations
4
5
6class AssemblerOverflowError(ValueError):
7 """受信フレームが蓄積上限を超え、未完成データを破棄したことを示す。"""
8
9
11 """区切り文字で分割された入力を、完全なフレーム列へ再構成する。
12
13 Args:
14 max_buffer_bytes: 未完成データの蓄積上限 [bytes]。超過時はバッファを捨てて
15 :class:`AssemblerOverflowError` を送出する。
16 delimiter: フレーム終端として扱う非空のバイト列。既定値は改行1 byte。
17 """
18
20 self,
21 max_buffer_bytes: int = 8192,
22 delimiter: bytes = b"\n",
23 ) -> None:
24 if max_buffer_bytes <= 0:
25 raise ValueError("max_buffer_bytes must be positive")
26 if not delimiter:
27 raise ValueError("delimiter must not be empty")
28 self._max_buffer_bytes = max_buffer_bytes
29 self._delimiter = delimiter
30 self._buf = bytearray()
31
32 @property
33 def pending_bytes(self) -> int:
34 """次の区切り文字を待つ未完成データのサイズ [bytes]。"""
35 return len(self._buf)
36
37 def feed(self, data: bytes) -> list[bytes]:
38 """チャンクを追加し、区切り文字を除いた完全フレームを返す。
39
40 空入力と空フレームは無視する。末尾の未完成データは次回まで保持する。
41 """
42 if not data:
43 return []
44 self._buf += data
45 if len(self._buf) > self._max_buffer_bytes:
46 self._buf.clear()
48 f"buffer exceeded {self._max_buffer_bytes} bytes; cleared"
49 )
50 parts = bytes(self._buf).split(self._delimiter)
51 self._buf = bytearray(parts.pop())
52 return [p for p in parts if p]
受信フレームが蓄積上限を超え、未完成データを破棄したことを示す。
区切り文字で分割された入力を、完全なフレーム列へ再構成する。
list[bytes] feed(self, bytes data)
チャンクを追加し、区切り文字を除いた完全フレームを返す。
None __init__(self, int max_buffer_bytes=8192, bytes delimiter=b"\n")
int pending_bytes(self)
次の区切り文字を待つ未完成データのサイズ [bytes]。