Crate sorug 

sorug — a blazingly fast, zero-allocation-preferred, WHATWG-compliant URL parser.

Design

• Index-based record: component boundaries live as u32 offsets into the WHATWG href serialization, keeping the struct small and cache-friendly.
• Lazy / CoW serialization: when the input is already canonical ASCII, Url borrows it with zero heap allocations; the first required mutation upgrades to an owned buffer.
• Cow on demand: percent-decoding helpers allocate only when needed.
• SIMD delimiter scans: memchr on hot path segments.
• Strict WHATWG state machine: transitions follow the URL Living Standard.

Crate features

• std (default): enables std::error::Error for ParseError, memchr’s std backend, and file-path / socket helpers.
• serde: serialize / deserialize Url as an href string.
• http: convert between Url and http::Uri (implies std).

Migration from 0.4

Additive (non-breaking):

• SearchParams::has_value / SearchParams::delete_value / SearchParams::size
• FFI: sorug_set_username / sorug_set_password / sorug_set_host

Migration from 0.3

• Origin::Opaque now wraps OpaqueOrigin; use Origin::new_opaque. Distinct opaque origins no longer compare equal.
• New (std): Url::from_file_path, Url::from_directory_path, Url::to_file_path, Url::set_ip_host, Url::socket_addrs.
• SearchParams::sort, Url::parse_with_params.

API stability (pre-1.0)

• Url<'a> borrows the input serialization when it is already canonical; call Url::into_owned before storing across mutations of the source.
• Backing is public for advanced introspection; prefer Url::as_str.
• [State] is #[doc(hidden)] and non_exhaustive — not part of the stability promise.
• See the README Semver and MSRV policy and 1.0 freeze checklist.

Migration from 0.2

• Url::join, Url::make_relative, Url::path_segments, Url::path_segments_mut, Url::query_pairs, Url::query_pairs_mut, Url::host_parsed, AsRef<str>, and core::str::FromStr.
• Optional features: serde, http; disable std with default-features = false for no_std + alloc.
• Public Host enum (Domain / Ipv4 / Ipv6) with Host::parse.
• UrlFlags::HOST_IDNA is set when the serialized host contains an ACE label (xn--).
• Port API: Url::set_port takes Option<u16> (rust-url shape); quirks/WPT string setter is Url::set_port_str.

Structs

OpaqueOrigin

Opaque identifier for non-tuple origins (file:, data:, failed blob:, …).

PathSegmentsMut

Exposes methods to manipulate the path of a URL that is not cannot-be-a-base.

QueryPairsMut

Mutable view of a URL’s query as name/value pairs.

SearchParams

A list of name/value pairs in application/x-www-form-urlencoded syntax.

SearchParamsIter

Iterator over borrowed (name, value) pairs from SearchParams.

Url

A parsed URL record backed by its WHATWG serialization (href).

UrlFlags

Compact boolean attributes of a parsed URL record.

Enums

Backing

Storage for the WHATWG href serialization.

Host

A parsed URL host: domain name, IPv4, or IPv6.

Origin

A URL origin: either an opaque origin or a (scheme, host, port) tuple.

ParseError

Failure modes of Url::parse / the basic URL parser.

Functions

parse_urlencoded

Parse application/x-www-form-urlencoded bytes into decoded name/value pairs.

serialize_urlencoded

Serialize pairs as application/x-www-form-urlencoded.

uri_to_urlhttp

Parse an http::Uri into an owned Url.