Files
mtusi2026lab3/src/clock.py
T

52 lines
2.3 KiB
Python

"""Время сервера: монотонные часы и формат RFC 3339.
`created_at` задаёт порядок истории `(created_at, id)`. Системные часы
могут шагнуть назад (NTP) или выдать одно значение двум записям подряд.
`MonotonicClock` отдаёт строго возрастающее время с шагом не меньше 1 мкс.
Хранилище берёт время у него перед вставкой. Процесс один, event loop
один, а `now()` не содержит `await`: два вызова не перемешаются.
Строгий рост — внутри одного процесса. Транзакции фиксируются не в том
порядке, в каком получили время, поэтому запись с меньшим `created_at`
может стать видимой чуть позже соседней (REPORT.md, «Пагинация»).
"""
from datetime import UTC, datetime, timedelta
# RFC 3339 в UTC: всегда шесть знаков микросекунд и суффикс Z
RFC3339_FORMAT = "%Y-%m-%dT%H:%M:%S.%fZ"
_TICK = timedelta(microseconds=1)
class MonotonicClock:
"""Строго возрастающее aware-время UTC.
Не потокобезопасен: вызывается только из event loop процесса.
"""
def __init__(self) -> None:
self._last: datetime | None = None
def now(self) -> datetime:
current = datetime.now(UTC)
if self._last is not None and current <= self._last:
current = self._last + _TICK
self._last = current
return current
def utc_now() -> datetime:
"""Текущее время UTC без монотонной поправки: для сравнения со сроком."""
return datetime.now(UTC)
def to_rfc3339(value: datetime) -> str:
"""Время для ответа API: `2026-09-01T12:00:00.000000Z`."""
return value.astimezone(UTC).strftime(RFC3339_FORMAT)
def from_rfc3339(value: str) -> datetime:
"""Обратно из `to_rfc3339()`: aware-время UTC с микросекундами."""
return datetime.strptime(value, RFC3339_FORMAT).replace(tzinfo=UTC)