Struct RecordingWriter 

pub struct RecordingWriter<W: Write> { /* private fields */ }

Writes a compact binary recording: a version header, then length-framed events with fixed little-endian numbers, optional-id flags and UTF-8 symbols. Version 2 retains resting order participant and placement metadata. No runtime or filesystem policy is imposed; a host can use a buffered file on native targets or bytes in a browser.

Implementations

impl<W: Write> RecordingWriter<W>

pub fn new(writer: W) -> Result<Self>

Writes the version header to a new recording.

pub fn write(&mut self, event: &ReplayEvent) -> Result<()>

Appends an event without flushing the underlying stream. Invalid data writes nothing.

pub fn capture( &mut self, events: impl IntoIterator<Item = Result<ReplayEvent>>, ) -> Result<()>

Records a host event stream until it ends or either reading or writing fails. The first error is returned unchanged; previously written complete events remain in the stream. Run blocking streams outside the UI thread and call Self::finish to flush storage.

pub fn get_ref(&self) -> &W

Borrows the underlying writer without flushing buffered storage.

pub fn finish(self) -> Result<W>

Flushes and returns the underlying writer. Propagates disk and stream errors.