Struct ConfigRow 

pub struct ConfigRow {
    pub key: &'static str,
    pub category: &'static str,
    pub help: &'static str,
    pub plain: &'static str,
    pub control: Control,
    pub value: String,
    pub original: String,
    pub default: String,
    pub recommended: Option<&'static str>,
    pub is_new: bool,
}

One setting, as the view needs it.

Fields

key: &'static str

category: &'static str

The heading this row is drawn under. Rows sharing one are drawn together, in the order they arrive; the caller owns which group a setting is in.

help: &'static str

plain: &'static str

The same setting said again without jargon, shown under help rather than instead of it. Someone who knows what a build tree is skips the second line; someone who does not was going to guess, and guessing is how a setting gets turned on for the wrong reason.

control: Control

value: String

The value, spelled the way devp config set would take it.

original: String

What it was when the view opened, so the summary shows only real changes.

default: String

What a fresh install would hold, spelled the same way as value.

Not the same question as original, which is what this machine happens to hold. Somebody looking at a setting they have never touched cannot tell those apart, and the one they need in order to decide whether to touch it is this one.

recommended: Option<&'static str>

The value the first-run screen suggests, if this setting is suggested at all.

A recommendation, never a requirement: everything here works with all of them declined. It is shown on every visit rather than only on the first run, because the screen that suggested it appears once and the settings list is forever.

is_new: bool

Introduced in a release newer than the one this machine last reviewed at.

Implementations

impl ConfigRow

pub fn changed(&self) -> bool

pub fn takes_advice(&self) -> Option<bool>

Whether this row already holds what is recommended for it.

None when nothing is recommended, which is a different answer from “no” and is why the badge has three states rather than two.

Trait Implementations

impl Clone for ConfigRow

fn clone(&self) -> ConfigRow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigRow

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

Formats the value using the given formatter.