Struct Builder 

pub struct Builder { /* private fields */ }

URL builder.

Components are given literally (host, user info, query pairs) or percent-encoded (path, query, fragment) and are normalized by Builder::build. A builder created from a Url modifies that URL.

use urly::Url;

let url = Url::builder()
    .scheme("https")
    .userinfo("user", Some("p@ss"))
    .host("example.com")
    .port(8443)
    .path("/search")
    .query_pair("q", "a b")
    .fragment("top")
    .build()
    .unwrap();
assert_eq!(url, "https://user:p%[email protected]:8443/search?q=a+b#top");

let url = urly::Builder::from(url).port(443).fragment("").build().unwrap();
assert_eq!(url, "https://user:p%[email protected]:443/search?q=a+b#");

Implementations

impl Builder

pub fn new() -> Self

Creates an empty builder.

pub fn scheme(self, scheme: &str) -> Self

Sets the scheme.

pub fn authority(self, authority: &str) -> Self

Sets the raw authority: [userinfo "@"] host [":" port].

Host, user info and port set separately are applied afterwards.

pub fn host(self, host: &str) -> Self

Sets the literal host, see Url::set_host.

pub fn userinfo(self, username: &str, password: Option<&str>) -> Self

Sets the literal user name and password.

pub fn port(self, port: u16) -> Self

Sets the port.

pub fn path(self, path: &str) -> Self

Sets the percent-encoded path.

pub fn query(self, query: &str) -> Self

Sets the percent-encoded query.

pub fn query_pair(self, key: &str, value: &str) -> Self

Appends a literal key-value pair to the query.

pub fn query_pairs<I, K, V>(self, pairs: I) -> Self

where I: IntoIterator<Item = (K, V)>, K: AsRef<str>, V: AsRef<str>,

Appends literal key-value pairs to the query.

pub fn fragment(self, fragment: &str) -> Self

Sets the percent-encoded fragment.

pub fn build(self) -> Result<Url, InvalidUrl>

Builds the URL.

Trait Implementations

impl Clone for Builder

fn clone(&self) -> Builder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Builder

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

Formats the value using the given formatter.

impl Default for Builder

fn default() -> Builder

Returns the “default value” for a type.

impl From<Url> for Builder

fn from(url: Url) -> Self

Converts to this type from the input type.