Enum Proxy

pub enum Proxy {
    HTTP(HttpProxy),
    Socket(Socket5Proxy),
}

Configuration of a proxy that a Client should pass requests to.

A Proxy has a couple pieces to it:

• a URL of how to talk to the proxy
• rules on what Client requests should be directed to the proxy

For instance, let’s look at Proxy::http:

let proxy = slinger::Proxy::parse("https://secure.example")?;

This proxy will intercept all HTTP requests, and make use of the proxy at https://secure.example. A request to http://hyper.rs will talk to your proxy. A request to https://hyper.rs will not.

Multiple Proxy rules can be configured for a Client. The Client will check each Proxy in the order it was added. This could mean that a Proxy added first with eager intercept rules, such as Proxy::all, would prevent a Proxy later in the list from ever working, so take care.

By enabling the "socks" feature it is possible to use a socks proxy:

let proxy = slinger::Proxy::parse("socks5://192.168.1.1:9000")?;

Variants

HTTP(HttpProxy)

HTTP or HTTPS

Socket(Socket5Proxy)

SOCKS5

Implementations

impl Proxy

pub fn uri(&self) -> Uri

Convert Proxy to a URL

pub fn parse<U>(url: U) -> Result<Self>

where Uri: TryFrom<U>, <Uri as TryFrom<U>>::Error: Into<Error>,

Convert a URL into a proxy

Supported schemes: HTTP, HTTPS, (SOCKS5, SOCKS5H).

Examples found in repository

examples/proxy.rs (line 5)

fn main() -> Result<(), Box<dyn std::error::Error>> {
  let proxy = slinger::Proxy::parse("http://127.0.0.1:8080").unwrap();
  let client = ClientBuilder::new().proxy(proxy).build().unwrap();
  let resp = client.get("https://httpbin.org/get").send()?;
  println!("{:?}", resp.text());
  Ok(())
}

Trait Implementations

impl Clone for Proxy

fn clone(&self) -> Proxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Proxy

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

Formats the value using the given formatter.

impl PartialEq for Proxy

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Proxy