Struct FsStore 

pub struct FsStore { /* private fields */ }

A store whose objects are files under root. Cloning shares the same root.

Implementations

impl FsStore

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

Create a store rooted at root. The directory is created on first write.

Trait Implementations

impl Clone for FsStore

fn clone(&self) -> FsStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Store for FsStore

fn get(&self, key: &str) -> Result<Option<Vec<u8>>>

Fetch the bytes at key, or None if absent.

fn put(&self, key: &str, bytes: &[u8]) -> Result<()>

Store bytes at key, overwriting any existing object.

fn exists(&self, key: &str) -> Result<bool>

Whether an object exists at key.

fn put_if_absent(&self, key: &str, bytes: &[u8]) -> Result<bool>

Atomically write bytes at key only if no object exists there. Returns true if it was written, false if the key already existed.

fn delete(&self, key: &str) -> Result<()>

Remove key. Removing a missing key succeeds (idempotent).

fn list(&self, prefix: &str) -> Result<Vec<String>>

Every key under prefix (i.e. key.starts_with(prefix)). Order is unspecified.

fn health(&self) -> Result<()>

Cheap reachability/credentials check. Ok(()) means usable.

fn list_paginated( &self, prefix: &str, after: Option<&str>, limit: usize, ) -> Result<(Vec<String>, Option<String>)>

A keyset page of keys under prefix, sorted ascending, starting strictly after after (exclusive), at most limit keys. Returns the page plus a cursor to pass as the next after when more keys may remain (None once exhausted). limit == 0 yields an empty page.

fn reader(&self, key: &str) -> Result<Box<dyn Read + '_>>

Streaming read of key. The default buffers via Store::get; backends with native streaming may override.

fn writer(&self, key: &str) -> Result<Box<dyn Write + '_>>

Streaming write of key. The default buffers in memory and commits via Store::put on flush/drop; backends with native streaming may override. Object-safe: callable on &dyn Store.