Struct ArtifactBuildTransaction 

pub struct ArtifactBuildTransaction { /* private fields */ }

Owned miss transaction holding the recipe and content-key process locks.

Implementations

impl ArtifactBuildTransaction

pub fn staging_directory(&self) -> &Path

Transaction-owned directory in which the caller may run its build.

Commit accepts only the cache-created outputs child at this root. Callers must remove or relocate logs and other temporary root children.

pub fn output_path(&self, name: &str) -> Result<PathBuf, ArtifactCacheError>

Checked staging destination for one declared logical output.

Errors

Returns ArtifactCacheError::UnknownOutput for an undeclared output name.

pub fn import_output( &self, name: &str, source: &Path, ) -> Result<(), ArtifactCacheError>

Copy a fixed external output into its transaction-owned staging path.

Errors

Returns an unknown-output or atomic source-copy/publication error.

pub fn commit(self) -> Result<ArtifactCacheOutcome, ArtifactCacheError>

Validate the exact staging schema and atomically publish the complete output set.

Errors

Returns staging-schema, output verification, input-change, lock or publication errors. Failed staging cleanup preserves both the transaction and cleanup errors.

pub fn abort(self) -> Result<(), ArtifactCacheError>

Abandon the transaction and synchronously remove its staging directory.

Errors

Returns the filesystem error if removing the owned staging directory fails.

Trait Implementations

impl Drop for ArtifactBuildTransaction

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.