Struct FileStorage 

pub struct FileStorage { /* private fields */ }

Raw file storage with ACID guarantees.

Holds only path and strategy; no migration or versioning state. Higher-level wrappers (e.g. VersionedFileStorage) own the migration logic and delegate raw IO to this struct.

Implementations

impl FileStorage

pub fn new( path: PathBuf, strategy: FileStorageStrategy, ) -> Result<Self, StoreError>

Create a new FileStorage and handle missing-file behavior.

• CreateIfMissing: succeeds without writing when file is absent.
• SaveIfMissing: serializes strategy.default_value (or {}) and writes it.
• ErrorIfMissing: returns StoreError when file is absent.

pub fn read_string(&self) -> Result<String, StoreError>

Read raw file contents as a string.

Returns the content exactly as stored on disk.

pub fn write_string(&self, content: &str) -> Result<(), StoreError>

Write content to the file atomically.

Creates parent directories as needed, writes to a temp file, syncs, then renames atomically (with retry according to strategy.atomic_write).

pub fn path(&self) -> &Path

Returns a reference to the storage file path.

pub fn strategy(&self) -> &FileStorageStrategy

Returns a reference to the storage strategy.