Struct NoProxyEnvLayer 

pub struct NoProxyEnvLayer { /* private fields */ }

Available on crate feature net only.

Lazily apply conventional NO_PROXY bypass rules.

Lowercase no_proxy takes precedence over uppercase NO_PROXY. Entries are comma-separated. As in curl, wget, Go and Python, a plain domain such as example.com matches its apex and descendants. Leading-dot and *. forms have the same subtree behavior. Rama additionally accepts arbitrary host globs; a single * matches every host, and IP addresses and CIDR networks use typed address matching. When a rule matches, the layer inserts ProxyRoute::Direct.

Place this layer before explicit, environment, and system proxy layers to give bypass rules priority without enabling route overwrites.

The environment-variable names and core matching behavior follow curl’s proxy environment variable documentation. Rama’s arbitrary glob support is a backwards-compatible extension of that shared convention.

Implementations

impl NoProxyEnvLayer

pub fn new() -> NoProxyEnvLayer

Create a lazy layer backed by the process environment.

pub fn new_with_reader<F>(reader: F) -> NoProxyEnvLayer

where F: Fn(&str) -> Result<Option<String>, Box<dyn Error + Sync + Send>> + Send + Sync + 'static,

Create a lazy layer backed by a custom environment reader.

The reader runs synchronously during the first request and should avoid blocking I/O; concurrent callers await the same cached initialization.

pub fn with_no_proxy_env_vars( self, names: impl IntoIterator<Item = impl Into<Box<str>>>, ) -> NoProxyEnvLayer

Replace the ordered no-proxy environment-variable names.

The default is no_proxy, then NO_PROXY. Supplying no names disables environment bypass rules.

pub fn set_no_proxy_env_vars( &mut self, names: impl IntoIterator<Item = impl Into<Box<str>>>, ) -> &mut NoProxyEnvLayer

Replace the ordered no-proxy environment-variable names.

The default is no_proxy, then NO_PROXY. Supplying no names disables environment bypass rules.

pub fn with_load_error_sink(self, sink: impl ErrorSink) -> NoProxyEnvLayer

Send invalid rules or environment-read errors to an ErrorSink. Invalid individual rules are omitted while valid rules remain in effect. By default any such error rejects the request.

pub fn set_load_error_sink( &mut self, sink: impl ErrorSink, ) -> &mut NoProxyEnvLayer

Send invalid rules or environment-read errors to an ErrorSink. Invalid individual rules are omitted while valid rules remain in effect. By default any such error rejects the request.

pub fn with_overwrite(self, overwrite: bool) -> NoProxyEnvLayer

Replace an existing ProxyRoute or ProxyRoutes decision with a direct route when a no-proxy rule matches.

pub fn set_overwrite(&mut self, overwrite: bool) -> &mut NoProxyEnvLayer

Replace an existing ProxyRoute or ProxyRoutes decision with a direct route when a no-proxy rule matches.

Trait Implementations

impl Clone for NoProxyEnvLayer

fn clone(&self) -> NoProxyEnvLayer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NoProxyEnvLayer

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

Formats the value using the given formatter.

impl Default for NoProxyEnvLayer

fn default() -> NoProxyEnvLayer

Returns the “default value” for a type.

impl<S> Layer<S> for NoProxyEnvLayer

type Service = NoProxyEnvService<S>

The service produced by the layer.

fn layer(&self, inner: S) -> <NoProxyEnvLayer as Layer<S>>::Service

Wrap the given service with the middleware, returning a new service.

fn into_layer(self, inner: S) -> <NoProxyEnvLayer as Layer<S>>::Service

Same as layer but consuming self after the service was created.