Struct ContainerError 

pub struct ContainerError {
    pub kind: ContainerErrorKind,
    pub message: String,
    pub source: Option<Box<dyn Error + Send + Sync>>,
}

The main error type for container operations

ContainerError represents various failure conditions that can occur during container initialization, component creation, and dependency resolution.

Examples

use verdure_core::error::container::{ContainerError, ContainerErrorKind};

let error = ContainerError::not_found("ComponentA not found");
println!("{}", error); // Prints: "Component not found: ComponentA not found"

Fields

kind: ContainerErrorKind

The specific kind of error that occurred

message: String

A human-readable error message describing the issue

source: Option<Box<dyn Error + Send + Sync>>

Optional source error that caused this error

Implementations

impl ContainerError

pub fn new<M: Into<String>>(kind: ContainerErrorKind, message: M) -> Self

Creates a new ContainerError with the specified kind and message

Arguments

• kind - The kind of error that occurred
• message - A descriptive error message

Examples

use verdure_core::error::container::{ContainerError, ContainerErrorKind};

let error = ContainerError::new(ContainerErrorKind::NotFound, "Component missing");

pub fn with_source<E>(self, err: E) -> Self

where E: Error + Send + Sync + 'static,

Adds a source error to this ContainerError

This is useful for error chaining, where one error is caused by another.

Arguments

• err - The source error that caused this error

Examples

use verdure_core::error::container::ContainerError;
use std::io::Error;

let io_error = Error::new(std::io::ErrorKind::NotFound, "file not found");
let container_error = ContainerError::creation_failed("Failed to load config")
    .with_source(io_error);

pub fn not_found<M: Into<String>>(message: M) -> Self

Creates a new “not found” error

Arguments

• message - A descriptive message about what was not found

pub fn circular_dependency<M: Into<String>>(message: M) -> Self

Creates a new “circular dependency” error

Arguments

• message - A descriptive message about the circular dependency

pub fn creation_failed<M: Into<String>>(message: M) -> Self

Creates a new “creation failed” error

Arguments

• message - A descriptive message about the creation failure

pub fn type_cast_failed<M: Into<String>>(message: M) -> Self

Creates a new “type cast failed” error

Arguments

• message - A descriptive message about the type cast failure

pub fn configuration<M: Into<String>>(message: M) -> Self

Creates a new “configuration” error

Arguments

• message - A descriptive message about the configuration error

pub fn other<M: Into<String>>(message: M) -> Self

Creates a new “other” error

Arguments

• message - A descriptive message about the error

Trait Implementations

impl Debug for ContainerError

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

Formats the value using the given formatter.

impl Display for ContainerError

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

Formats the value using the given formatter.

impl Error for ContainerError

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<&str> for ContainerError

fn from(msg: &str) -> Self

Converts to this type from the input type.

impl From<ComponentError> for ContainerError

fn from(err: ComponentError) -> Self

Converts to this type from the input type.

impl From<ContainerError> for ComponentError

fn from(err: ContainerError) -> Self

Converts to this type from the input type.

impl From<String> for ContainerError

fn from(msg: String) -> Self

Converts to this type from the input type.