Struct ArtifactHandle 

pub struct ArtifactHandle { /* private fields */ }

One immutable content snapshot captured during Artifact admission.

Implementations

impl ArtifactHandle

pub fn open( path: impl Into<PathBuf>, expected_digest: &str, expected_size: u64, ) -> Result<Self, RuntimeFailure>

Verifies one regular file and snapshots it in a process-private directory selected by the Host’s system-temporary policy, independently of the source path. Strict isolation or path-based execution on a no-exec temporary filesystem should use Self::open_with_staging_root with a Host-owned executable root.

pub fn open_with_staging_root( path: impl Into<PathBuf>, expected_digest: &str, expected_size: u64, staging_root: impl AsRef<Path>, ) -> Result<Self, RuntimeFailure>

Verifies one Artifact and places its private stable copy under an explicit Host-owned root. Process-capable Hosts should select a root on a filesystem that permits execution.

pub fn path(&self) -> &Path

Returns the private stable copy containing the bytes admitted by this Handle. It is never serialized into a Plan.

pub fn source_path(&self) -> &Path

Returns the original machine-local selection path for relative resource policy.

pub fn digest(&self) -> &str

Returns the verified content identity.

pub const fn size(&self) -> u64

Returns the verified byte size.

pub fn read_verified(&self) -> Result<Vec<u8>, RuntimeFailure>

Returns the exact bytes captured during admission.

Trait Implementations

impl Clone for ArtifactHandle

fn clone(&self) -> ArtifactHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactHandle

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

Formats the value using the given formatter.

impl Eq for ArtifactHandle

impl PartialEq for ArtifactHandle

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.