File size: 1,706 Bytes
e391a84 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 | """
domain/value_objects/device_info.py
────────────────────────────────────
DeviceInfo — immutable value object describing an IoT sensor device.
Value objects have no identity — two DeviceInfo objects with the same
field values are considered equal (enforced by ``frozen=True``).
"""
from __future__ import annotations
from dataclasses import dataclass
from typing import Optional
@dataclass(frozen=True)
class DeviceInfo:
"""
Describes the IoT sensor/device that produced a PPG signal.
Attributes:
device_id: Unique hardware identifier (MAC, serial, etc.).
device_type: Human-readable device category (e.g. ``"PPG Wristband"``).
firmware_version: Firmware version string at time of recording.
manufacturer: Optional manufacturer name.
"""
device_id: str
device_type: str
firmware_version: str
manufacturer: Optional[str] = None
def __post_init__(self) -> None:
if not self.device_id or not self.device_id.strip():
raise ValueError("DeviceInfo.device_id must be a non-empty string")
if not self.device_type or not self.device_type.strip():
raise ValueError("DeviceInfo.device_type must be a non-empty string")
if not self.firmware_version or not self.firmware_version.strip():
raise ValueError("DeviceInfo.firmware_version must be a non-empty string")
def __str__(self) -> str:
return (
f"{self.device_type} [{self.device_id}] "
f"fw={self.firmware_version}"
+ (f" by {self.manufacturer}" if self.manufacturer else "")
)
|