Struct ProxyUrl 

pub struct ProxyUrl {
    pub scheme: Scheme,
    pub host: String,
    pub port: Option<u16>,
    pub username: Option<String>,
    pub password: Option<String>,
    pub path: Option<String>,
}

A parsed proxy URL — the canonical input shape for check.

The struct is intentionally small (six String / Option fields, no Vec) and is built once per ingest by ProxyUrl::parse. The owned String fields make the type 'static-safe; the check function only reads from it and never mutates. Credentials are carried for completeness but check never inspects the password component.

Example

use stygian_proxy::vendor_quirks::{ProxyUrl, Scheme};

let p = ProxyUrl::parse("http://user:pass@proxy.crawlera.com:8011/path")
    .expect("parses");
assert_eq!(p.scheme, Scheme::Http);
assert_eq!(p.host, "proxy.crawlera.com");
assert_eq!(p.port, Some(8011));
assert_eq!(p.username.as_deref(), Some("user"));
assert_eq!(p.password.as_deref(), Some("pass"));
assert_eq!(p.path.as_deref(), Some("/path"));

let p = ProxyUrl::parse("https://proxy.test:8443").expect("parses");
assert_eq!(p.scheme, Scheme::Https);
assert_eq!(p.host, "proxy.test");
assert_eq!(p.port, Some(8443));

Fields

scheme: Scheme

URL scheme.

host: String

Host portion of the URL (lower-case, no brackets).

port: Option<u16>

Optional port. None means the scheme default (80 for HTTP, 443 for HTTPS).

username: Option<String>

Optional user-info username. Never logged by check.

password: Option<String>

Optional user-info password. Never logged, matched, or echoed by check.

path: Option<String>

Optional path component (e.g. "/" for http://host:80/).

Implementations

impl ProxyUrl

pub fn parse(url: &str) -> Result<Self, ParseError>

Parse a proxy URL into a ProxyUrl.

Recognises http://, https://, and (when the socks feature is enabled) socks4:// / socks5:// schemes. IPv6 literals in brackets (e.g. http://[::1]:8080) are supported. User-info is split on the first : after the // separator so passwords containing colons survive intact.

Errors

Returns ParseError when the URL is structurally invalid. The error message includes the original URL for diagnostics.

Example

use stygian_proxy::vendor_quirks::{ProxyUrl, Scheme};

let p = ProxyUrl::parse("http://user:pa:ss@host:8080").unwrap();
assert_eq!(p.scheme, Scheme::Http);
assert_eq!(p.host, "host");
assert_eq!(p.port, Some(8080));
assert_eq!(p.username.as_deref(), Some("user"));
// Passwords containing colons are preserved.
assert_eq!(p.password.as_deref(), Some("pa:ss"));

Trait Implementations

impl Clone for ProxyUrl

fn clone(&self) -> ProxyUrl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyUrl

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

Formats the value using the given formatter.

impl Eq for ProxyUrl

impl PartialEq for ProxyUrl

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ProxyUrl