Coverage for src/copytrading_engine/shared/queue_snapshot.py: 100%
22 statements
« prev ^ index » next coverage.py v7.16.2, created at 2026-11-16 16:55 +0000
« prev ^ index » next coverage.py v7.16.2, created at 2026-11-16 16:55 +0000
1"""Immutable observations shared by durable queue stores and operators."""
3import datetime as dt
4from dataclasses import dataclass
7@dataclass(frozen=True)
8class QueueSnapshot:
9 count: int
10 oldest_at: dt.datetime | None
11 unknown_age_count: int
13 def __post_init__(self) -> None:
14 if type(self.count) is not int or type(self.unknown_age_count) is not int:
15 raise ValueError("Queue counts must be integers")
16 if not 0 <= self.unknown_age_count <= self.count:
17 raise ValueError("Unknown-age count must be between zero and pending count")
18 has_known_age = self.count > self.unknown_age_count
19 if has_known_age != (self.oldest_at is not None):
20 raise ValueError("Oldest timestamp must exist exactly when a pending age is known")
21 if self.oldest_at is not None:
22 if not isinstance(self.oldest_at, dt.datetime) or self.oldest_at.utcoffset() is None:
23 raise ValueError("Queue timestamps must be timezone-aware datetimes")
24 if self.oldest_at.timestamp() <= 0:
25 raise ValueError("Queue timestamps must be after the telemetry zero sentinel")
27 @classmethod
28 def from_row(cls, row: tuple[int, dt.datetime | None, int] | None) -> QueueSnapshot:
29 if row is None:
30 raise RuntimeError("Queue observation query returned no row")
31 return cls(*row)