Enum Error 

pub enum Error {
    PolicyViolation {
        reason: String,
        hint: String,
    },
    Api {
        message: String,
    },
    Http {
        status: u16,
        body: String,
    },
    Network(Error),
    InvalidJson(Error),
    Parse {
        context: String,
    },
    Config {
        context: String,
    },
    Mime(Error),
    Unsupported {
        vendor: &'static str,
        feature: &'static str,
    },
    Forbidden {
        message: String,
    },
    Io {
        context: String,
        source: Error,
    },
    UserCancelled,
    Mcp {
        context: String,
    },
}

All errors that can be produced by this crate.

Variants

PolicyViolation

An operation was blocked by the active server policy (read-only or zone restriction).

Fields

reason: String

hint: String

Api

The Technitium API returned {"status":"error","errorMessage":"..."}.

Fields

message: String

Http

The server returned a non-2xx HTTP status with no API-level error body.

Fields

status: u16

body: String

Network(Error)

A network-level failure — connection refused, timeout, DNS resolution, etc.

InvalidJson(Error)

The HTTP response body could not be decoded as JSON.

Parse

A well-formed API response could not be parsed into the expected shape.

Fields

context: String

Config

The config file could not be read or is structurally invalid.

Fields

context: String

Mime(Error)

A MIME type string was rejected by reqwest (should never happen in practice).

Unsupported

An operation not supported by this vendor backend.

Fields

vendor: &'static str

feature: &'static str

Forbidden

The API token lacks the required permissions (HTTP 403).

Fields

message: String

Io

An I/O error — typically reading a zone file from disk.

Fields

context: String

source: Error

UserCancelled

The user cancelled an interactive operation (Ctrl-C, Esc, etc.).

Mcp

An MCP transport or server-startup failure.

Fields

context: String

Implementations

impl Error

pub fn is_transient(&self) -> bool

True for transient failures the user might retry (network, timeout).

pub fn is_api_error(&self) -> bool

True when the server explicitly rejected the request.

pub fn exit_code(&self) -> i32

Suggested process exit code for CLI use.

pub fn policy_violation( reason: impl Into<String>, hint: impl Into<String>, ) -> Self

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

pub fn parse(context: impl Into<String>) -> Self

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

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

pub fn unsupported(vendor: &'static str, feature: &'static str) -> Self

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

pub fn cancelled() -> Self

pub fn mcp(context: impl Into<String>) -> Self

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Diagnostic for Error

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for Error

fn fmt(&self, __formatter: &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.