o iP @sdZddlmZddlmZddlmZddlZddlmZddlmZddlm Z e d d d Z ej d kZ eefd ededefddZ eGdd d ZdS)a This files implements typed events models for ``core.dispatch_event`` and ``core.context_with_event`` More specifically, this module defines dataclass-based event objects that are used in two ways: 1. Dispatch-only events with ``core.dispatch_event(event_instance)``. A listener registered with ``core.on(, callback)`` receives the event instance directly. Example:: @dataclass class MyEvent(Event): event_name = "my.event" data: str core.dispatch_event(MyEvent(data="hello")) 2. Context lifecycle events with ``core.context_with_event(event_instance)``. The context manager emits ``context.started.`` and ``context.ended.`` events, and listeners can access the original event through ``ctx.event``. Example:: @dataclass class MyContextEvent(Event): event_name = "my.context" user_id: str = event_field() not_in_context: InitVar[str] = event_field() def __post_init__(self, not_in_context): doSomething() def on_started(ctx): assert ctx.event.user_id == "123" core.on("context.started.my.context", on_started) with core.context_with_event(MyContextEvent(user_id="123")): pass For event classes used with ``core.context_with_event(...)``, use ``event_field()`` for every dataclass attribute: 1. Persistent event attributes (available on ``ctx.event``) should be declared as: ``my_var: MyType = event_field()``. 2. Init-only attributes (consumed during construction but not stored on the instance) should be declared with ``InitVar``: ``my_var: InitVar[MyType] = event_field()``. Those values are available in ``__post_init__``. Defaults must be defined in ``event_field(...)`` (for example ``default=...`` or ``default_factory=...``), not as plain dataclass assignment without ``event_field``. )MISSING) dataclass)fieldN)Any)ClassVar)TypeVar EventTypeEvent)bound) defaultdefault_factoryreturncCsXi}|tur ||d<|tur||d<tr!|tur |tur d|d<nd|d<tdi|S)zCreates a dataclass field with special handling to ensure retro compatibility as python 3.9 does not support kw_only which is required by TracingEvent to allow a child class to have attributes without a default value. r rNTkw_only)r_PY3_9r)r rkwargsrrP/home/ubuntu/.local/lib/python3.10/site-packages/ddtrace/internal/core/events.py event_fieldFsrc@seZdZUdZeeed<dS)r a BaseEvent is an abstraction created to constrain the arguments that can be passed during a call to core.dispatch() or core.context_with_data() It can be used with core.dispatch_event(Event()). Every child class should be annotated with @dataclass event_nameN)__name__ __module__ __qualname____doc__rstr__annotations__rrrrr \s )r dataclassesrrrsystypingrrrr version_inforrr rrrrs 7