Enum FnoxError 

pub enum FnoxError {
    ConfigFileNotFound {
        path: PathBuf,
    },
    ConfigReadFailed {
        path: PathBuf,
        source: Error,
    },
    ConfigWriteFailed {
        path: PathBuf,
        source: Error,
    },
    ConfigParseError {
        source: Error,
    },
    ConfigParseErrorWithSource {
        message: String,
        src: Arc<NamedSource<Arc<String>>>,
        span: SourceSpan,
    },
    ConfigSerializeError {
        source: Error,
    },
    ConfigValidationFailed {
        issues: Vec<ValidationIssue>,
    },
    ConfigNotFound {
        message: String,
        help: String,
    },
    Config(String),
    SecretNotFound {
        key: String,
        profile: String,
        config_path: Option<PathBuf>,
        suggestion: Option<String>,
    },
    SecretDecodeFailed {
        details: String,
    },
    ProviderNotConfigured {
        provider: String,
        profile: String,
        config_path: Option<PathBuf>,
        suggestion: Option<String>,
    },
    ProviderNotConfiguredWithSource {
        provider: String,
        profile: String,
        suggestion: Option<String>,
        src: Arc<NamedSource<Arc<String>>>,
        span: SourceSpan,
    },
    DefaultProviderNotFoundWithSource {
        provider: String,
        profile: String,
        src: Arc<NamedSource<Arc<String>>>,
        span: SourceSpan,
    },
    Provider(String),
    ProviderCliNotFound {
        provider: String,
        cli: String,
        install_hint: String,
        url: String,
    },
    ProviderCliFailed {
        provider: String,
        details: String,
        hint: String,
        url: String,
    },
    ProviderAuthFailed {
        provider: String,
        details: String,
        hint: String,
        url: String,
    },
    ProviderSecretNotFound {
        provider: String,
        secret: String,
        hint: String,
        url: String,
    },
    ProviderInvalidResponse {
        provider: String,
        details: String,
        hint: String,
        url: String,
    },
    ProviderApiError {
        provider: String,
        details: String,
        hint: String,
        url: String,
    },
    ProviderConfigCycle {
        provider: String,
        cycle: String,
    },
    ProviderConfigResolutionFailed {
        provider: String,
        secret: String,
        details: String,
    },
    AgeNotConfigured,
    AgeIdentityNotFound {
        path: PathBuf,
    },
    AgeIdentityReadFailed {
        path: PathBuf,
        source: Error,
    },
    AgeIdentityParseFailed {
        details: String,
    },
    AgeEncryptionFailed {
        details: String,
    },
    AgeDecryptionFailed {
        details: String,
    },
    EditorLaunchFailed {
        editor: String,
        source: Error,
    },
    EditorExitFailed {
        editor: String,
        status: i32,
    },
    LeaseContractViolation {
        lease: String,
        key: String,
    },
    CommandNotSpecified,
    CommandExecutionFailed {
        command: String,
        source: Error,
    },
    ImportStdinRequiresForce,
    InvalidRegexFilter {
        pattern: String,
        details: String,
    },
    ImportReadFailed {
        path: PathBuf,
        source: Error,
    },
    ImportEncryptionFailed {
        key: String,
        provider: String,
        details: String,
    },
    ImportParseErrorWithSource {
        format: String,
        details: String,
        src: Arc<NamedSource<Arc<String>>>,
        span: SourceSpan,
    },
    ImportProviderUnsupported {
        provider: String,
        help: String,
    },
    SyncTargetProviderUnsupported {
        provider: String,
    },
    SyncEncryptionFailed {
        key: String,
        provider: String,
        details: String,
    },
    ReencryptEncryptionFailed {
        key: String,
        provider: String,
        details: String,
    },
    ReencryptDecryptFailed {
        key: String,
        details: String,
    },
    CreateDirFailed {
        path: PathBuf,
        source: Error,
    },
    ExportWriteFailed {
        path: PathBuf,
        source: Error,
    },
    StdinReadFailed {
        source: Error,
    },
    Io(Error),
    Json {
        source: Error,
    },
    Yaml {
        source: Error,
    },
    Toml {
        source: Error,
    },
}

Variants

ConfigFileNotFound

Fields

path: PathBuf

ConfigReadFailed

Fields

path: PathBuf

source: Error

ConfigWriteFailed

Fields

path: PathBuf

source: Error

ConfigParseError

Fields

source: Error

ConfigParseErrorWithSource

TOML parse error with source code context for precise error location display.

Fields

message: String

src: Arc<NamedSource<Arc<String>>>

span: SourceSpan

ConfigSerializeError

Fields

source: Error

ConfigValidationFailed

