Struct ArtifactStore 

pub struct ArtifactStore { /* private fields */ }

Implementations

impl ArtifactStore

pub fn new() -> Self

pub fn with_limits(limits: ArtifactStoreLimits) -> Self

pub fn put(&self, artifact: ToolArtifact)

pub fn put_content_addressed( &self, artifact: ToolArtifact, ) -> Result<bool, ArtifactStoreError>

Insert an artifact without allowing an existing URI to be overwritten.

Exact replay is idempotent and returns Ok(false). A URI collision with different bytes or metadata fails closed and leaves the retained artifact untouched. Retention eviction remains explicit store policy: after an object is evicted, a later create-only write may reinsert its URI because the store no longer owns that historical object.

pub fn get(&self, artifact_uri: &str) -> Option<ToolArtifact>

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn total_bytes(&self) -> usize

pub fn limits(&self) -> ArtifactStoreLimits

pub fn artifacts(&self) -> Vec<ToolArtifact>

pub fn pin_uris(&self, uris: impl IntoIterator<Item = impl Into<String>>)

Pin artifact URIs so limit eviction and unreferenced GC cannot remove content still reachable from a retained identity (STORE-GC1).

pub fn set_retained_uris( &self, uris: impl IntoIterator<Item = impl Into<String>>, )

Replace the retained URI set with exactly the supplied roots.

pub fn retained_uris(&self) -> HashSet<String>

pub fn gc_unreferenced(&self) -> usize

Remove artifacts that are not in the retained root set.

Returns the number of removed objects. Retained roots that are absent from the store are ignored; present retained objects are never removed.

pub fn save_to_dir(&self, dir: impl AsRef<Path>) -> Result<()>

pub fn load_from_dir(dir: impl AsRef<Path>) -> Result<Self>

pub fn load_from_manifest_bytes(bytes: &[u8]) -> Result<Self>

pub fn load_from_manifest_bytes_with_limits( bytes: &[u8], limits: ArtifactStoreLimits, ) -> Result<Self>

pub fn load_from_dir_with_limits( dir: impl AsRef<Path>, limits: ArtifactStoreLimits, ) -> Result<Self>

Trait Implementations

impl Clone for ArtifactStore

fn clone(&self) -> ArtifactStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArtifactStore

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

Formats the value using the given formatter.

impl Default for ArtifactStore

fn default() -> Self

Returns the “default value” for a type.