Enum TransportError 

pub enum TransportError {
    PackNotFound,
    AccessDenied,
    RemoteError(String),
    RefConflict,
    InvalidRef(String),
    ConnectionFailed,
    ServerError {
        status: u16,
    },
    InvalidResponse,
    ProtocolError,
    PayloadTooLarge(usize),
    InsecureScheme,
}

Errors that any transport may surface across the Transport boundary. Implementations MAY wrap transport-specific errors internally but MUST map them to one of these variants before returning.

Variants

PackNotFound

download_pack called on a digest the remote does not hold.

AccessDenied

Authentication or ACL failure (HTTP 401/403, SSH auth refusal, S3 SignatureDoesNotMatch, …).

RemoteError(String)

Catch-all remote-side failure carrying an advisory message. The message is for operators; programs MUST NOT pattern-match on its contents.

RefConflict

update_ref CAS precondition was not satisfied. Per SPEC-TRANSPORT §7, callers MUST treat this as “possibly-success on retry” for .missing / .match and confirm with read_ref.

InvalidRef(String)

Caller passed a ref name failing SPEC-REFS §3.

ConnectionFailed

Network-level failure: DNS, TCP connect, TLS handshake, SSH subprocess spawn. Retryable (see is_retryable).

ServerError

Unexpected HTTP status or transport-protocol error. 5xx and 429 are retryable; 4xx (except 401/403/404/409/412) is not.

Fields

status: u16

Numeric status code. HTTP uses its native codes; transports without a status integer use 0.

InvalidResponse

Server response did not match the wire contract (truncated frame, unknown opcode, bad JSON, …).

ProtocolError

Generic protocol-level failure — malformed frame, unexpected opcode order, or failed handshake.

PayloadTooLarge(usize)

Payload exceeded a transport-specific cap.

InsecureScheme

An insecure URL scheme (plain http://) was supplied for a non-loopback host. Plain HTTP is restricted to loopback addresses (127.0.0.1, ::1, localhost) so production traffic is never transported in the clear.

Trait Implementations

impl Debug for TransportError

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

Formats the value using the given formatter.

impl Display for TransportError

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

Formats the value using the given formatter.

impl Error for TransportError

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.