38 lines
1.1 KiB
Python
38 lines
1.1 KiB
Python
from __future__ import annotations
|
|
|
|
from dataclasses import dataclass, field
|
|
from typing import Optional
|
|
from uuid import uuid4
|
|
|
|
from fastapi import Request
|
|
|
|
|
|
@dataclass(frozen=True)
|
|
class RequestContext:
|
|
"""Minimal request-scoped metadata passed into application services."""
|
|
|
|
request_id: str
|
|
api_key: Optional[str] = None
|
|
client_host: Optional[str] = None
|
|
is_local: bool = False
|
|
metadata: dict[str, str] = field(default_factory=dict)
|
|
|
|
|
|
def build_request_context(
|
|
request: Optional[Request] = None,
|
|
*,
|
|
api_key: Optional[str] = None,
|
|
request_id: Optional[str] = None,
|
|
metadata: Optional[dict[str, str]] = None,
|
|
) -> RequestContext:
|
|
"""Create a stable request context without leaking FastAPI internals into services."""
|
|
client_host = request.client.host if request and request.client else None
|
|
is_local = client_host in {"127.0.0.1", "::1", "localhost", "testclient"}
|
|
return RequestContext(
|
|
request_id=request_id or uuid4().hex,
|
|
api_key=api_key,
|
|
client_host=client_host,
|
|
is_local=is_local,
|
|
metadata=dict(metadata or {}),
|
|
)
|