Enum ConnectionStatus 

pub enum ConnectionStatus {
    NeverTried,
    Connecting,
    Connected,
    RetryPending,
    Failed(ConnectionFailureKind),
}

Represents the current status of a connection attempt for a host/plugin pair.

This enum tracks the lifecycle of a connection attempt, from the initial state through various stages of connection establishment, including success, retry, and failure states. It is used within ConnectionAttemptState to provide high-level information about the current state of a connection.

Variants

• NeverTried - No connection attempt has been made yet for this host/plugin combination. This is the initial state before any connection activity.

• Connecting - A connection attempt is currently in progress. This state is set when State::begin_connection_attempt is called and indicates that the connection plugin is actively attempting to establish a connection.

• Connected - The connection has been successfully established. This state is set when State::mark_connection_connected is called and indicates that the connection is ready for use.

• RetryPending - A connection attempt has failed but will be retried. This state is set when State::mark_connection_retry_pending is called and indicates that the connection will be attempted again after a delay or under different conditions.

• Failed(ConnectionFailureKind) - The connection attempt has failed and will not be retried. This state is set when State::mark_connection_failed is called and includes a ConnectionFailureKind that classifies the type of failure that occurred (e.g., timeout, authentication failure, DNS error).

Examples

// Check different connection states
let connecting = ConnectionStatus::Connecting;
let connected = ConnectionStatus::Connected;
let failed = ConnectionStatus::Failed(ConnectionFailureKind::Timeout);

assert_eq!(connecting, ConnectionStatus::Connecting);
assert_eq!(connected, ConnectionStatus::Connected);
assert!(matches!(failed, ConnectionStatus::Failed(_)));

Variants

NeverTried

Connecting

Connected

RetryPending

Failed(ConnectionFailureKind)

Trait Implementations

impl Clone for ConnectionStatus

fn clone(&self) -> ConnectionStatus

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectionStatus

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

Formats the value using the given formatter.

impl Eq for ConnectionStatus

impl PartialEq for ConnectionStatus

fn eq(&self, other: &ConnectionStatus) -> 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 StructuralPartialEq for ConnectionStatus