Enum Error

pub enum Error {
    Io(Error),
    Json(Error),
    Config {
        key: String,
        message: String,
        context: Option<Box<ErrorContext>>,
    },
    Parse {
        file: PathBuf,
        message: String,
        line: Option<usize>,
        context: Option<Box<ErrorContext>>,
    },
    Network {
        message: String,
        context: Option<Box<ErrorContext>>,
    },
    Database {
        message: String,
        context: Option<Box<ErrorContext>>,
    },
    ResourceExhausted {
        resource: String,
        message: String,
        context: Option<Box<ErrorContext>>,
    },
    Timeout {
        operation: String,
        timeout: Duration,
        context: Option<Box<ErrorContext>>,
    },
    Cancelled {
        operation: String,
        context: Option<Box<ErrorContext>>,
    },
    Permission {
        resource: String,
        message: String,
        context: Option<Box<ErrorContext>>,
    },
    Validation {
        field: String,
        message: String,
        context: Option<Box<ErrorContext>>,
    },
    Generic {
        message: String,
        severity: ErrorSeverity,
        recovery_strategy: RecoveryStrategy,
        context: Option<Box<ErrorContext>>,
    },
}

The main error type for the codeprism library

Variants

Io(Error)

Input/output related errors

Json(Error)

JSON serialization/deserialization errors

Config

Configuration related errors

Fields

key: String

Configuration key or path that caused the error

message: String

Error message

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Parse

Parsing related errors

Fields

file: PathBuf

File that failed to parse

message: String

Error message

line: Option<usize>

Line number where the error occurred (if available)

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Network

Network related errors

Fields

message: String

Error message

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Database

Database related errors

Fields

message: String

Error message

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

ResourceExhausted

Resource exhaustion errors

Fields

resource: String

Resource type that was exhausted

message: String

Error message

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Timeout

Timeout errors

Fields

operation: String

Operation that timed out

timeout: Duration

Timeout duration

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Cancelled

Operation was cancelled

Fields

operation: String

Operation that was cancelled

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Permission

Permission/authorization errors

Fields

resource: String

Resource or operation that was denied

message: String

Error message

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Validation

Input validation errors

Fields

field: String

Field that failed validation

message: String

Error message

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Generic

Generic errors for cases not covered by specific types

Fields

message: String

Error message

severity: ErrorSeverity

Error severity

recovery_strategy: RecoveryStrategy

Recovery strategy suggestion

context: Option<Box<ErrorContext>>

Error context for correlation and debugging

Implementations

impl Error

pub fn get_error_code(&self) -> &'static str

Get error code for logging and monitoring

pub fn get_severity(&self) -> ErrorSeverity

Get error severity

pub fn get_recovery_strategy(&self) -> RecoveryStrategy

Get recovery strategy

pub fn is_recoverable(&self) -> bool

Check if error is recoverable

pub fn get_context(&self) -> Option<&ErrorContext>

Get error context if available

pub fn parse_with_context( file: impl Into<PathBuf>, message: impl Into<String>, context: ErrorContext, ) -> Self

Create a parse error with context

pub fn parse(file: impl Into<PathBuf>, message: impl Into<String>) -> Self

Create a simple parse error

pub fn config(key: impl Into<String>, message: impl Into<String>) -> Self

Create a configuration error

pub fn permission( resource: impl Into<String>, message: impl Into<String>, ) -> Self

Create a permission error

pub fn timeout(operation: impl Into<String>, timeout: Duration) -> Self

Create a timeout error

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

Create a network error

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

Create a validation error

pub fn generic( message: impl Into<String>, severity: ErrorSeverity, recovery_strategy: RecoveryStrategy, ) -> Self

Create a generic error

pub fn resource_exhausted( resource: impl Into<String>, message: impl Into<String>, ) -> Self

Create a resource exhausted error

pub fn cancelled(operation: impl Into<String>) -> Self

Create a cancelled error

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

Create a database error

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

Create an IO error from a string message

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

Create a storage error (mapped to database error)

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

Create a watcher error (mapped to generic error)

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

Create an indexing error (mapped to generic error)

pub fn unsupported_language(language: impl Into<String>) -> Self

Create an unsupported language error (mapped to validation error)

pub fn node_not_found(node_id: impl Into<String>) -> Self

Create a node not found error (mapped to validation error)

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

Create a generic other error

pub fn should_retry(&self) -> bool

Check if this error should trigger a retry

pub fn severity(&self) -> ErrorSeverity

Get the severity level of this error (for backward compatibility)

pub fn recovery_strategy(&self) -> RecoveryStrategy

Get the recovery strategy for this error (for backward compatibility)

pub fn error_code(&self) -> i32

Get error code for JSON-RPC responses (for backward compatibility)

Trait Implementations

impl Clone for Error

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.