Struct Error 

pub struct Error {
    pub kind: ErrorKind,
    pub path: Option<String>,
    pub source_location: Option<SourceLocation>,
    pub help: Option<String>,
    pub cause: Option<String>,
}

Main error type for holoconf operations

Fields

kind: ErrorKind

The kind of error that occurred

path: Option<String>

Path in the config where the error occurred (e.g., “database.port”)

source_location: Option<SourceLocation>

Source location (file, line) if available

help: Option<String>

Actionable help message

cause: Option<String>

Underlying cause (as string for Clone compatibility)

Implementations

impl Error

pub fn parse(message: impl Into<String>) -> Self

Create a new parse error

pub fn path_not_found(path: impl Into<String>) -> Self

Create a path not found error

pub fn circular_reference(path: impl Into<String>, chain: Vec<String>) -> Self

Create a circular reference error

pub fn not_found( resource: impl Into<String>, config_path: Option<String>, ) -> Self

Create a not found error (triggers default handling at framework level)

pub fn env_not_found( var_name: impl Into<String>, config_path: Option<String>, ) -> Self

Create an env var not found error

pub fn ref_not_found( ref_path: impl Into<String>, config_path: Option<String>, ) -> Self

Create a reference not found error

pub fn file_not_found( file_path: impl Into<String>, config_path: Option<String>, ) -> Self

Create a file not found error

pub fn unknown_resolver( name: impl Into<String>, config_path: Option<String>, ) -> Self

Create an unknown resolver error

pub fn resolver_already_registered(name: impl Into<String>) -> Self

Create a resolver already registered error

pub fn type_coercion( path: impl Into<String>, expected: impl Into<String>, got: impl Into<String>, ) -> Self

Create a type coercion error

pub fn validation(path: impl Into<String>, message: impl Into<String>) -> Self

Create a validation error

pub fn with_path(self, path: impl Into<String>) -> Self

Add path context to the error

pub fn with_source_location(self, loc: SourceLocation) -> Self

Add source location to the error

pub fn with_help(self, help: impl Into<String>) -> Self

Add help message to the error

pub fn resolver_custom( resolver: impl Into<String>, message: impl Into<String>, ) -> Self

Create a custom resolver error

pub fn http_request_failed( url: impl Into<String>, message: impl Into<String>, config_path: Option<String>, ) -> Self

Create an HTTP request failed error

pub fn http_not_in_allowlist( url: impl Into<String>, allowlist: &[String], config_path: Option<String>, ) -> Self

Create an HTTP not in allowlist error

pub fn tls_config_error(message: impl Into<String>) -> Self

Create a TLS configuration error

pub fn proxy_config_error(message: impl Into<String>) -> Self

Create a proxy configuration error

pub fn pem_load_error( path: impl Into<String>, message: impl Into<String>, ) -> Self

Create a PEM file loading error

pub fn p12_load_error( path: impl Into<String>, message: impl Into<String>, ) -> Self

Create a P12/PFX file loading error

pub fn key_decryption_error(message: impl Into<String>) -> Self

Create a key decryption error

pub fn internal(message: impl Into<String>) -> Self

Create an internal error (bug in holoconf)

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.