Struct AtomicOutput 

pub struct AtomicOutput { /* private fields */ }

A temporary output staged beside its final destination.

Dropping this value before a successful commit removes the staged file.

Implementations

impl AtomicOutput

pub fn new(destination: impl AsRef<Path>) -> Result<Self, String>

Create a new staged output in the destination’s parent directory.

pub fn staged_path(&self) -> &Path

Return the private staged-file path held by this transaction.

The path is valid only while this value is alive and has not been committed. It is exposed so a supervising application can durably record the exact artifact that must be considered after an abrupt process exit; callers must never publish or reopen it as user output.

pub fn new_private(destination: impl AsRef<Path>) -> Result<Self, String>

Create a staged output whose newly published destination remains owner-only.

Private outputs may only be committed with CommitMode::NoClobber. This is intended for secret key material: the stage is private from its creation and the final pathname never temporarily inherits ordinary output permissions.

pub fn file_mut(&mut self) -> &mut File

Return the open staged file.

pub fn destination_path(&self) -> &Path

Return the resolved destination fixed when this transaction was created.

This is the exact sibling destination against which staged_path was created and security-checked.

pub fn commit(self, mode: CommitMode) -> Result<(), String>

Flush and atomically commit the staged file.