Struct TaskError 

pub struct TaskError { /* private fields */ }

Represents an error that occurred during task execution.

TaskError wraps an underlying error and preserves both the error itself and its concrete type information. This allows for type-safe error handling and downcasting while maintaining thread safety through Arc wrapping.

The error type stores:

• The actual error as a trait object (dyn Error + Send + Sync)
• The original error’s type name as a string for debugging and logging
• An optional source reference to the original concrete error for downcasting

Thread Safety

TaskError is designed to be safely shared across threads, with all internal references wrapped in Arc and requiring Send + Sync bounds.

Example

use genja_core::task::TaskError;
use std::io;

// Create a TaskError from a standard error
let io_error = io::Error::new(io::ErrorKind::NotFound, "file not found");
let task_error = TaskError::new(io_error);

// Access error information
println!("Error: {}", task_error.error());
println!("Error type: {}", task_error.error_type());

// Attempt to downcast to the original error type
if let Some(io_err) = task_error.downcast_ref::<io::Error>() {
    println!("Original IO error kind: {:?}", io_err.kind());
}

Implementations

impl TaskError

pub fn new<E>(error: E) -> Self

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

pub fn from_arc(error: Arc<dyn Error + Send + Sync + 'static>) -> Self

pub fn error(&self) -> &(dyn Error + Send + Sync + 'static)

pub fn error_type(&self) -> &str

pub fn downcast_ref<E>(&self) -> Option<&E>

where E: 'static,

Trait Implementations

impl Clone for TaskError

fn clone(&self) -> TaskError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskError

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

Formats the value using the given formatter.

impl Display for TaskError

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

Formats the value using the given formatter.

impl Error for TaskError

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.