Struct StoreBuilder 

pub struct StoreBuilder<'a, T: Sized + Serialize> { /* private fields */ }

Builder for storing a value with fine-grained options.

Created via StoreConfigFile::store_opts. Configure with pretty, overwrite and format, then call execute to write the file.

Defaults: pretty on, overwrite on, format auto-detected from the path extension (i.e. the same behavior as StoreConfigFile::store).

Implementations

impl<'a, T: Sized + Serialize> StoreBuilder<'a, T>

pub const fn pretty(self, pretty: bool) -> Self

Toggle pretty-printing. Default: true. Formats without a pretty variant (xml/yaml/json5) ignore this.

pub const fn overwrite(self, overwrite: bool) -> Self

Toggle overwriting an existing file. Default: true. When false, execute returns Error::FileExists if the file already exists.

pub const fn format(self, config_format: ConfigFormat) -> Self

Use a specific ConfigFormat, overriding extension-based detection.

pub fn execute(&self) -> Result<()>

Store the value with the configured options.

Errors

• Returns Error::UnsupportedFormat if the format can’t be determined.
• Returns Error::FileAccess if the file can’t be written.
• Returns Error::FileExists if overwrite is false and the file exists.
• Returns Error::<Format> on serialization failure.

Trait Implementations

impl<T: Sized + Serialize> Debug for StoreBuilder<'_, T>

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

Formats the value using the given formatter.