Source code for server.app.dtos.NtpExtraDetails

from dataclasses import dataclass
from server.app.dtos.PreciseTime import PreciseTime




@dataclass
class NtpExtraDetails:
    """
    Represents additional measurements for a given NTP server. 

    Attributes:
        root_delay (PreciseTime): Total round-trip delay to the primary reference source
        poll (int): The poll interval (seconds) used by the probe during the measurement
        root_dispersion (PreciseTime): An estimate (seconds) of the maximum error due to clock frequency stability
        ntp_last_sync_time (PreciseTime): Last time the server was synchronized
        leap (int): 2-bit leap indicator; A value of 3 (11 in binary) represents an unsynchronized clock
    """
    root_delay: PreciseTime
    poll: int
    root_dispersion: PreciseTime
    ntp_last_sync_time: PreciseTime
    leap: int

    def __post_init__(self) -> None:
        if not isinstance(self.root_delay, PreciseTime):
            raise TypeError(f"root_delay must be a PreciseTime, got {type(self.root_delay).__name__}")
        if not isinstance(self.root_dispersion, PreciseTime):
            raise TypeError(f"root_dispersion must be a PreciseTime, got {type(self.root_dispersion).__name__}")
        if not isinstance(self.ntp_last_sync_time, PreciseTime):
            raise TypeError(f"ntp_last_sync_time must be a PreciseTime, got {type(self.ntp_last_sync_time).__name__}")
        if not isinstance(self.leap, int | float):
            raise TypeError(f"leap must be an integer, got {type(self.leap).__name__}")
        if not isinstance(self.poll, int | float):
            raise TypeError(f"poll must be an integer, got {type(self.poll).__name__}")