Struct Snapshot 

pub struct Snapshot { /* private fields */ }

One run’s snapshot directory, claimed when the run first needs it.

Implementations

impl Snapshot

pub fn begin(canonical_target: &Path) -> Result<Self, RkError>

Claim the snapshot directory for one run against canonical_target.

A caller begins a snapshot only at its first destructive step, so a run that saves nothing claims nothing.

Errors

A prerequisite-unmet refusal where no state root resolves, because a destructive step that cannot save first does not run, and RkError::Io where the directory cannot be created.

pub const fn at(root: PathBuf) -> Self

A snapshot rooted at root, for a workspace that names its own.

pub fn root(&self) -> &Path

The directory this snapshot writes under.

pub fn save(&self, relative: &Path, bytes: &[u8]) -> Result<PathBuf, RkError>

Save bytes at relative below the snapshot, owner-only, and return where. A copy already standing there with the same bytes is kept; one with other bytes refuses, because overwriting a backup loses the bytes it exists to keep.

Errors

A state-drift refusal for a saved copy with other bytes, and RkError::Io for a write that fails.

pub fn save_replaced( &self, destination: &str, bytes: &[u8], ) -> Result<PathBuf, RkError>

Save a replaced file’s bytes under replaced/<destination>.

Errors

As Self::save.

Trait Implementations

impl Clone for Snapshot

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Snapshot

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

Formats the value using the given formatter.