Struct CapturedArtifact 

pub struct CapturedArtifact { /* private fields */ }

Owned copy of one completed producer output, independent of later source replacement.

Keep this record alive through every use of Self::path. The copy is temporary rather than a reusable cache entry; dropping its owner removes it.

Implementations

impl CapturedArtifact

pub fn capture( source: &Path, parent: &Path, maximum_bytes: usize, ) -> Result<Self>

Capture an output synchronously before another producer can overwrite it.

The caller keeps the source stable during capture and selects the maximum readable byte count. Read/publication failures retain their typed causes inside the returned I/O error. Existing public destinations are untouched.

Errors

Returns the source read/byte-limit, staging allocation or durable-write error. An unsuccessful capture performs best-effort staging cleanup.

pub fn path(&self) -> &Path

Borrow the exact captured bytes while this record owns their lifetime.

pub fn close(self) -> Result<()>

Remove the captured output and its owned staging child, reporting cleanup failure.

Errors

Returns the filesystem error if removing the owned child fails.

Trait Implementations

impl Debug for CapturedArtifact

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

Formats the value using the given formatter.