Enum ProxyEntry 

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

Whether a given Scheme uses a proxy at all.

Three answers, not two. Disabled exists so that “this scheme explicitly does not use a proxy” can be distinguished from “this scheme was not configured” — the former suppresses the Scheme::All fallback, the latter does not. Unusable is the third: the scheme was configured, and what it was configured with could not be read. Absence therefore means only “the platform said nothing about this 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.

This is the record of the drop, not an answer: routing the request would need an endpoint there is none of, and answering Disabled would claim the platform wanted a direct connection when it wanted a proxy nobody can now name. Under the resolve feature it becomes Error::ProxyEntryUnusable.

Every lookup treats it as the last resort — see ProxyMode::entry_for. A live Scheme::All is an answer the platform did configure, so it still wins; only when nothing else covers the scheme does the record answer.

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) -> ProxyEntry

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: &ProxyEntry) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ProxyEntry