Struct BinlogFile 

pub struct BinlogFile { /* private fields */ }

A MySQL binary log file reader.

Validates the magic bytes on open, parses the FORMAT_DESCRIPTION_EVENT, and provides methods to read individual events or iterate through all of them.

Implementations

impl BinlogFile

pub fn open(path: &str) -> Result<Self, IdbError>

Open a binlog file from the filesystem.

Validates the 4-byte magic header and reads the FORMAT_DESCRIPTION_EVENT.

pub fn from_bytes(data: Vec<u8>) -> Result<Self, IdbError>

Create a binlog reader from in-memory bytes (useful for WASM).

pub fn file_size(&self) -> u64

Total file size in bytes.

pub fn format_description(&self) -> Option<&FormatDescriptionEvent>

The FORMAT_DESCRIPTION_EVENT parsed from the file header, if available.

pub fn has_checksum(&self) -> bool

Whether CRC-32 checksums are enabled for events in this file.

pub fn read_event_at( &mut self, offset: u64, ) -> Result<Option<(CommonEventHeader, BinlogEvent)>, IdbError>

Read and parse the event at the given absolute file offset.

Returns Ok(None) if the offset is at or beyond EOF. Returns the common header and parsed event payload on success.

pub fn events(&mut self) -> BinlogEventIterator<'_>

Return an iterator over all events in the file, starting after the magic bytes.

Each item is (file_offset, CommonEventHeader, BinlogEvent).

pub fn validate_checksum_at( &mut self, offset: u64, ) -> Result<Option<bool>, IdbError>

Validate the CRC-32C checksum of the event at the given offset.

Returns None if the event cannot be read, Some(true) if valid, Some(false) if the checksum does not match.