Enum MktError 

#[non_exhaustive]
pub enum MktError {
    ProviderNotFound {
        provider: String,
        available: String,
    },
    ApiError {
        provider: String,
        status: u16,
        message: String,
        retry_after: Option<u64>,
    },
    AuthError {
        provider: String,
        reason: String,
    },
    ConfigError(String),
    RateLimited {
        provider: String,
        retry_after_secs: u64,
    },
    ValidationError {
        field: String,
        message: String,
    },
    NotSupported {
        provider: String,
        feature: String,
    },
    Http(Error),
    Io(Error),
    SerdeJson(Error),
    Toml(Error),
    Csv(Error),
}

The unified error type for the mkt workspace.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ProviderNotFound

The requested provider is not registered or not available.

Fields

provider: String

The provider name that was requested.

available: String

Comma-separated list of available provider names.

ApiError

An API request returned an error response.

Fields

provider: String

Which provider returned the error.

status: u16

HTTP status code.

message: String

Human-readable error message from the API.

retry_after: Option<u64>

Optional retry-after hint in seconds.

AuthError

Authentication failed for a provider.

Fields

provider: String

Which provider failed authentication.

reason: String

Human-readable reason for the failure.

ConfigError(String)

A configuration error occurred.

RateLimited

The provider’s rate limit has been exceeded.

Fields

provider: String

Which provider hit the rate limit.

retry_after_secs: u64

How many seconds to wait before retrying.

ValidationError

A validation error on user input.

Fields

field: String

The field that failed validation.

message: String

What went wrong.

NotSupported

The provider does not support the requested feature.

Fields

provider: String

Which provider lacks the feature.

feature: String

The feature that is not supported.

Http(Error)

An HTTP transport error from reqwest.

Io(Error)

A filesystem I/O error.

SerdeJson(Error)

A JSON serialization/deserialization error.

Toml(Error)

A TOML parsing error.

Csv(Error)

A CSV writing error.

Implementations

impl MktError

pub fn not_supported(provider: &str, feature: &str) -> Self

Convenience constructor for NotSupported errors.

pub fn auth_error(provider: &str, reason: &str) -> Self

Convenience constructor for AuthError.

pub const fn exit_code(&self) -> u8

Process exit code for this error.

The contract is stable and documented in AGENTS.md so scripts and coding agents can branch on it:

Code	Meaning
0	success
1	unexpected error (I/O, transport, bug)
2	invalid input or configuration
3	authentication failed
4	resource or provider not found
5	rate limited (transient — retry)
6	feature not supported by the provider
7	provider API rejected the request

pub const fn error_type(&self) -> &'static str

Stable machine-readable error identifier (snake_case).

Emitted in structured error output so agents can match on the kind of failure without parsing human-readable messages.

pub const fn is_transient(&self) -> bool

Whether retrying the same request later may succeed.

pub fn suggestion(&self) -> Option<String>

A recovery hint for the user or agent, when one exists.

Trait Implementations

impl Debug for MktError

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

Formats the value using the given formatter.

impl Display for MktError

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

Formats the value using the given formatter.

impl Error for MktError

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.

impl From<Error> for MktError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MktError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MktError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MktError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MktError

fn from(source: Error) -> Self

Converts to this type from the input type.