prepare v0.0.2

pymbus/telegrams/base.py

@@ -134,7 +134,3 @@ def fields(self) -> list[TelegramField]:
 
     def as_bytes(self) -> bytes:
         return bytes(field.byte for field in self.fields)
-
-
-class TelegramBlock(TelegramContainer):
-    """Base Telegram Block class."""

pymbus/telegrams/blocks/__init__.py

@@ -0,0 +1,2 @@
+from pymbus.telegrams.blocks.data_info import DataInformationBlock
+from pymbus.telegrams.blocks.value_info import ValueInformationBlock

pymbus/telegrams/blocks/data_info.py

@@ -2,9 +2,11 @@
 
 from pymbus.exceptions import MBusError
 from pymbus.telegrams.base import (
-    TelegramBlock,
     TelegramBytesType,
 )
+from pymbus.telegrams.base import (
+    TelegramContainer as TelegramBlock,
+)
 from pymbus.telegrams.fields.data_info import (
     DataInformationField as DIF,
 )

pymbus/telegrams/blocks/value_info.py

@@ -2,9 +2,11 @@
 
 from pymbus.exceptions import MBusError
 from pymbus.telegrams.base import (
-    TelegramBlock,
     TelegramBytesType,
 )
+from pymbus.telegrams.base import (
+    TelegramContainer as TelegramBlock,
+)
 from pymbus.telegrams.fields.value_info import (
     ValueInformationField as VIF,
 )

pymbus/telegrams/records.py

@@ -0,0 +1,46 @@
+from pymbus.exceptions import MBusError
+from pymbus.telegrams.base import (
+    TelegramBytesType,
+)
+from pymbus.telegrams.base import (
+    TelegramContainer as TelegramRecord,
+)
+from pymbus.telegrams.blocks import (
+    DataInformationBlock as DIB,
+)
+from pymbus.telegrams.blocks import (
+    ValueInformationBlock as VIB,
+)
+
+
+class DataRecord(TelegramRecord):
+    """The "Data Record" (DR) class.
+
+    Typically encountered as Data Record Header (DRH).
+
+    The structure of the DR(H):
+    -----------------
+    |   DIB  |  VIB |
+    -----------------
+
+    DIB = Data Information Block.
+    VIB = Value Information Block.
+    """
+
+    def __init__(self, ibytes: TelegramBytesType):
+        try:
+            it = iter(ibytes)
+        except TypeError as e:
+            msg = f"{ibytes} is not iterable"
+            raise MBusError(msg) from e
+
+        self._dib = DIB(it)
+        self._vib = VIB(it)
+
+    @property
+    def dib(self) -> DIB:
+        return self._dib
+
+    @property
+    def vib(self) -> VIB:
+        return self._vib