Struct ExternalStore 

pub struct ExternalStore { /* private fields */ }

A store backed by a third-party snapdir-<name>-store binary, dispatched through the emit-command contract.

Construct with ExternalStore::new (resolving the binary name from the store URL’s protocol via the router) or ExternalStore::with_binary (to point at a specific binary path/name, e.g. a mock in tests).

Implementations

impl ExternalStore

pub fn new(store_url: &str) -> Result<Self, StoreError>

Builds a shim for store_url, resolving the third-party binary name from its protocol via resolve_adapter.

Errors

Returns StoreError::Backend if the store URL’s protocol is invalid, or if it resolves to a built-in adapter (file/s3/b2/gcs) — those are served in-process and must not be routed through the shim.

pub fn with_binary(store_url: &str, binary: impl Into<PathBuf>) -> Self

Builds a shim that dispatches to an explicit binary (path or name on PATH) for store_url, bypassing protocol resolution.

Useful for tests (pointing at a mock store script) and for honoring an explicit _SNAPDIR_<PROTO>_STORE_BIN_PATH-style override.

pub fn with_shell(self, shell: impl Into<String>) -> Self

Overrides the shell used to eval emitted scripts (default bash).

pub fn binary(&self) -> &Path

The resolved store binary name/path.

Trait Implementations

impl Clone for ExternalStore

fn clone(&self) -> ExternalStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExternalStore

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

Formats the value using the given formatter.

impl Store for ExternalStore

fn get_manifest(&self, id: &str) -> Result<Manifest, StoreError>

Reads and parses the manifest stored under id’s sharded path, verifying that its bytes hash back to id before returning it.

fn fetch_files( &self, manifest: &Manifest, dest: &Path, ) -> Result<(), StoreError>

Materializes every entry of manifest under dest, pulling each referenced object from the store and reconstructing the directory tree (files, directories, permissions) rooted at dest.

fn push(&self, manifest: &Manifest, source: &Path) -> Result<(), StoreError>

Uploads the objects referenced by manifest (reading their bytes from the tree rooted at source) and then the manifest itself, filing each under its sharded address.