Struct FileHandle 

pub struct FileHandle { /* private fields */ }

Unified file handle for both inline (mmap/RAM) and lazy (HTTP/filesystem) access.

Replaces the previous FileSlice, LazyFileHandle, and LazyFileSlice types.

• Inline: data is available synchronously (mmap, RAM). Sync reads via read_bytes_range_sync.
• Lazy: data is fetched on-demand via async callback (HTTP, filesystem).

Use .slice() to create sub-range views (zero-copy for Inline, offset-adjusted for Lazy).

Implementations

impl FileHandle

pub fn from_bytes(data: OwnedBytes) -> Self

Create an inline file handle from owned bytes (mmap, RAM). Sync reads are available.

pub fn empty() -> Self

Create an empty file handle.

pub fn lazy(len: u64, read_fn: RangeReadFn) -> Self

Create a lazy file handle from an async range-read callback. Only async reads are available.

pub fn len(&self) -> u64

Total length in bytes.

pub fn is_empty(&self) -> bool

Check if empty.

pub fn is_sync(&self) -> bool

Whether synchronous reads are available (inline/mmap data).

pub fn slice(&self, range: Range<u64>) -> Self

Create a sub-range view. Zero-copy for Inline, offset-adjusted for Lazy.

pub async fn read_bytes_range(&self, range: Range<u64>) -> Result<OwnedBytes>

Async range read — works for both Inline and Lazy.

pub async fn read_bytes(&self) -> Result<OwnedBytes>

Read all bytes.

pub fn read_bytes_range_sync(&self, range: Range<u64>) -> Result<OwnedBytes>

Synchronous range read — only works for Inline handles. Returns Err if the handle is Lazy.

pub fn read_bytes_sync(&self) -> Result<OwnedBytes>

Synchronous read of all bytes — only works for Inline handles.

Trait Implementations

impl Clone for FileHandle

fn clone(&self) -> FileHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileHandle

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

Formats the value using the given formatter.