ble_server
Toggle main menu visibility
読み取り中…
検索中…
一致する文字列を見つけられません
chunk_assembler.py
[詳解]
1
"""BLE WriteValueで分割受信した改行区切りフレームを再構成する。"""
2
3
from
__future__
import
annotations
4
5
6
class
AssemblerOverflowError
(ValueError):
7
"""受信フレームが蓄積上限を超え、未完成データを破棄したことを示す。"""
8
9
10
class
ChunkAssembler
:
11
"""区切り文字で分割された入力を、完全なフレーム列へ再構成する。
12
13
Args:
14
max_buffer_bytes: 未完成データの蓄積上限 [bytes]。超過時はバッファを捨てて
15
:class:`AssemblerOverflowError` を送出する。
16
delimiter: フレーム終端として扱う非空のバイト列。既定値は改行1 byte。
17
"""
18
19
def
__init__
(
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()
47
raise
AssemblerOverflowError
(
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]
ble_server.chunk_assembler.AssemblerOverflowError
受信フレームが蓄積上限を超え、未完成データを破棄したことを示す。
定義
chunk_assembler.py:6
ble_server.chunk_assembler.ChunkAssembler
区切り文字で分割された入力を、完全なフレーム列へ再構成する。
定義
chunk_assembler.py:10
ble_server.chunk_assembler.ChunkAssembler._buf
_buf
定義
chunk_assembler.py:30
ble_server.chunk_assembler.ChunkAssembler.feed
list[bytes] feed(self, bytes data)
チャンクを追加し、区切り文字を除いた完全フレームを返す。
定義
chunk_assembler.py:37
ble_server.chunk_assembler.ChunkAssembler.__init__
None __init__(self, int max_buffer_bytes=8192, bytes delimiter=b"\n")
定義
chunk_assembler.py:23
ble_server.chunk_assembler.ChunkAssembler.pending_bytes
int pending_bytes(self)
次の区切り文字を待つ未完成データのサイズ [bytes]。
定義
chunk_assembler.py:33
ble_server.chunk_assembler.ChunkAssembler._max_buffer_bytes
_max_buffer_bytes
定義
chunk_assembler.py:28
ble_server.chunk_assembler.ChunkAssembler._delimiter
_delimiter
定義
chunk_assembler.py:29
ble_server
chunk_assembler.py
構築:
1.18.0