Struct CuError 

pub struct CuError { /* private fields */ }

Common copper Error type.

This error type stores an optional cause as a boxed dynamic error, allowing for proper error chaining while maintaining Clone and Serialize/Deserialize support through custom implementations.

Implementations

impl CuError

pub fn new(message_index: usize) -> CuError

Creates a new CuError from an interned string index. Used by the cu_error! macro.

The index is stored as a placeholder string [interned:{index}]. Actual string resolution happens at logging time via the unified logger.

pub fn new_with_cause<E>(message: &str, cause: E) -> CuError

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

Creates a new CuError with a message and an underlying cause.

Example

use cu29_traits::CuError;

let io_err = std::io::Error::other("io error");
let err = CuError::new_with_cause("Failed to read file", io_err);

pub fn add_cause(self, context: &str) -> CuError

Adds or replaces the cause with a context string.

This is useful for adding context to errors during propagation.

Example

use cu29_traits::CuError;

let err = CuError::from("base error").add_cause("additional context");

pub fn with_cause<E>(self, cause: E) -> CuError

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

Adds a cause error to this CuError (builder pattern).

Example

use cu29_traits::CuError;

let io_err = std::io::Error::other("io error");
let err = CuError::from("Operation failed").with_cause(io_err);

pub fn cause(&self) -> Option<&(dyn Error + Send + Sync + 'static)>

Returns a reference to the underlying cause, if any.

pub fn message(&self) -> &str

Returns the error message.

Trait Implementations

impl Clone for CuError

fn clone(&self) -> CuError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CuError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CuError

fn deserialize<D>( deserializer: D, ) -> Result<CuError, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for CuError

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

Formats the value using the given formatter.

impl Error for CuError

Available on crate feature std only.

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 CuError

fn from(s: &str) -> CuError

Converts to this type from the input type.

impl From<ConfigError> for CuError

fn from(err: ConfigError) -> CuError

Converts to this type from the input type.

impl<S, L, A> From<LifecycleError<S, L, A>> for CuError

Allows ? in functions returning CuResult when the faulted application does not need to be recovered.

fn from(value: LifecycleError<S, L, A>) -> CuError

Converts to this type from the input type.

impl<S, L, A> From<SimLifecycleError<S, L, A>> for CuError

Available on crate feature std only.

Allows ? in functions returning CuResult when the faulted application does not need to be recovered.

fn from(value: SimLifecycleError<S, L, A>) -> CuError

Converts to this type from the input type.

impl From<String> for CuError

fn from(s: String) -> CuError

Converts to this type from the input type.

impl Serialize for CuError

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.