Struct LexiconAppender 

pub struct LexiconAppender { /* private fields */ }

Atomically appends or removes entries from a TOML lexicon file.

Uses a write-to-temp-then-rename pattern so a crash mid-write never corrupts the existing file. The temp file is written to the same directory as the target to ensure both are on the same filesystem (required for atomic rename on most platforms).

Implementations

impl LexiconAppender

pub fn new(path: PathBuf) -> Self

Create an appender targeting path. The file need not exist yet.

pub fn append(&self, proposal: &LexiconProposal) -> Result<()>

Append proposal.term with proposal.weight to the lexicon file.

Reads the current file (creating an empty config if absent), inserts the new term, serializes back to TOML, and atomically replaces the file via a temp-file rename. When proposal.rationale is Some, the rationale is written as an inline comment on the term’s line.

Errors

Returns an error if the file cannot be read, parsed, serialized, or written.

pub fn append_affirmation(&self, pattern: &str) -> Result<()>

Append a pattern to [affirmations], deduplicating case-insensitively.

Errors

Returns an error if the file cannot be read, parsed, serialized, or written.

pub fn append_negation(&self, pattern: &str) -> Result<()>

Append a pattern to [negations], deduplicating case-insensitively.

Errors

Returns an error if the file cannot be read, parsed, serialized, or written.

pub fn remove_term(&self, term: &str) -> Result<()>

Remove a term from [terms]. No-op if the term is not present.

Errors

Returns an error if the file cannot be read, parsed, serialized, or written.

pub fn remove_affirmation(&self, pattern: &str) -> Result<()>

Remove a pattern from [affirmations], matching case-insensitively. No-op if the pattern is not present.

Errors

Returns an error if the file cannot be read, parsed, serialized, or written.

pub fn remove_negation(&self, pattern: &str) -> Result<()>

Remove a pattern from [negations], matching case-insensitively. No-op if the pattern is not present.

Errors

Returns an error if the file cannot be read, parsed, serialized, or written.

Trait Implementations

impl Clone for LexiconAppender

fn clone(&self) -> LexiconAppender

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LexiconAppender

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

Formats the value using the given formatter.