Struct ThemeChoice 

#[non_exhaustive]
pub struct ThemeChoice<'a> {
    pub id: &'a str,
    pub name: &'a str,
    pub variant: ThemeVariant,
    pub contrast: Contrast,
}

One theme, as a picker offers it.

Four facts where a Choice has two, and the two extra ones are why this is its own type rather than options with the variant folded into the label. Both are facts the theme layer resolved and neither survives being written into a string: a group is structure and a badge is a second column.

No unavailable

Choice::unavailable’s counterpart is absent for its own sibling’s reason. A theme that is installed can be picked, and a theme that is not installed is not in the list. There is no third state for a reason to explain.

#[non_exhaustive] from birth, so a new member costs no call site.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

id: &'a str

What is submitted, and what the app stores.

name: &'a str

What is read.

variant: ThemeVariant

Which group it belongs to.

contrast: Contrast

How legible its muted text measured.

Implementations

impl<'a> ThemeChoice<'a>

pub const fn new( id: &'a str, name: &'a str, variant: ThemeVariant, contrast: Contrast, ) -> Self

A theme, with everything a picker needs to place and mark it.

Every fact is an argument and none is a builder, which is the opposite of Choice’s arrangement and is deliberate: a theme missing its variant has no group to sit in and a theme missing its tier has no badge to draw, so both are the control rather than embellishments on it. The same reasoning Field::range applies to its bounds.

Trait Implementations

impl<'a> Clone for ThemeChoice<'a>

fn clone(&self) -> ThemeChoice<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for ThemeChoice<'a>

impl<'a> Debug for ThemeChoice<'a>

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

Formats the value using the given formatter.

impl<'a> Eq for ThemeChoice<'a>

impl<'a> Hash for ThemeChoice<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for ThemeChoice<'a>

fn eq(&self, other: &ThemeChoice<'a>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<'a> StructuralPartialEq for ThemeChoice<'a>