Enum MantaError 

pub enum MantaError {
    IoError(Error),
    ConfigError(ConfigError),
    TomlEditError(TomlError),
    SerdeError(Error),
    NetError(Error),
    YamlError(Error),
    NotFound(String),
    MissingField(String),
    JwtMalformed(String),
    KafkaError(String),
    InvalidPattern(String),
    TemplateError(String),
    Other(String),
}

Errors returned by manta-shared’s pure helpers.

Most helpers return Result<T, MantaError>. The server-side code converts these to its richer BackendError via crates/manta-server/src/wire_conv.rs::to_backend, which then maps to HTTP status codes.

Examples

Pattern-match a NotFound to log a custom message before propagating:

use manta_shared::common::error::MantaError;

fn lookup_thing() -> Result<(), MantaError> {
  Err(MantaError::NotFound("thing 42".into()))
}

match lookup_thing() {
  Err(MantaError::NotFound(detail)) => {
    // Maps to HTTP 404 server-side.
    assert_eq!(detail, "thing 42");
  }
  _ => unreachable!(),
}

Variants

IoError(Error)

Filesystem I/O failure (config-file read, audit-log write, etc.).

ConfigError(ConfigError)

config crate failure: bad TOML, env-var parse, or schema mismatch on cli.toml / server.toml.

TomlEditError(TomlError)

toml_edit parse / serialize failure when editing a config file in place (e.g. manta config set).

SerdeError(Error)

JSON serialize / deserialize failure (most often during JWT claim extraction or audit payload construction).

NetError(Error)

reqwest failure on outbound HTTP (DNS, TLS handshake, body stream, etc.).

YamlError(Error)

YAML parse / serialize failure (SAT-file rendering).

NotFound(String)

Resource lookup failed (config file missing, group not in backend, etc.). Maps to HTTP 404 server-side.

MissingField(String)

A required field is absent (e.g. JWT lacks preferred_username, node config lacks boot_image_id).

JwtMalformed(String)

JWT was structurally invalid (wrong number of dots, undecodable claims, non-UTF-8 payload). Maps to HTTP 401.

KafkaError(String)

Kafka producer construction or delivery failed.

InvalidPattern(String)

User-supplied pattern (hardware pattern, hostlist expression, glob) didn’t parse. Maps to HTTP 400.

TemplateError(String)

Jinja2 / minijinja render failed during SAT-file processing.

Other(String)

Catch-all for messages that don’t fit any structured variant. Server-side this maps to HTTP 500 — prefer a typed variant when adding new failure modes.

Trait Implementations

impl Debug for MantaError

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

Formats the value using the given formatter.

impl Display for MantaError

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

Formats the value using the given formatter.

impl Error for MantaError

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 MantaError

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for MantaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MantaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MantaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for MantaError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<TomlError> for MantaError

fn from(source: TomlError) -> Self

Converts to this type from the input type.