Enum FliError 

pub enum FliError {
    CommandMismatch {
        expected: String,
        actual: String,
    },
    UnknownCommand(String, Vec<String>),
    UnknownOption(String),
    MissingValue {
        option: String,
    },
    UnexpectedValue {
        option: String,
        value: String,
    },
    ValueCountMismatch {
        option: String,
        expected: usize,
        actual: usize,
    },
    InvalidValue {
        option: String,
        value: String,
        reason: String,
    },
    ValueParseError {
        value: String,
        expected_type: String,
        reason: String,
    },
    InvalidStateTransition {
        from: String,
        to: String,
    },
    UnexpectedToken {
        token: String,
        position: usize,
    },
    InvalidOptionConfig {
        option: String,
        reason: String,
    },
    InvalidCommandConfig(String),
    InvalidFlagFormat {
        flag: String,
    },
    OptionNotFound(String),
    ParserNotPrepared,
    Internal(String),
    InvalidUsage(String),
}

Errors that can occur during CLI parsing and execution

Variants

CommandMismatch

Command name doesn’t match expected command

Fields

expected: String

actual: String

UnknownCommand(String, Vec<String>)

Unknown subcommand was specified

UnknownOption(String)

Unknown option flag was provided

MissingValue

Required option value is missing

Fields

option: String

UnexpectedValue

Option expects no value but one was provided

Fields

option: String

value: String

ValueCountMismatch

Wrong number of values provided

Fields

option: String

expected: usize

actual: usize

InvalidValue

Value parsing failed (e.g., string to int)

Fields

option: String

value: String

reason: String

ValueParseError

Value type parsing failed

Fields

value: String

expected_type: String

reason: String

InvalidStateTransition

Invalid state transition during parsing

Fields

from: String

to: String

UnexpectedToken

Unexpected token at position

Fields

token: String

position: usize

InvalidOptionConfig

Option configuration is invalid

Fields

option: String

reason: String

InvalidCommandConfig(String)

Command configuration is invalid

InvalidFlagFormat

Option flag format is invalid

Fields

flag: String

OptionNotFound(String)

Option was not found in parser

ParserNotPrepared

Parser not prepared before use

Internal(String)

Internal error (shouldn’t happen in normal usage)

InvalidUsage(String)

Invalid command usage (e.g., wrong flags or operands)

Implementations

impl FliError

pub fn command_mismatch( expected: impl Into<String>, actual: impl Into<String>, ) -> Self

Creates a command mismatch error

pub fn missing_value(option: impl Into<String>) -> Self

Creates a missing value error

pub fn invalid_value( option: impl Into<String>, value: impl Into<String>, reason: impl Into<String>, ) -> Self

Creates an invalid value error

pub fn value_count_mismatch( option: impl Into<String>, expected: usize, actual: usize, ) -> Self

Creates a value count mismatch error

Trait Implementations

impl Debug for FliError

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

Formats the value using the given formatter.

impl Display for FliError

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

Formats the value using the given formatter.

impl Error for FliError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.