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

1"""Immutable observations shared by durable queue stores and operators.""" 

2 

3import datetime as dt 

4from dataclasses import dataclass 

5 

6 

7@dataclass(frozen=True) 

8class QueueSnapshot: 

9 count: int 

10 oldest_at: dt.datetime | None 

11 unknown_age_count: int 

12 

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") 

26 

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)