Struct Store 

pub struct Store { /* private fields */ }

Content-addressed trace store.

root should be an existing directory (typically .shadow/traces/). This struct does NOT create the root on construction — callers can choose whether to pre-create it.

Implementations

impl Store

pub fn new(root: impl Into<PathBuf>) -> Self

Wrap an existing root directory. See SPEC §8 for the layout.

pub fn root(&self) -> &Path

The root directory wrapped by this store.

pub fn put(&self, trace: &[Record]) -> Result<String>

Put a trace. Returns the trace’s root id (the first record’s id).

Writes atomically: the final path does not appear until the write has fully completed and flushed to disk.

pub fn get(&self, trace_id: &str) -> Result<Vec<Record>>

Read a trace by its root content id.

pub fn exists(&self, trace_id: &str) -> bool

Whether a trace with this id is stored.

pub fn list(&self) -> Result<Vec<String>>

Iterate over all trace ids currently in the store.

Walk order is undefined; callers that need a deterministic order should collect and sort.

pub fn path_for(&self, trace_id: &str) -> Result<PathBuf>

Compute the on-disk path for a given trace id. Does NOT create directories or check whether the file exists.