Struct OpenFile 

pub struct OpenFile { /* private fields */ }

One open file handle serving positioned reads of a local plaintext file.

Opening reads no content: a local file’s current bytes are the answer to a read of it, and the one place a blob’s bytes are checked against the hash its row declares is publication, where they become canonical synced content. A read here is a read.

The handle is held for the reader’s life rather than reopened per range, and that is a property, not an optimization: a path can be replaced between two reads, a descriptor cannot, so every range comes from the one file that was opened even if it is later evicted, renamed, or replaced.

Each read positions the descriptor itself, and the mutex makes that seek and its read one operation, so concurrent readers of one handle cannot interleave into each other’s ranges.

Implementations

impl OpenFile

pub async fn open(path: &Path) -> Result<Self, FileError>

Open path and stat it for the length its reads are bounded by.

pub fn size(&self) -> u64

pub async fn read_at(&self, offset: u64, len: u64) -> Result<Vec<u8>, FileError>

Read exactly len bytes at offset. The caller bounds the range against size; a file that cannot supply them is an error, never a short result.