Struct ProxySnapshot 

pub struct ProxySnapshot {
    configured: Option<Arc<ProxyConfig>>,
    environment: Option<EnvironmentProxy>,
    proxies: SmallVec<[Proxy; 1]>,
    hosts: ProxyHosts,
}

Captures the proxy policy used by one generation of outbound clients.

The snapshot owns environment values and configured rules so resolver, response checks, and lazily built clients retain one policy generation.

Fields

configured: Option<Arc<ProxyConfig>>

environment: Option<EnvironmentProxy>

proxies: SmallVec<[Proxy; 1]>

hosts: ProxyHosts

Implementations

impl ProxySnapshot

pub fn new(config: &ProxyConfig) -> Result<Self>

Captures the effective proxy configuration for new outbound clients.

Explicit configuration replaces reqwest’s automatic environment proxy. Otherwise the relevant environment variables are read once and normalized to the effective endpoints used by reqwest’s native matcher.

impl ProxySnapshot

pub(super) fn with_vars<F>( config: &ProxyConfig, is_cgi: bool, var: F, ) -> Result<Self>

where F: Fn(&str) -> Option<String>,

impl ProxySnapshot

pub fn configure(&self, builder: ClientBuilder) -> ClientBuilder

Applies this snapshot to an outbound HTTP client builder.

Environment proxies are explicit so later environment changes cannot alter a lazily built client.

impl ProxySnapshot

pub fn hosts(&self) -> impl Iterator<Item = &str>

Iterates over proxy endpoint names used by this snapshot.

The names include the configured surface or the effective environment proxies, never both.

impl ProxySnapshot

pub fn shared_hosts(&self) -> ProxyHosts

Shares proxy endpoint names with a validating resolver.

Cloning the returned value increments one reference count and does not duplicate any hostname.

impl ProxySnapshot

pub fn intercepts(&self, url: &Url) -> bool

Reports whether this snapshot carries a request URL through a proxy.

Environment matching preserves scheme selection and NO_PROXY; explicit rules use the configuration predicate.

impl ProxySnapshot

pub fn resolver_alias(&self, url: &Url) -> bool

Reports a destination that can alias a proxy resolver exemption.

Direct requests and local-DNS SOCKS requests resolve the destination in this process, so guarded clients reject an endpoint-name collision.

impl ProxySnapshot

fn proxy_scheme(&self, url: &Url) -> Option<ProxyScheme>