TXTHTraceFileReader

class osi_utilities.tracefile.txth_reader.TXTHTraceFileReader(message_type=MessageType.UNKNOWN)

Bases: TraceFileReader

Reader for text human-readable OSI trace files (.txth).

Messages are stored in Google protobuf TextFormat. Each message is delimited by reading until the text can be parsed as a complete message.

Parameters:

message_type (MessageType)

open(path)

Open a .txth trace file.

Parameters:

path (Path) – Path to the .txth file.

Returns:

True on success, False on failure.

Return type:

bool

read_message()

Read the next message from the text trace file.

Returns:

ReadResult on success, None if no more messages.

Raises:

RuntimeError – If parsing fails.

Return type:

ReadResult | None

has_next()

Check if there are more messages to read.

Return type:

bool

close()

Close the trace file and release resources.

Return type:

None

property message_type: MessageType