Struct Settings 

pub struct Settings { /* private fields */ }

Typed access to the settings store.

Implementations

impl Settings

pub fn new(store: Arc<dyn SettingsStore>) -> Self

pub async fn get<T: DeserializeOwned>(&self, setting: &Setting<T>) -> Result<T>

The stored value, or the declared default.

A stored value that no longer decodes — because the setting’s type changed between releases — falls back to the default and logs a warning. Refusing to start over a stale preference would be worse than ignoring it.

pub async fn set<T: Serialize>( &self, setting: &Setting<T>, value: &T, ) -> Result<()>

pub async fn reset<T>(&self, setting: &Setting<T>) -> Result<()>

Drop the stored value so the next read returns the default.

pub async fn get_json(&self, key: &str) -> Result<Option<Value>>

Untyped read for generic settings UIs, which do not know the concrete types.

Prefer Settings::get wherever the setting is known at compile time.

pub async fn set_json(&self, key: &str, value: &Value) -> Result<()>

Untyped write for generic settings UIs.

The value is not validated against the setting’s declared type — a generic caller has no way to know it. A value that no longer decodes is ignored on read (see Settings::get), so a bad write degrades to the default rather than breaking startup.

pub async fn customised_keys(&self) -> Result<Vec<String>>

Keys that currently have a stored value. Settings left at their default are not listed.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Settings

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

Formats the value using the given formatter.