16 from tracetool import read_events, Event
75 …"""Deserialize trace records from a file, yielding record tuples (event, event_num, timestamp, pid…
78         event_mapping (str -> Event): events dict, indexed by name
84     dropped_event = Event.build("Dropped_Event(uint64_t num_events_dropped)",
91     # If there is no header assume event ID mapping matches events list
93         for event_id, event in enumerate(events):
94             event_id_to_name[event_id] = event.name
110                 event = event_mapping[event_name]
113                     f'{e} event is logged but is not declared in the trace events'
119             for type, _ in event.args:
143     If a method matching a trace event name exists, it is invoked to process
147     The following method handles the runstate_set(int new_state) trace event::
152     The method can also take a timestamp argument before the trace event
171     def catchall(self, event, rec):  argument
172         """Called if no specific method for processing a trace event has been found."""
175     def _build_fn(self, event):  argument
176         fn = getattr(self, event.name, None)
181         event_argcount = len(event.args)
193     def _process_event(self, rec_args, *, event, event_id, timestamp_ns, pid, **kwargs):  argument
206             self._fn_cache[event_id] = self._build_fn(event)
207         self._fn_cache[event_id](event, rec)
230     If a method matching a trace event name exists, it is invoked to process
238         event: Event object of current trace
239         event_id: The id of the event in the current trace file
244     The following method handles the runstate_set(int new_state) trace event::
250     trace event arguments::
264     def catchall(self, *rec_args, event, timestamp_ns, pid, event_id, **kwargs):  argument
265         """Called if no specific method for processing a trace event has been found."""
268     def _process_event(self, rec_args, *, event, **kwargs):  argument
269         fn = getattr(self, event.name, self.catchall)
270         fn(*rec_args, event=event, **kwargs)
273     """Invoke an analyzer on each event in a log.
275 …object or list or str): events list or file-like object or file path as str to read event data from
277         analyzer (Analyzer): Instance of Analyzer to interpret the event data
305         analyzer (Analyzer): the Analyzer to interpret the event data
313 …for event, event_id, timestamp_ns, record_pid, *rec_args in read_trace_records(events, log_fobj, r…
316                 event=event,
343         def catchall(self, *rec_args, event, timestamp_ns, pid, event_id):  argument
351                 for r, (type, name) in zip(rec_args, event.args)
353             print(f'{event.name} {delta_ns / 1000:0.3f} {pid=} ' + ' '.join(fields))