Struct FileReader 

pub struct FileReader { /* private fields */ }

A .verit file read into memory, owning its bytes.

FileView borrows the image it reads, which means it cannot be stored in the same struct as the buffer it points into — so every caller ends up writing the same { bytes: Vec<u8> } wrapper. This is that wrapper, once.

let file = FileReader::open("events.verit")?;
let view = file.view()?;
for i in 0..view.len() {
    println!("{}", view.dump_json(i)?);
}

For a large file, mmap it with your platform’s facility and hand the mapped &[u8] to FileView::open directly — the reader never copies a record either way, and a map avoids reading bytes nothing touches.

Implementations

impl FileReader

pub fn open<P>(path: P) -> Result<FileReader, Error>

where P: AsRef<Path>,

Read and validate a file. Structural errors surface here rather than at first access.

pub fn from_bytes(bytes: Vec<u8>) -> Result<FileReader, Error>

Take ownership of an already-read image, validating it.

pub fn view(&self) -> Result<FileView<'_>, Error>

A zero-copy view over the owned bytes.

pub fn bytes(&self) -> &[u8]

The raw image.

Trait Implementations

impl Clone for FileReader

fn clone(&self) -> FileReader

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FileReader

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.