Struct Palette 

pub struct Palette { /* private fields */ }

Whether colour is on, and the vocabulary for painting with it.

Copy, so it threads through the command tree as a value rather than a borrow — it is one bool.

Implementations

impl Palette

pub const fn plain() -> Self

A palette that colours nothing.

What every test renders against, and therefore what pins the plain output byte-for-byte: with colour off every method here returns its argument unchanged.

pub fn resolve( choice: ColorChoice, is_terminal: bool, no_color: Option<&str>, ) -> Self

The palette a run of the CLI gets, from the flag, the stream and the environment.

Pure in all three, so the precedence documented at the top of this module is testable without a terminal or a process environment.

pub const fn is_on(self) -> bool

Whether this palette emits anything.

pub fn ok(self, text: &str) -> String

Something that worked, or a state an operator wants to see.

pub fn bad(self, text: &str) -> String

Something that failed, was refused, or was withdrawn.

pub fn warn(self, text: &str) -> String

Advisory: nothing failed, but read this line.

The advisory outcome of the logging convention, applied to output.

pub fn unknown(self, text: &str) -> String

Undecided — a question that was asked and not answered.

pub fn status(self, text: &str) -> String

A status word, by what it means rather than by which table it came from.

One vocabulary covers accounts, orders, authorizations, challenges, EAB credentials, admin users, sessions and TOTP state: the words do not collide in meaning across those domains, and an operator scanning a column is asking the same question of all of them.

An unrecognised word renders plain. A status this build has never heard of is exactly the case where a guessed colour would mislead — and AuditEntry::event deliberately comes back as the string it was stored as, so an older binary reading a newer database gets here.

off counts as bad on purpose: the only place it appears is an operator’s second factor, and admin.require_mfa exists because that is a state somebody wants to notice in a listing.

Trait Implementations

impl Clone for Palette

fn clone(&self) -> Palette

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Palette

impl Debug for Palette

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

Formats the value using the given formatter.

impl Eq for Palette

impl PartialEq for Palette

fn eq(&self, other: &Palette) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Palette