Enum HandleError 

pub enum HandleError {
    TooLong(usize),
    TooFewSegments(usize),
    EmptySegment,
    SegmentTooLong(String),
    InvalidCharacter(char),
    HyphenEdge(String),
    NumericTld(String),
    PortOffLoopback(String),
}

Why a string is not a syntactically valid handle.

Variants

TooLong(usize)

Over MAX_HANDLE_LENGTH characters.

TooFewSegments(usize)

Fewer than two segments: a bare com is not a handle.

EmptySegment

A segment was empty: a leading dot, a trailing dot, or a ...

SegmentTooLong(String)

A segment was over MAX_SEGMENT_LENGTH characters.

InvalidCharacter(char)

A character outside ASCII letters, digits, - and ..

HyphenEdge(String)

A segment started or ended with a hyphen.

NumericTld(String)

The last segment is the top-level domain, which may not start with a digit. This is what keeps 127.0.0.1 from being a handle.

PortOffLoopback(String)

A port was supplied for a handle that is not a bare loopback name.

Never produced by validate, which answers about a string on its own. It belongs here because atproto_did_url is the one place a handle turns into something fetchable, and a port outside development is the same mistake atproto refuses for a did:web.

Trait Implementations

impl Clone for HandleError

fn clone(&self) -> HandleError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HandleError

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

Formats the value using the given formatter.

impl Display for HandleError

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

Formats the value using the given formatter.

impl Error for HandleError

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 PartialEq for HandleError

fn eq(&self, other: &HandleError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for HandleError

impl StructuralPartialEq for HandleError