Enum DrasiError 

pub enum DrasiError {
    ComponentNotFound {
        component_type: String,
        component_id: String,
    },
    AlreadyExists {
        component_type: String,
        component_id: String,
    },
    InvalidConfig {
        message: String,
    },
    InvalidState {
        message: String,
    },
    Validation {
        message: String,
    },
    OperationFailed {
        component_type: String,
        component_id: String,
        operation: String,
        reason: String,
    },
    Internal(Error),
}

Main error type for drasi-lib operations.

This enum provides structured error variants that enable type-safe pattern matching by callers. Each variant contains contextual information about the error.

Variants

ComponentNotFound

Component (source, query, or reaction) was not found.

Fields

component_type: String

The type of component (e.g., “source”, “query”, “reaction”)

component_id: String

The ID of the component that was not found

AlreadyExists

Component already exists with the given ID.

Fields

component_type: String

The type of component

component_id: String

The ID that already exists

InvalidConfig

Invalid configuration provided.

Fields

message: String

Description of the configuration error

InvalidState

Operation is not valid in the current state.

Fields

message: String

Description of the state error

Validation

Validation failed (e.g., builder validation, input validation).

Fields

message: String

Description of the validation error

OperationFailed

A component operation (start, stop, delete, etc.) failed.

Fields

component_type: String

The type of component

component_id: String

The ID of the component

operation: String

The operation that failed (e.g., “start”, “stop”, “delete”)

reason: String

The reason for the failure

Internal(Error)

Internal error - wraps underlying errors while preserving the error chain. Use .source() to access the underlying error chain.

Implementations

impl DrasiError

pub fn component_not_found( component_type: impl Into<String>, component_id: impl Into<String>, ) -> Self

Create a component not found error.

Example

DrasiError::component_not_found("source", "my-source-id")

pub fn already_exists( component_type: impl Into<String>, component_id: impl Into<String>, ) -> Self

Create an already exists error.

Example

DrasiError::already_exists("query", "my-query-id")

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

Create an invalid configuration error.

Example

DrasiError::invalid_config("Missing required field 'query'")

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

Create an invalid state error.

Example

DrasiError::invalid_state("Server must be initialized before starting")

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

Create a validation error.

Example

DrasiError::validation("Query string cannot be empty")

pub fn operation_failed( component_type: impl Into<String>, component_id: impl Into<String>, operation: impl Into<String>, reason: impl Into<String>, ) -> Self

Create an operation failed error.

Example

DrasiError::operation_failed("source", "my-source", "start", "Connection refused")

pub fn provisioning(msg: impl Into<String>) -> Self

Create a provisioning error.

Deprecated

Consider using operation_failed with specific component context instead.

pub fn component_error(msg: impl Into<String>) -> Self

Create a component error (generic operation failure).

Deprecated

Consider using operation_failed with specific component context instead.

pub fn startup_validation(msg: impl Into<String>) -> Self

Create a startup validation error.

Deprecated

Consider using validation or invalid_config instead.

Trait Implementations

impl Debug for DrasiError

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

Formats the value using the given formatter.

impl Display for DrasiError

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

Formats the value using the given formatter.

impl Error for DrasiError

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<Error> for DrasiError

fn from(source: Error) -> Self

Converts to this type from the input type.