Struct SettingsStore 

pub struct SettingsStore { /* private fields */ }

Native JSON settings store.

All get/set/remove/contains/keys operations are synchronous (in-memory). Only open and save are async (matching the wasm32 sibling API).

Implementations

impl SettingsStore

pub async fn open( root: impl AsRef<Path>, namespace: &str, ) -> Result<Self, SettingsError>

Open (or create) a settings store.

root — directory that will contain the settings file. namespace — base name of the file ({namespace}.json).

Creates parent directories if missing. If the file exists it is parsed into the in-memory map; a corrupt or unreadable file returns Err rather than silently wiping it.

pub fn get<T: DeserializeOwned>(&self, key: &str) -> Option<T>

Look up a key and deserialize it as T.

Returns None when the key is absent or the value cannot be deserialized as T (wrong type — not a panic).

pub fn set<T: Serialize>( &mut self, key: &str, value: &T, ) -> Result<(), SettingsError>

Serialize value as JSON and insert it under key.

The store is only modified in memory; call save() to persist.

pub fn remove(&mut self, key: &str) -> bool

Remove a key. Returns true if the key was present.

pub fn keys(&self) -> Vec<String>

Return all keys in the store (order unspecified).

pub fn contains(&self, key: &str) -> bool

Return true if key exists in the store.

pub async fn save(&self) -> Result<(), SettingsError>

Persist the in-memory map to disk atomically.

Writes to {path}.tmp first, then renames it over path. This ensures the previous file is never partially overwritten on a crash.

Trait Implementations

impl Debug for SettingsStore

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

Formats the value using the given formatter.