Enum Level

pub enum Level {
    Debug,
    Info,
    Warn,
    Error,
}

A severity level for a diagnostic event.

If a crate::Event has a level associated with it, it can be pulled from its props:

match evt.props().pull::<emit::Level, _>(emit::well_known::KEY_LVL).unwrap_or_default() {
    emit::Level::Debug => {
        // The event is at the debug level
    }
    emit::Level::Info => {
        // The event is at the info level
    }
    emit::Level::Warn => {
        // The event is at the warn level
    }
    emit::Level::Error => {
        // The event is at the error level
    }
}

The default level is Level::Info.

Parsing

Level has a permissive parser that will match partial and incomplete contents, ignoring case. So long as the start of the text is a submatch of the full level, and any trailing unmatched characters are not ASCII control characters, the level will parse.

For example, the following will all be parsed as Level::Info:

• info
• INFO
• i
• inf
• information
• INFO1
• inf(13)

Note that any trailing data is lost when levels are parsed. That means, for example, that INFO3 and INFO4 will both parse to the same value, Level::Info, and will sort equivalently.

Variants

Debug

The event is weakly informative.

This variant is equal to LVL_DEBUG.

Info

The event is informative.

This variant is equal to LVL_INFO.

Warn

The event is weakly erroneous.

This variant is equal to LVL_WARN.

Error

The event is erroneous.

This variant is equal to LVL_ERROR.

Implementations

impl Level

pub fn try_from_str(s: &str) -> Result<Self, ParseLevelError>

Try parse a level from a formatted representation.

Trait Implementations

impl Clone for Level

fn clone(&self) -> Level

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Level

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

Formats the value using the given formatter.

impl Default for Level

fn default() -> Self

Returns the “default value” for a type.

impl Display for Level

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

Formats the value using the given formatter.

impl From<Level> for MinLevelFilter

fn from(min: Level) -> Self

Converts to this type from the input type.

impl FromStr for Level

type Err = ParseLevelError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl<'v> FromValue<'v> for Level

fn from_value(value: Value<'v>) -> Option<Self>

Perform the conversion.

impl Hash for Level

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 Ord for Level

fn cmp(&self, other: &Level) -> 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.

impl PartialEq for Level

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for Level

fn partial_cmp(&self, other: &Level) -> 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 ToValue for Level

fn to_value(&self) -> Value<'_>

Perform the conversion.

impl Copy for Level

impl Eq for Level

impl StructuralPartialEq for Level