Enum DomainCheckError

pub enum DomainCheckError {
    InvalidDomain {
        domain: String,
        reason: String,
    },
    NetworkError {
        message: String,
        source: Option<String>,
    },
    RdapError {
        domain: String,
        message: String,
        status_code: Option<u16>,
    },
    WhoisError {
        domain: String,
        message: String,
    },
    BootstrapError {
        tld: String,
        message: String,
    },
    ParseError {
        message: String,
        content: Option<String>,
    },
    ConfigError {
        message: String,
    },
    FileError {
        path: String,
        message: String,
    },
    Timeout {
        operation: String,
        duration: Duration,
    },
    RateLimited {
        service: String,
        message: String,
        retry_after: Option<Duration>,
    },
    Internal {
        message: String,
    },
}

Main error type for domain checking operations.

This enum covers all possible failure modes in the domain checking process, providing detailed context for debugging and user-friendly error messages.

Variants

InvalidDomain

Invalid domain name format

Fields

domain: String

reason: String

NetworkError

Network-related errors (connection, timeout, etc.)

Fields

message: String

source: Option<String>

RdapError

RDAP protocol specific errors

Fields

domain: String

message: String

status_code: Option<u16>

WhoisError

WHOIS protocol specific errors

Fields

domain: String

message: String

BootstrapError

Bootstrap registry lookup failures

Fields

tld: String

message: String

ParseError

JSON parsing errors for RDAP responses

Fields

message: String

content: Option<String>

ConfigError

Configuration errors (invalid settings, etc.)

Fields

message: String

FileError

File I/O errors when reading domain lists

Fields

path: String

message: String

Timeout

Timeout errors when operations take too long

Fields

operation: String

duration: Duration

RateLimited

Rate limiting errors when servers reject requests

Fields

service: String

message: String

retry_after: Option<Duration>

Internal

Generic internal errors that don’t fit other categories

Fields

message: String

Implementations

impl DomainCheckError

pub fn invalid_domain<D: Into<String>, R: Into<String>>( domain: D, reason: R, ) -> Self

Create a new invalid domain error.

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

Create a new network error.

pub fn network_with_source<M: Into<String>, S: Into<String>>( message: M, source: S, ) -> Self

Create a new network error with source information.

pub fn rdap<D: Into<String>, M: Into<String>>(domain: D, message: M) -> Self

Create a new RDAP error.

pub fn rdap_with_status<D: Into<String>, M: Into<String>>( domain: D, message: M, status_code: u16, ) -> Self

Create a new RDAP error with HTTP status code.

pub fn whois<D: Into<String>, M: Into<String>>(domain: D, message: M) -> Self

Create a new WHOIS error.

pub fn bootstrap<T: Into<String>, M: Into<String>>(tld: T, message: M) -> Self

Create a new bootstrap error.

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

Create a new timeout error.

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

Create a new internal error.

pub fn file_error<P: Into<String>, M: Into<String>>(path: P, message: M) -> Self

Create a new file error.

pub fn indicates_available(&self) -> bool

Check if this error indicates the domain is definitely available.

Some error conditions (like NXDOMAIN) actually indicate availability.

pub fn is_retryable(&self) -> bool

Check if this error suggests the operation should be retried.

Trait Implementations

impl Clone for DomainCheckError

fn clone(&self) -> DomainCheckError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DomainCheckError

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

Formats the value using the given formatter.

impl Display for DomainCheckError

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

Formats the value using the given formatter.

impl Error for DomainCheckError

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 DomainCheckError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DomainCheckError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DomainCheckError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DomainCheckError

fn from(err: Error) -> Self

Converts to this type from the input type.