Struct FileMemoryStore 

pub struct FileMemoryStore { /* private fields */ }

A deterministic, path-sandboxed collection of memory files under one root directory.

Implementations

impl FileMemoryStore

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

Opens (creating if needed) a memory root and canonicalizes it so every later path check is against a single absolute base.

pub fn root(&self) -> &Path

The canonicalized root directory.

pub fn create(&self, name: &str, content: &str) -> Result<(), FileMemoryError>

Creates a new memory. Fails if a memory with the same name already exists.

pub fn view(&self, name: &str) -> Result<String, FileMemoryError>

Returns the full content of a memory.

pub fn write(&self, name: &str, content: &str) -> Result<(), FileMemoryError>

Overwrites a memory’s content whether or not it exists.

Unlike Self::create this never fails on an existing name; it is the upsert primitive used by higher-level stacks (e.g. re-remembering).

pub fn append(&self, name: &str, content: &str) -> Result<(), FileMemoryError>

Appends content to an existing memory.

pub fn str_replace( &self, name: &str, old: &str, new: &str, ) -> Result<(), FileMemoryError>

Replaces the first exact occurrence of old with new in a memory.

Fails with FileMemoryError::OldTextNotFound if old is not present, rather than silently corrupting the file — str_replace must be idempotent and observable.

pub fn rename(&self, name: &str, new_name: &str) -> Result<(), FileMemoryError>

Renames a memory to a new validated name.

pub fn delete(&self, name: &str) -> Result<(), FileMemoryError>

Deletes a memory.

pub fn list(&self) -> Result<Vec<MemoryEntry>, FileMemoryError>

Lists all memories, newest-modified first.

Trait Implementations

impl Debug for FileMemoryStore

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

Formats the value using the given formatter.