Enum SondaError 

#[non_exhaustive]
pub enum SondaError {
    Config(ConfigError),
    Encoder(EncoderError),
    Sink(Error),
    Generator(GeneratorError),
    Runtime(RuntimeError),
}

Top-level error type for sonda-core.

Each variant delegates to a typed sub-enum that preserves the original error source where possible. This enables callers to programmatically inspect error origins (e.g., distinguish io::ErrorKind::NotFound from PermissionDenied in a generator file-read error) via the standard std::error::Error::source chain.

The Sink variant wraps std::io::Error without a blanket #[from] conversion — all I/O errors must be explicitly mapped to the correct variant at the call site. This prevents generator or config I/O errors from being misclassified as sink errors.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Config(ConfigError)

An error in scenario configuration (invalid values, missing fields).

Encoder(EncoderError)

An error during event encoding (serialization, timestamp, protobuf).

Sink(Error)

An I/O error originating from a sink (stdout, file, TCP, UDP, HTTP).

This variant does not use #[from] std::io::Error because not all I/O errors originate from sinks. Generator file reads, for example, produce SondaError::Generator instead.

Generator(GeneratorError)

An error from a generator (file I/O, invalid data).

Runtime(RuntimeError)

A runtime or system error (thread spawn failure, thread panic).

These are environmental failures that are outside the user’s control and cannot be fixed by editing configuration. Separated from ConfigError so that consumers matching on config errors to surface YAML validation feedback are not confused by thread panics.

Trait Implementations

impl Debug for SondaError

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

Formats the value using the given formatter.

impl Display for SondaError

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

Formats the value using the given formatter.

impl Error for SondaError

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<ConfigError> for SondaError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<EncoderError> for SondaError

fn from(source: EncoderError) -> Self

Converts to this type from the input type.

impl From<GeneratorError> for SondaError

fn from(source: GeneratorError) -> Self

Converts to this type from the input type.

impl From<RuntimeError> for SondaError

fn from(source: RuntimeError) -> Self

Converts to this type from the input type.