Enum Verbosity 

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

User-selected verbosity for Cabin-owned status output.

The default is Verbosity::Normal, which preserves Cabin’s pre-existing status-message volume. Variants are ordered from quietest to loudest so callers can compare with >=:

if verbosity >= Verbosity::Verbose { ... }

Variants

Quiet

Suppress Cabin-owned status / progress / log messages. Errors and explicitly-requested output (build artifacts, JSON documents, the user program’s stdout under cabin run) are unaffected.

Normal

Default volume. Status lines such as cabin: wrote build.ninja are emitted; verbose-only lines are not.

Verbose

Adds Cabin-owned context lines such as the resolved build profile, build directory, and toolchain summary.

VeryVerbose

Adds further detail intended for diagnosing local builds. Output stays deterministic and never includes secrets, tokens, or environment-dependent values that Normal / Verbose would not already print.

Implementations

impl Verbosity

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

Stable string label for this variant; matches the spelling Cabin documents.

pub fn shows_status(self) -> bool

Whether this verbosity emits Cabin-owned status messages.

pub fn shows_verbose(self) -> bool

Whether this verbosity emits verbose-only context lines.

pub fn shows_very_verbose(self) -> bool

Whether this verbosity emits very-verbose detail lines.

pub fn from_verbose_count(count: u8) -> Self

Convert a -v repetition count into a verbosity. Counts of two or more clamp to Verbosity::VeryVerbose so -vvv and similar keep working without erroring.

pub fn from_config_pair( verbose: Option<bool>, quiet: Option<bool>, ) -> Result<Option<Self>, InvalidVerbosityCombination>

Combine the two config booleans term.verbose and term.quiet into a single verbosity. Returns Ok(None) when neither is set so callers can fall through to the next layer in the precedence chain. Returns InvalidVerbosityCombination when both are true.

Errors

Returns InvalidVerbosityCombination when both verbose and quiet are Some(true).

pub fn parse_bool_env( variable: &'static str, raw: &str, ) -> Result<bool, VerbosityEnvError>

Parse a verbosity from a single env-var value. Used by CABIN_TERM_VERBOSE and CABIN_TERM_QUIET: a non-empty truthy value (1, true) opts in; 0, false, or empty opt out. Other strings produce a typed error so the CLI can surface a copy-pasteable message.

Errors

Returns VerbosityEnvError when raw is non-empty and not one of 1, true, 0, or false.

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 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 Copy for Verbosity

impl Eq for Verbosity

impl StructuralPartialEq for Verbosity