Enum Verbosity 

pub enum Verbosity {
    Quiet,
    Normal,
    Verbose,
    Debug,
}

Verbosity level for CLI output.

This enum provides a structured way to control output verbosity, replacing individual boolean flags with a single, clear setting.

Ordering

Levels are ordered from quietest to most verbose: Quiet < Normal < Verbose < Debug

This allows easy comparison:

use blz_cli::args::Verbosity;

assert!(Verbosity::Quiet < Verbosity::Normal);
assert!(Verbosity::Verbose < Verbosity::Debug);

Variants

Quiet

Suppress all output except errors.

Useful for scripts and CI where only exit codes matter.

Normal

Standard output level (default).

Shows results, warnings, and important information.

Verbose

Show additional details.

Includes timing information, progress indicators, and contextual details that help understand what’s happening.

Debug

Full diagnostic output.

Shows all available information including performance metrics, internal state, and debug-level logging. Primarily for development and troubleshooting.

Implementations

impl Verbosity

pub const fn from_flags(quiet: bool, verbose: bool, debug: bool) -> Self

Create a Verbosity from individual boolean flags.

This provides backward compatibility with the legacy flag pattern. Priority order: debug > verbose > quiet > normal

Examples

use blz_cli::args::Verbosity;

// All false = Normal
assert_eq!(Verbosity::from_flags(false, false, false), Verbosity::Normal);

// Quiet takes precedence when alone
assert_eq!(Verbosity::from_flags(true, false, false), Verbosity::Quiet);

// Verbose takes precedence over quiet
assert_eq!(Verbosity::from_flags(true, true, false), Verbosity::Verbose);

// Debug takes precedence over everything
assert_eq!(Verbosity::from_flags(true, true, true), Verbosity::Debug);

pub const fn show_warnings(self) -> bool

Check if warning messages should be shown.

Warnings are shown at Normal level and above.

pub const fn show_info(self) -> bool

Check if informational messages should be shown.

Info messages are shown at Normal level and above.

pub const fn show_verbose(self) -> bool

Check if verbose output should be shown.

Verbose output is shown at Verbose level and above.

pub const fn show_debug(self) -> bool

Check if debug output should be shown.

Debug output is only shown at Debug level.

pub const fn is_quiet(self) -> bool

Check if output should be suppressed (quiet mode).

pub const fn is_verbose(self) -> bool

Check if verbose mode is enabled.

pub const fn is_debug(self) -> bool

Check if debug mode is enabled.

Trait Implementations

impl Clone for Verbosity

fn clone(&self) -> Verbosity

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Verbosity

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

Formats the value using the given formatter.

impl Default for Verbosity

fn default() -> Verbosity

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Verbosity

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Verbosity

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

Formats the value using the given formatter.

impl Hash for Verbosity

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 Verbosity

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

fn eq(&self, other: &Verbosity) -> 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 Verbosity

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ValueEnum for Verbosity

fn value_variants<'a>() -> &'a [Self]

All possible argument values, in display order.

fn to_possible_value<'a>(&self) -> Option<PossibleValue>

The canonical argument value.

fn from_str(input: &str, ignore_case: bool) -> Result<Self, String>

Parse an argument into Self.

impl Copy for Verbosity

impl Eq for Verbosity

impl StructuralPartialEq for Verbosity