Skip to content

test_events

ipw.tests.telemetry.test_events

Tests for telemetry/events.py — EventRecorder and AgentEvent.

TestEventType

Test EventType enum values.

Source code in intelligence-per-watt/src/ipw/tests/telemetry/test_events.py 
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
class TestEventType:
    """Test EventType enum values."""

    def test_lm_inference_events_exist(self) -> None:
        assert EventType.LM_INFERENCE_START.value == "lm_inference_start"
        assert EventType.LM_INFERENCE_END.value == "lm_inference_end"

    def test_tool_call_events_exist(self) -> None:
        assert EventType.TOOL_CALL_START.value == "tool_call_start"
        assert EventType.TOOL_CALL_END.value == "tool_call_end"

    def test_prefill_decode_events_exist(self) -> None:
        assert EventType.PREFILL_START.value == "prefill_start"
        assert EventType.PREFILL_END.value == "prefill_end"
        assert EventType.DECODE_START.value == "decode_start"
        assert EventType.DECODE_END.value == "decode_end"

    def test_submodel_events_exist(self) -> None:
        assert EventType.SUBMODEL_CALL_START.value == "submodel_call_start"
        assert EventType.SUBMODEL_CALL_END.value == "submodel_call_end"

    def test_is_string_enum(self) -> None:
        assert isinstance(EventType.LM_INFERENCE_START, str)

TestAgentEvent

Test AgentEvent dataclass.

Source code in intelligence-per-watt/src/ipw/tests/telemetry/test_events.py 
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
class TestAgentEvent:
    """Test AgentEvent dataclass."""

    def test_creation(self) -> None:
        event = AgentEvent(
            event_type="tool_call_start",
            timestamp=1234567890.0,
            metadata={"tool": "calculator"},
        )
        assert event.event_type == "tool_call_start"
        assert event.timestamp == 1234567890.0
        assert event.metadata == {"tool": "calculator"}

    def test_default_metadata(self) -> None:
        event = AgentEvent(event_type="test", timestamp=0.0)
        assert event.metadata == {}

    def test_repr(self) -> None:
        event = AgentEvent(event_type="test", timestamp=1.0, metadata={"k": "v"})
        r = repr(event)
        assert "test" in r
        assert "1.000" in r

TestEventRecorder

Test EventRecorder functionality.

Source code in intelligence-per-watt/src/ipw/tests/telemetry/test_events.py 
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
class TestEventRecorder:
    """Test EventRecorder functionality."""

    def test_record_creates_event_with_timestamp(self) -> None:
        recorder = EventRecorder()
        before = time.time()
        recorder.record("test_event", key="value")
        after = time.time()

        events = recorder.get_events()
        assert len(events) == 1
        assert events[0].event_type == "test_event"
        assert events[0].metadata == {"key": "value"}
        assert before <= events[0].timestamp <= after

    def test_get_events_returns_copy(self) -> None:
        recorder = EventRecorder()
        recorder.record("event1")
        events = recorder.get_events()
        events.append(AgentEvent(event_type="fake", timestamp=0.0))
        assert len(recorder.get_events()) == 1

    def test_clear_empties_events(self) -> None:
        recorder = EventRecorder()
        recorder.record("event1")
        recorder.record("event2")
        assert len(recorder) == 2

        recorder.clear()
        assert len(recorder) == 0
        assert recorder.get_events() == []

    def test_len(self) -> None:
        recorder = EventRecorder()
        assert len(recorder) == 0
        recorder.record("a")
        assert len(recorder) == 1
        recorder.record("b")
        assert len(recorder) == 2

    def test_thread_safety_concurrent_recording(self) -> None:
        recorder = EventRecorder()
        num_threads = 10
        events_per_thread = 100
        barrier = threading.Barrier(num_threads)

        def worker(thread_id: int) -> None:
            barrier.wait()
            for i in range(events_per_thread):
                recorder.record(f"thread_{thread_id}", index=i)

        threads = [
            threading.Thread(target=worker, args=(tid,))
            for tid in range(num_threads)
        ]
        for t in threads:
            t.start()
        for t in threads:
            t.join()

        events = recorder.get_events()
        assert len(events) == num_threads * events_per_thread

    def test_events_maintain_chronological_order(self) -> None:
        recorder = EventRecorder()
        for i in range(10):
            recorder.record(f"event_{i}")

        events = recorder.get_events()
        timestamps = [e.timestamp for e in events]
        assert timestamps == sorted(timestamps)

    def test_metadata_storage(self) -> None:
        recorder = EventRecorder()
        recorder.record(
            "tool_call_end",
            tool="calculator",
            result="42",
            latency_ms=5.0,
        )
        events = recorder.get_events()
        assert events[0].metadata["tool"] == "calculator"
        assert events[0].metadata["result"] == "42"
        assert events[0].metadata["latency_ms"] == 5.0

TestEventRecorderFixture

Test the sample_event_recorder fixture from conftest.

Source code in intelligence-per-watt/src/ipw/tests/telemetry/test_events.py 
148
149
150
151
152
153
154
155
156
157
class TestEventRecorderFixture:
    """Test the sample_event_recorder fixture from conftest."""

    def test_has_pre_populated_events(self, sample_event_recorder: EventRecorder) -> None:
        events = sample_event_recorder.get_events()
        assert len(events) == 4
        assert events[0].event_type == "lm_inference_start"
        assert events[1].event_type == "tool_call_start"
        assert events[2].event_type == "tool_call_end"
        assert events[3].event_type == "lm_inference_end"