Enum EgressError 

pub(crate) enum EgressError {
    Transport(TransportError),
}

What writing to a destination can fail with.

Deliberately narrower than ProxyError: this module hands bytes to a transport and abandons streams, and those are the only two ways it can fail. Naming them separately is what lets a sink be implemented without naming a crate-wide error enum whose listener, TLS, certificate, qlog and draft-admission cases a write can never produce — and the recording sink below is the second implementor, so “without naming it” is not hypothetical.

Nothing a caller sees changes: the conversion below is applied by ? at every boundary this module is called across, and it produces the same ProxyError the failure produced before.

One case, and the enum is still the right shape. Every failure reaching here today comes back from the transport, which is a fact about the two operations rather than about the one production implementor — so a second case would be a second kind of failure, not a second sink, and would want a name of its own. The recording sink below models a refused write as a refused write for the same reason: a test sink inventing a failure the transport cannot produce would be testing a path nothing takes.

Variants

Transport(TransportError)

The transport refused a write or a reset.

Trait Implementations

impl Debug for EgressError

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

Formats the value using the given formatter.

impl Display for EgressError

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

Formats the value using the given formatter.

impl Error for EgressError

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<EgressError> for ProxyError

fn from(error: EgressError) -> Self

Converts to this type from the input type.

impl From<TransportError> for EgressError

fn from(source: TransportError) -> Self

Converts to this type from the input type.