Struct FileNarSource 

pub struct FileNarSource { /* private fields */ }

A NarSource over a file on disk.

Each open is a fresh File read in NAR_CHUNK_BYTES steps — O(chunk) resident regardless of file size. This is what a spooled HTTP upload and a local-tier promotion both ride on.

Implementations

impl FileNarSource

pub fn new(path: impl Into<PathBuf>) -> FileNarSource

Source the file at path. The length is probed lazily on first size_hint caller demand — construction does no I/O, so a missing file surfaces at open where it can be reported.

pub fn with_len(path: impl Into<PathBuf>, len: u64) -> FileNarSource

Source the file at path, recording a known byte length.

pub fn path(&self) -> &Path

The file this source reads.

Trait Implementations

impl Clone for FileNarSource

fn clone(&self) -> FileNarSource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileNarSource

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

Formats the value using the given formatter.

impl NarSource for FileNarSource

fn size_hint(&self) -> Option<u64>

Total byte length if it is known before reading. Backends use it to size a multipart upload or to reject an over-cap value before reading a single byte; None is always legal and must never be load-bearing.

fn open<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Pin<Box<dyn Stream<Item = Result<Bytes, StoreError>> + Send>>, StoreError>> + Send + 'async_trait>>

where 'life0: 'async_trait, FileNarSource: 'async_trait,

Open a fresh chunk stream over the same bytes.