Enum TransportError 

pub enum TransportError {
    Protocol(String),
    Io(Error),
    Unimplemented(&'static str),
    Refused(String),
}

What went wrong while serving.

Variants

Protocol(String)

The protocol state machine refused the request.

Io(Error)

The stream failed.

Unimplemented(&'static str)

Not wired yet. This is the honest answer until gunnar-wire lands, and it must never quietly become a successful empty response: a clone that returns no objects and exits zero looks exactly like a working server serving an empty repository (measured, not asserted).

Refused(String)

The transfer was refused before a single byte reached the client, and the string is the sentence the client is owed.

This variant exists because the other three could not carry one. A transfer that failed after the advertisement went out cannot be answered with a fresh pkt-line — the client is mid-pack and the framing belongs to gunnar-wire’s sideband, which is what UploadPack::report_error is for. A transfer that failed before the first write can be answered, and until this variant existed it was not: the session logged the whole reason and sent the client an exit status and no words, which git renders as the remote end hung up unexpectedly.

So the variant is the fact “nothing has been written yet”, not a severity. Only a construction site that knows that may use it, which is why it is a distinct variant rather than a flag on TransportError::Protocol.

Implementations

impl TransportError

pub fn client_message(&self) -> Option<String>

What the client is told, or None when the client cannot be told anything.

Named after crate::server::DispatchError::client_message and gunnar_wire::Error::client_message because it is the same contract in a third place (one implementation): a refusal the operator can see and the user cannot is half a fix.

None for TransportError::Protocol and TransportError::Io on purpose, and it is the conservative answer rather than the convenient one: those two are raised from inside a transfer that may already have written an advertisement, a NAK or half a pack, and a raw pkt-line appended to that stream is corruption, not an error message.

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.

impl From<Error> for TransportError

fn from(source: Error) -> Self

Converts to this type from the input type.