Enum Level 

pub enum Level {
    Refuse,
    Effect,
    Decide,
    Trace,
    Wire,
}

Who reads a line, and when. Ordered from the widest audience to the narrowest: a floor admits every level at or before it.

The names answer “who reads this” rather than “how bad is this”, because that is the question with a checkable answer. A severity ladder would invite the other one.

Variants

Refuse

The person, live: what a door refused, in three parts.

Effect

The person, afterwards: which file was written, which provider was called.

Decide

The builder, when behaviour is wrong: why a verdict took the value it did.

Trace

The builder, when reproducing a defect: phase changes, locks, retries.

Wire

The builder, when a protocol does not connect: the bytes.

Implementations

impl Level

pub const DEFAULT: Level = Level::Effect

The default floor. refuse and effect together answer nine of ten questions a person has, and are small enough to leave on.

pub const ALL: [Level; 5]

Every level, in declaration order, for a command line to offer.

pub fn as_str(&self) -> &'static str

pub fn parse(raw: &str) -> Option<Level>

Reads a level by name, for --log <level>. off is not a level here: turning logging off is Diagnostics::off, and letting one word mean both a floor and the absence of one is how a setting becomes ambiguous.

Trait Implementations

impl Clone for Level

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Level

impl Debug for Level

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

Formats the value using the given formatter.

impl Display for Level

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

Formats the value using the given formatter.

impl Eq for Level

impl Ord for Level

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Level

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Level

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for Level