Struct StdFilePusher 

pub struct StdFilePusher { /* private fields */ }

File pusher using a raw std::fs::File with random-access writes and no userspace write buffer.

Every push seeks to range.start and writes directly to the OS. It is intended to be wrapped by a buffering decorator such as crate::BufWriterPusher when syscall batching is desired, or used directly when writes are already large/sequential.

The sync_all flag controls whether fsync is called on flush. A bare std::fs::File has no userspace buffer, so flush itself performs no copying — it only issues fsync when requested.

Implementations

impl StdFilePusher

pub async fn new(file: File, size: u64, sync_all: bool) -> Result<Self>

Errors

Returns an error if fs::set_len fails.

Trait Implementations

impl Debug for StdFilePusher

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

Formats the value using the given formatter.

impl Pusher for StdFilePusher

type Error = Error

Error produced while pushing.

fn set_listener(&mut self, cb: ProgressListener)

Install a callback that fires whenever a chunk has been successfully pushed to its destination.

fn push( &mut self, range: &ProgressEntry, bytes: Bytes, ) -> Result<(), (Self::Error, Bytes)>

Write content covering the given range to the destination.

fn flush(&mut self) -> Result<(), Self::Error>

Flush any buffered data to the destination.