Struct ProxyHandle 

pub struct ProxyHandle { /* private fields */ }

A running loopback egress proxy. Dropping the handle shuts it down.

Implementations

impl ProxyHandle

pub fn addr(&self) -> SocketAddr

The loopback address the proxy listens on. A spawned child is wired via Self::proxy_env; a no-subprocess caller (#257 — e.g. a reqwest::Client) points itself here instead: reqwest::Proxy::all(format!("http://{}", handle.addr())).

pub fn refused_hosts(&self) -> Vec<String>

#196: the CONNECT hosts this proxy REFUSED (not on the allow-list), deduplicated and sorted. The shell tool reads this after the child is reaped and turns each into a Denial { kind: Net, target: host } so a consumer can prompt per-host. Empty when the child only reached allow-listed hosts (or none).

pub fn proxy_env(&self) -> Vec<(String, String)>

The *_PROXY environment the child needs to route through this proxy. Both cases are set: curl honours lowercase http_proxy (it ignores the uppercase form for CGI-safety) but uppercase HTTPS_PROXY/ALL_PROXY; other tools (wget, requests, node) read the rest.

Trait Implementations

impl Debug for ProxyHandle

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

Formats the value using the given formatter.

impl Drop for ProxyHandle

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.