Struct FileConfigSink 

pub struct FileConfigSink { /* private fields */ }

File-backed writable config store.

A reference ConfigSink that persists keys to a flat table on disk. The on-disk representation is pluggable via Codec: TOML is the built-in default (FileConfigSink::new), and any other format (JSON, …) drops in through FileConfigSink::with_codec without changing the sink.

Filesystem access goes through rskit-fs (bounded reads + atomic replacement), so a concurrent reader never observes a partial write.

Mutations (set/remove/set_many) are read-modify-write sequences serialized by a shared in-process lock, so concurrent writers — including separate clones, which share the same lock — never lose each other’s updates. Cross-process coordination is out of scope; protect the file with OS-level mechanisms if multiple processes write it.

Persisting writes the plaintext value to disk — this is the sink’s explicit, intended persistence. Protect the file with appropriate permissions; the plaintext is never logged.

Implementations

impl FileConfigSink

pub fn new(path: impl Into<PathBuf>) -> Self

Create a file sink backed by path, using the built-in TOML codec.

The file is created on first write; a missing file reads as empty.

pub fn with_codec(path: impl Into<PathBuf>, codec: Arc<dyn Codec>) -> Self

Create a file sink backed by path with an explicit Codec.

Use this to persist as JSON or any user-supplied format.

pub fn path(&self) -> &Path

Return the backing file path.

pub fn codec(&self) -> &dyn Codec

Return the codec used to persist this sink.

Trait Implementations

impl Clone for FileConfigSink

fn clone(&self) -> FileConfigSink

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConfigSink for FileConfigSink

fn set(&self, key: &str, value: SecretString) -> AppResult<()>

Set or replace the value stored at key.

fn remove(&self, key: &str) -> AppResult<()>

Remove the value stored at key.

fn set_many(&self, entries: Vec<(String, SecretString)>) -> AppResult<()>

Set many key/value pairs.

impl Debug for FileConfigSink

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

Formats the value using the given formatter.