Enum ConnectError 

pub enum ConnectError {
    Unsupported {
        kind: TransportKind,
        reason: &'static str,
    },
    Spec(SpecError),
    Config(ClientError),
    Versions(SupportedVersionsError),
    Handshake(HandshakeError),
    NoCommonVersion(NegotiationError),
    HttpEndpoint(HttpClientError),
    LegacySse(LegacySseError),
}

Why a session could not be opened.

Collapses five failure sources into one so a caller can handle “could not connect” as one arm, and read which of the four stages failed by matching the variant. The inner errors are kept rather than flattened to strings, because a caller retrying on a transient transport fault needs to tell that apart from a server that will never speak a common revision.

Variants

Unsupported

The spec names a transport this crate has no client adapter for.

A refusal rather than a half-open connection: a caller told only that connecting failed cannot tell “wrong URL” from “this build has no such adapter”, and retries the first forever.

Fields

kind: TransportKind

The transport that was asked for.

reason: &'static str

Why it cannot be opened.

Spec(SpecError)

The spec itself was unusable.

Config(ClientError)

The offered revisions were not a usable set.

Versions(SupportedVersionsError)

The default offered revisions could not be built.

Handshake(HandshakeError)

The handshake did not complete.

NoCommonVersion(NegotiationError)

The two sides share no revision.

HttpEndpoint(HttpClientError)

A Streamable HTTP endpoint could not be prepared.

LegacySse(LegacySseError)

A legacy HTTP+SSE endpoint could not be opened.

Trait Implementations

impl Debug for ConnectError

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

Formats the value using the given formatter.

impl Display for ConnectError

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

Formats the value using the given formatter.

impl Error for ConnectError

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<ClientError> for ConnectError

fn from(source: ClientError) -> Self

Converts to this type from the input type.

impl From<HandshakeError> for ConnectError

fn from(source: HandshakeError) -> Self

Converts to this type from the input type.

impl From<HttpClientError> for ConnectError

fn from(source: HttpClientError) -> Self

Converts to this type from the input type.

impl From<LegacySseError> for ConnectError

fn from(source: LegacySseError) -> Self

Converts to this type from the input type.

impl From<NegotiationError> for ConnectError

fn from(source: NegotiationError) -> Self

Converts to this type from the input type.

impl From<SpecError> for ConnectError

fn from(source: SpecError) -> Self

Converts to this type from the input type.

impl From<SupportedVersionsError> for ConnectError

fn from(source: SupportedVersionsError) -> Self

Converts to this type from the input type.