Files
mtusi2026lab3-fork/app/core/instance.py
T
2026-10-30 00:53:49 +03:00

41 lines
1.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""Идентификатор API-реплики и заголовок X-Instance-Id."""
from starlette.middleware.base import BaseHTTPMiddleware, RequestResponseEndpoint
from starlette.requests import Request
from starlette.responses import Response
INSTANCE_ID_HEADER = "X-Instance-Id"
def resolve_instance_id(configured: str | None) -> str:
"""Возвращает id реплики, стабильный в течение жизни процесса.
TODO(3.2): выбрать источник id.
- Если задан непустой INSTANCE_ID в настройках — вернуть его.
- Иначе — что-то, что позволит stop-one.sh найти именно этот контейнер
(подсказка: Docker кладёт короткий id контейнера в переменную HOSTNAME,
а `docker stop <короткий id>` работает).
- Значение вычисляется один раз при старте и не меняется до конца процесса.
"""
raise NotImplementedError("TODO(3.2): resolve_instance_id")
class InstanceIdMiddleware(BaseHTTPMiddleware):
"""Добавляет X-Instance-Id в каждый ответ API, включая ошибки и /health/*.
TODO(3.2): реализовать dispatch по образцу RequestIdMiddleware
(app/core/request_id.py) и подключить в create_app (app/main.py).
Проверьте, что заголовок есть и у ответов из exception handlers.
"""
def __init__(self, app, instance_id: str) -> None:
super().__init__(app)
self.instance_id = instance_id
async def dispatch(
self,
request: Request,
call_next: RequestResponseEndpoint,
) -> Response:
raise NotImplementedError("TODO(3.2): InstanceIdMiddleware.dispatch")