Struct Stage 

pub struct Stage;

The staging operations, which hold no state of their own.

Implementations

impl Stage

pub fn write( destination: &Utf8Path, bytes: &[u8], ) -> Result<Utf8PathBuf, AppError>

Write bytes to a scratch file beside destination.

The name carries this run, and the file is created exclusively, so the write never lands in one somebody else left. A scratch path already taken refuses rather than being reused: nothing proves an existing file came from a run of this tool, and renaming it over the destination would replace the destination with its contents.

Errors

Any I/O error creating the parent, the scratch file, or syncing it.

pub fn write_at( scratch: &Utf8Path, destination: &Utf8Path, bytes: &[u8], ) -> Result<Utf8PathBuf, AppError>

Write bytes to one named scratch path beside destination.

The path is the caller’s, which is what lets a test plant something at it and prove the exclusive create refuses rather than follows.

Errors

As Stage::write.

pub fn replace( scratch: &Utf8Path, destination: &Utf8Path, ) -> Result<(), AppError>

Rename a staged file over its destination and sync the directory.

Errors

Any I/O error of the rename or the sync. The scratch file is removed on failure, so a retry is not blocked by its own leftover.

pub fn discard(scratch: &Utf8Path)

Drop a staged file that will not be used.

Trait Implementations

impl Clone for Stage

fn clone(&self) -> Stage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Stage

impl Debug for Stage

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

Formats the value using the given formatter.