Enum ValknutError 

pub enum ValknutError {
    Io {
        message: String,
        source: Error,
    },
    Config {
        message: String,
        field: Option<String>,
    },
    Parse {
        language: String,
        message: String,
        file_path: Option<String>,
        line: Option<usize>,
        column: Option<usize>,
    },
    Math {
        message: String,
        context: Option<String>,
    },
    Graph {
        message: String,
        element: Option<String>,
    },
    Lsh {
        message: String,
        parameters: Option<String>,
    },
    Pipeline {
        stage: String,
        message: String,
        processed_count: Option<usize>,
    },
    Cache {
        message: String,
        key: Option<String>,
    },
    Serialization {
        message: String,
        data_type: Option<String>,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Validation {
        message: String,
        field: Option<String>,
        expected: Option<String>,
        actual: Option<String>,
    },
    ResourceExhaustion {
        message: String,
        resource_type: String,
        current_usage: Option<String>,
        limit: Option<String>,
    },
    Concurrency {
        message: String,
        thread_id: Option<String>,
    },
    FeatureUnavailable {
        feature: String,
        reason: Option<String>,
    },
    Internal {
        message: String,
        context: Option<String>,
    },
    Unsupported {
        message: String,
    },
}

Comprehensive error type for all valknut operations.

Variants

Io

I/O related errors (file operations, network, etc.)

Fields

message: String

Human-readable error message

source: Error

Underlying I/O error

Config

Configuration errors

Fields

message: String

Error description

field: Option<String>

Configuration field that caused the error

Parse

Parsing and language processing errors

Fields

language: String

Programming language being parsed

message: String

Error description

file_path: Option<String>

File path where error occurred

line: Option<usize>

Line number (if available)

column: Option<usize>

Column number (if available)

Math

Mathematical computation errors

Fields

message: String

Error description

context: Option<String>

Context of the mathematical operation

Graph

Graph algorithm errors

Fields

message: String

Error description

element: Option<String>

Graph node or edge that caused the error

Lsh

LSH and similarity detection errors

Fields

message: String

Error description

parameters: Option<String>

LSH parameters that may have caused the issue

Pipeline

Analysis pipeline errors

Fields

stage: String

Pipeline stage where error occurred

message: String

Error description

processed_count: Option<usize>

Number of files processed before error

Cache

Cache and storage errors

Fields

message: String

Error description

key: Option<String>

Cache key that caused the issue

Serialization

Serialization/deserialization errors

Fields

message: String

Error description

data_type: Option<String>

Data type being serialized

source: Option<Box<dyn Error + Send + Sync>>

Underlying serialization error

Validation

Validation errors for input data

Fields

message: String

Error description

field: Option<String>

Field or input that failed validation

expected: Option<String>

Expected value or format

actual: Option<String>

Actual value received

ResourceExhaustion

Resource exhaustion errors

Fields

message: String

Error description

resource_type: String

Type of resource exhausted

current_usage: Option<String>

Current usage level

limit: Option<String>

Maximum allowed usage

Concurrency

Concurrency and threading errors

Fields

message: String

Error description

thread_id: Option<String>

Thread or task identifier

FeatureUnavailable

Feature not implemented or not available

Fields

feature: String

Feature name

reason: Option<String>

Reason why it’s unavailable

Internal

Generic internal errors

Fields

message: String

Error description

context: Option<String>

Additional context

Unsupported

Unsupported operation or feature

Fields

message: String

Error description

Implementations

impl ValknutError

Factory methods and context utilities for ValknutError.

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

Create a new I/O error with context

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

Create a new configuration error

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

Create a new configuration error with field context

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

Create a new parse error

pub fn parse_with_location( language: impl Into<String>, message: impl Into<String>, file_path: impl Into<String>, line: Option<usize>, column: Option<usize>, ) -> Self

Create a new parse error with file context

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

Create a new mathematical error

pub fn math_with_context( message: impl Into<String>, context: impl Into<String>, ) -> Self

Create a new mathematical error with context

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

Create a new graph analysis error

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

Create a new LSH error

pub fn pipeline(stage: impl Into<String>, message: impl Into<String>) -> Self

Create a new pipeline error

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

Create a new validation error

pub fn feature_unavailable( feature: impl Into<String>, reason: impl Into<String>, ) -> Self

Create a new feature unavailable error

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

Create a new internal error

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

Create a new unsupported error

pub fn with_context(self, context: impl Into<String>) -> Self

Add context to an existing error

impl ValknutError

Canonical error mapping adapters for ValknutError.

These methods create closures suitable for use with Result::map_err.

pub fn map_io(message: impl Into<String>) -> impl FnOnce(Error) -> Self

Create error mapping adapter for I/O operations with custom message

pub fn map_serialization( operation: impl Into<String>, ) -> impl FnOnce(Box<dyn Error + Send + Sync>) -> Self

Create error mapping adapter for serialization operations

pub fn map_json_parse(context: impl Into<String>) -> impl FnOnce(Error) -> Self

Create error mapping adapter for JSON parsing operations

pub fn map_internal( operation: impl Into<String>, ) -> impl FnOnce(Box<dyn Error + Send + Sync>) -> Self

Create error mapping adapter for internal operations with context

pub fn map_generic<E>(operation: impl Into<String>) -> impl FnOnce(E) -> Self

where E: Display,

Create error mapping adapter for generic operations with error display

Trait Implementations

impl Debug for ValknutError

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

Formats the value using the given formatter.

impl Display for ValknutError

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

Formats the value using the given formatter.

impl Error for ValknutError

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 ValknutError

Conversion from io::Error to ValknutError.

fn from(err: Error) -> Self

Converts an I/O error into a ValknutError::Io variant.

impl From<Error> for ValknutError

Conversion from serde_json::Error to ValknutError.

fn from(err: Error) -> Self

Converts a JSON error into a ValknutError::Serialization variant.

impl From<Error> for ValknutError

Conversion from serde_yaml::Error to ValknutError.

fn from(err: Error) -> Self

Converts a YAML error into a ValknutError::Serialization variant.

impl From<ParseFloatError> for ValknutError

Conversion from ParseFloatError to ValknutError.

fn from(err: ParseFloatError) -> Self

Converts a float parse error into a ValknutError::Validation variant.

impl From<ParseIntError> for ValknutError

Conversion from ParseIntError to ValknutError.

fn from(err: ParseIntError) -> Self

Converts an integer parse error into a ValknutError::Validation variant.

impl From<Utf8Error> for ValknutError

Conversion from Utf8Error to ValknutError.

fn from(err: Utf8Error) -> Self

Converts a UTF-8 error into a ValknutError::Parse variant.