Enum ExecutionResult 

pub enum ExecutionResult<T, E> {
    Success(T),
    ConditionNotMet,
    Failed(ExecutorError<E>),
}

Task execution result

Represents the result of executing a task using an enum to clearly distinguish between success, unmet conditions, and failure.

Type Parameters

• T - The type of the return value when execution succeeds
• E - The type of the error when execution fails

Examples

use qubit_dcl::double_checked::{ExecutionResult, ExecutorError};

let success: ExecutionResult<i32, String> = ExecutionResult::success(42);
if let ExecutionResult::Success(val) = success {
    println!("Value: {}", val);
}

let unmet: ExecutionResult<i32, String> = ExecutionResult::unmet();

let failed: ExecutionResult<i32, String> =
    ExecutionResult::task_failed("Task failed".to_string());

Variants

Success(T)

Execution succeeded with a value

ConditionNotMet

Double-checked locking condition was not met

Failed(ExecutorError<E>)

Execution failed with an error

Implementations

impl<T, E> ExecutionResult<T, E>

pub fn success(value: T) -> Self

Builds ExecutionResult::Success with value.

Parameters

• value - Successful task value.

Returns

A success result containing value.

pub fn unmet() -> Self

Builds ExecutionResult::ConditionNotMet.

Returns

A result representing a failed double-check condition.

pub fn task_failed(err: E) -> Self

Builds a failed result with ExecutorError::TaskFailed.

Parameters

• err - Error returned by the executed task.

Returns

A failed result wrapping the task error.

pub fn prepare_failed(msg: impl Display) -> Self

Builds a failed result with ExecutorError::PrepareFailed.

Accepts any std::fmt::Display value (including std::error::Error and String); the message is stored in a CallbackError wrapper.

Parameters

• msg - Prepare error message or displayable error value.

Returns

A failed result containing the prepare failure message.

pub fn prepare_commit_failed(msg: impl Display) -> Self

Builds a failed result with ExecutorError::PrepareCommitFailed.

Parameters

• msg - Commit error message or displayable error value.

Returns

A failed result containing the prepare-commit failure message.

pub fn prepare_failed_with_type( callback_type: &'static str, msg: impl Display, ) -> Self

Builds a failed result with ExecutorError::PrepareFailed and explicit callback type metadata.

The callback type can later be read from ExecutorError::callback_type.

Parameters

• callback_type - Callback type tag, e.g. "prepare".
• msg - Failure message.

pub fn prepare_rollback_failed( original: impl Into<String>, rollback: impl Into<String>, ) -> Self

Builds a failed result with ExecutorError::PrepareRollbackFailed.

Parameters

• original - Original failure that triggered prepare rollback.
• rollback - Failure produced by the rollback action.

Returns

A failed result containing both original and rollback messages.

pub fn from_executor_error(err: ExecutorError<E>) -> Self

Wraps an arbitrary ExecutorError as ExecutionResult::Failed.

Parameters

• err - Executor error to store in the failed result.

Returns

A failed result containing err.

pub fn is_success(&self) -> bool

Checks if the execution was successful.

Returns

true if this result is ExecutionResult::Success.

pub fn is_unmet(&self) -> bool

Checks if the condition was not met.

Returns

true if this result is ExecutionResult::ConditionNotMet.

pub fn is_failed(&self) -> bool

Checks if the execution failed.

Returns

true if this result is ExecutionResult::Failed.

pub fn into_result(self) -> Result<Option<T>, ExecutorError<E>>

Converts the result to a standard Result

Returns

• Ok(Some(T)) - If execution was successful
• Ok(None) - If condition was not met
• Err(ExecutorError<E>) - If execution failed

Errors

Returns the stored ExecutorError when this value is ExecutionResult::Failed.

impl<T, E> ExecutionResult<T, E>

where E: Display,

pub fn unwrap(self) -> T

Unwraps the success value, panicking if not successful

Returns

The success value stored in ExecutionResult::Success.

Panics

Panics if this result is ExecutionResult::ConditionNotMet or ExecutionResult::Failed.

Trait Implementations

impl<T: Debug, E: Debug> Debug for ExecutionResult<T, E>

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

Formats the value using the given formatter.