docs(core): уточнить тип event_dict в docstring add_trace_id

EventDict указан как фактический тип параметра из аннотации,
MutableMapping[str, Any] оставлен как пояснение эквивалентности.
This commit is contained in:
Returner_org 2026-06-28 20:43:33 +03:00
parent 64dc595a7a
commit ebdfa07c1f

View File

@ -20,7 +20,7 @@ def add_trace_id(event_dict: EventDict):
параметра: structlog передаёт ``event_dict`` напрямую, потому что первые два
аргумента нигде в теле функции не нужны.
:param event_dict: ``MutableMapping[str, Any]`` (в терминах structlog ``EventDict``):
:param event_dict: ``EventDict`` (structlog-тип из ``structlog.typing``, эквивалентный ``MutableMapping[str, Any]``):
словарь с накопленными к данному моменту данными лог-записи (поля, добавленные
предыдущими процессорами и вызывающим кодом). Процессор мутирует его,
добавляя ключ ``"trace_id"``, и обязан вернуть его дальше по цепочке.