Module for reading cassette entries in their stored order.

The CassetteReader is part of Reqord's new architecture that reads cassette entries efficiently without any additional processing.

Features

• Streaming reads: Memory-efficient processing of large cassette files
• Storage backend support: Works with any storage backend implementing Reqord.Storage.Behavior
• Error resilience: Gracefully handles malformed entries with logging

Usage

# Load all entries in stored order
entries = CassetteReader.load_entries("path/to/cassette.jsonl")

# Or stream for memory efficiency
entries = CassetteReader.stream_entries("path/to/cassette.jsonl")

# Check if cassette exists
if CassetteReader.exists?("path/to/cassette.jsonl") do
  # Load and process entries
end

Ordering Guarantee

Entries are returned in the order they appear in the cassette file. Since the CassetteWriter sorts entries by timestamp before writing, the stored order is already chronological.