Struct Normalizer 

pub struct Normalizer { /* private fields */ }

Available on crate feature alloc only.

A configurable URI/IRI (reference) normalizer.

Implementations

impl Normalizer

pub fn new() -> Self

Creates a new Normalizer with default configuration.

pub fn allow_path_underflow(self, value: bool) -> Self

Sets whether to allow underflow in path normalization.

This defaults to true. A value of false is a deviation from the normalization methods described in Section 6 of RFC 3986.

Examples

use fluent_uri::{normalize::{Normalizer, NormalizeError}, Uri};

let normalizer = Normalizer::new().allow_path_underflow(false);
let uri = Uri::parse("http://example.com/..")?;

assert_eq!(normalizer.normalize(&uri).unwrap_err(), NormalizeError::PathUnderflow);

pub fn default_port_with(self, f: fn(&Scheme) -> Option<u16>) -> Self

Sets the function with which to get the default port of a scheme.

This defaults to Scheme::default_port.

Examples

use fluent_uri::{component::Scheme, normalize::Normalizer, Uri};

const SCHEME_FOO: &Scheme = Scheme::new_or_panic("foo");

let normalizer = Normalizer::new().default_port_with(|scheme| {
    if scheme == SCHEME_FOO {
        Some(4673)
    } else {
        scheme.default_port()
    }
});
let uri = Uri::parse("foo://localhost:4673")?;

assert_eq!(normalizer.normalize(&uri).unwrap(), "foo://localhost");

pub fn normalize<R: RiMaybeRef>( &self, r: &R, ) -> Result<R::WithVal<String>, NormalizeError>

where R::Val: Bos<str>,

Normalizes the given URI/IRI (reference).

See Uri::normalize for the exact behavior of this method.

Errors

Returns Err if an underflow occurred in path normalization when allow_path_underflow is set to false.

Trait Implementations

impl Clone for Normalizer

fn clone(&self) -> Normalizer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Normalizer

fn default() -> Self

Returns the “default value” for a type.

impl Copy for Normalizer