asam-osi-utilities 0.2.1

Python utilities for reading and writing ASAM OSI trace files (MCAP, binary .osi, text .txth)

osi-utilities (Python)

Python utilities for reading and writing ASAM OSI (Open Simulation Interface) trace files.

Supported Formats

• MCAP (.mcap) — Multi-channel container format with metadata
• Binary (.osi) — Single-channel binary format with length-prefixed protobuf messages
• Text (.txth) — Human-readable protobuf TextFormat

Installation

From PyPI:

pip install asam-osi-utilities

For development (uses a virtual environment):

make setup    # creates .venv and installs in editable mode

Quick Start

from osi_utilities import open_trace_file

# Read any supported format (auto-detected from extension)
with open_trace_file("trace.mcap") as reader:
    for result in reader:
        print(result.message_type, result.message)

Development

make setup      # Create venv and install dependencies
make test       # Run tests
make lint       # Run linter
make format     # Format code
make typecheck  # Run type checker