Configuration validation failed with one or more issues. Uses #[related] to display all validation issues together.

Fields

issues: Vec<ValidationIssue>

ConfigNotFound

Backward compatibility for ConfigNotFound with custom message/help

Fields

message: String

help: String

Config(String)

Generic config error for cases not covered by specific variants

SecretNotFound

Fields

key: String

profile: String

config_path: Option<PathBuf>

suggestion: Option<String>

SecretDecodeFailed

Fields

details: String

ProviderNotConfigured

Fields

provider: String

profile: String

config_path: Option<PathBuf>

suggestion: Option<String>

ProviderNotConfiguredWithSource

Provider not configured error with source code context showing where the provider is referenced.

Fields

provider: String

profile: String

suggestion: Option<String>

src: Arc<NamedSource<Arc<String>>>

span: SourceSpan

DefaultProviderNotFoundWithSource

Default provider not found error with source code context showing where it was configured.

Fields

provider: String

profile: String

src: Arc<NamedSource<Arc<String>>>

span: SourceSpan

Provider(String)

Generic provider error for cases not covered by specific variants

ProviderCliNotFound

Fields

provider: String

cli: String

install_hint: String

url: String

ProviderCliFailed

Fields

provider: String

details: String

hint: String

url: String

ProviderAuthFailed

Fields

provider: String

details: String

hint: String

url: String

ProviderSecretNotFound

Fields

provider: String

secret: String

hint: String

url: String

ProviderInvalidResponse

Fields

provider: String

details: String

hint: String

url: String

ProviderApiError

Fields

provider: String

details: String

hint: String

url: String

ProviderConfigCycle

Fields

provider: String

cycle: String

ProviderConfigResolutionFailed

Fields

provider: String

secret: String

details: String

AgeNotConfigured

AgeIdentityNotFound

Fields

path: PathBuf

AgeIdentityReadFailed

Fields

path: PathBuf

source: Error

AgeIdentityParseFailed

Fields

details: String

AgeEncryptionFailed

Fields

details: String

AgeDecryptionFailed

Fields

details: String

EditorLaunchFailed

Fields

editor: String

source: Error

EditorExitFailed

Fields

editor: String

status: i32

LeaseContractViolation

Fields

lease: String

key: String

CommandNotSpecified

CommandExecutionFailed

Fields

command: String

source: Error

ImportStdinRequiresForce

InvalidRegexFilter

Fields

pattern: String

details: String

ImportReadFailed

Fields

path: PathBuf

source: Error

ImportEncryptionFailed

Fields

key: String

provider: String

details: String

ImportParseErrorWithSource

Import parse error with source code context for precise error location display.

Fields

format: String

details: String

src: Arc<NamedSource<Arc<String>>>

span: SourceSpan

ImportProviderUnsupported

Fields

provider: String

help: String

SyncTargetProviderUnsupported

Fields

provider: String

SyncEncryptionFailed

Fields

key: String

provider: String

details: String

ReencryptEncryptionFailed

Fields

key: String

provider: String

details: String

ReencryptDecryptFailed

Fields

key: String

details: String

CreateDirFailed

Fields

path: PathBuf

source: Error

ExportWriteFailed

Fields

path: PathBuf

source: Error

StdinReadFailed

Fields

source: Error

Io(Error)

Json

Fields

source: Error

Yaml

Fields

source: Error

Toml

Fields

source: Error

Implementations

impl FnoxError

pub fn is_auth_error(&self) -> bool

Returns true if this error represents a provider authentication failure.

pub fn clone_provider_error(&self) -> Option<FnoxError>

Clone a provider error variant (all fields are String, so always cloneable).

Returns None for non-provider error variants.

pub fn map_batch_error( &self, secret_name: &str, fallback_provider: &str, fallback_hint: &str, fallback_url: &str, ) -> FnoxError

Map a batch-level error to a per-secret error, preserving structured variants.

If the error is ProviderSecretNotFound, the secret name is replaced with the given name. Other provider error variants are cloned as-is. Non-provider errors fall back to ProviderCliFailed with the given provider name, hint, and URL.

Trait Implementations

impl Debug for FnoxError

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

Formats the value using the given formatter.

impl Diagnostic for FnoxError

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn related(&self) -> Option<Box<dyn Iterator<Item = &dyn Diagnostic> + '_>>

Additional related Diagnostics.

fn url(&self) -> Option<Box<dyn Display + '_>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for FnoxError

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

Formats the value using the given formatter.

impl Error for FnoxError

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 FnoxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FnoxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FnoxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FnoxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FnoxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Report> for FnoxError

fn from(err: ErrReport) -> Self

Converts to this type from the input type.