Enum ProxyEntry 

#[non_exhaustive]
pub enum ProxyEntry {
    Use(ProxyEndpoint),
    Disabled,
    Unusable(RejectedValue),
}

Whether a given Scheme uses a proxy at all.

Disabled distinguishes a scheme explicitly configured without a proxy from an unconfigured scheme: it suppresses the Scheme::All fallback, while an unconfigured scheme allows it. Unusable records a configured scheme whose proxy could not be read. Absence means the platform has no setting for the scheme.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Use(ProxyEndpoint)

Route this scheme through the given proxy.

Disabled

The platform named this scheme and gave it no proxy: an off switch, or a slot left blank.

Unusable(RejectedValue)

The platform named this scheme and gave it a proxy that could not be read.

Routing requires an endpoint, which is unavailable here. Returning Disabled would incorrectly treat an unreadable proxy setting as a request for a direct connection. Under the resolve feature this becomes Error::ProxyEntryUnusable.

Every lookup uses it only when no other entry covers the scheme; see ProxyMode::entry_for. A usable Scheme::All takes precedence because it supplies a usable configured fallback.

Implementations

impl ProxyEntry

pub fn endpoint(&self) -> Option<&ProxyEndpoint>

The endpoint, or None for Disabled and Unusable alike; neither has one, which is why a caller that needs to tell “go direct” from “the setting was lost” asks rejected rather than this.

pub fn is_disabled(&self) -> bool

Whether the entry is ProxyEntry::Disabled. false for Unusable: a lost setting is not an off switch.

pub fn rejected(&self) -> Option<&RejectedValue>

The drop record, for ProxyEntry::Unusable only.

Trait Implementations

impl Clone for ProxyEntry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyEntry

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

Formats the value using the given formatter.

impl Eq for ProxyEntry

impl PartialEq for ProxyEntry

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ProxyEntry