Struct Words 

pub struct Words {
    pub verb: &'static str,
    pub gerund: &'static str,
    pub nothing_pending: Option<&'static str>,
}

The verb a command uses for its own work.

Deliberately no item noun. embed counted “pending file(s)”, classify “pending hash(es)” and faces paths, which is three names for one idea and a difference no user cares about. They are all item(s) now; carrying the distinction as a parameter would have preserved the divergence and called it configuration.

Fields

verb: &'static str

Lowercase, as it appears mid-sentence: embed, classify, process.

gerund: &'static str

Capitalised, as it starts a line: Embedding, Classifying.

nothing_pending: Option<&'static str>

Replaces the default “Nothing to : everything eligible is already done.” when a command has a state that sentence would describe wrongly.

The default is right for embed and classify, where an empty pending set really does mean “you are up to date”. It is wrong for faces, whose empty set can also mean “nothing here has a face to look for”, and which has its own established wording. Passing the sentence in beats either forcing one wording on every caller or letting callers print their own and drift apart again.

Implementations

impl Words

pub const fn new(verb: &'static str, gerund: &'static str) -> Self

pub const fn saying(self, nothing_pending: &'static str) -> Self

Supplies this command’s own wording for the empty-pending case.

Trait Implementations

impl Clone for Words

fn clone(&self) -> Words

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Words