Struct Resolver 

pub struct Resolver<R> { /* private fields */ }

Available on crate feature alloc only.

A configurable URI/IRI reference resolver against a fixed base.

Examples

use fluent_uri::{resolve::Resolver, Uri, UriRef};

let base = Uri::parse("http://example.com/foo/bar")?;
let resolver = Resolver::with_base(base);

assert_eq!(resolver.resolve(&UriRef::parse("baz")?).unwrap(), "http://example.com/foo/baz");
assert_eq!(resolver.resolve(&UriRef::parse("../baz")?).unwrap(), "http://example.com/baz");
assert_eq!(resolver.resolve(&UriRef::parse("?baz")?).unwrap(), "http://example.com/foo/bar?baz");

Implementations

impl<R: Ri> Resolver<R>

where R::Val: Bos<str>,

pub fn with_base(base: R) -> Self

Creates a new Resolver with the given base and default configuration.

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

Sets whether to allow underflow in path resolution.

This defaults to true. A value of false is a deviation from the reference resolution algorithm defined in Section 5 of RFC 3986.

Examples

use fluent_uri::{resolve::{Resolver, ResolveError}, Uri, UriRef};

let base = Uri::parse("http://example.com/foo/bar")?;
let resolver = Resolver::with_base(base).allow_path_underflow(false);

assert_eq!(resolver.resolve(&UriRef::parse("../../baz")?).unwrap_err(), ResolveError::PathUnderflow);
assert_eq!(resolver.resolve(&UriRef::parse("../../../baz")?).unwrap_err(), ResolveError::PathUnderflow);
assert_eq!(resolver.resolve(&UriRef::parse("/../baz")?).unwrap_err(), ResolveError::PathUnderflow);

pub fn resolve<T: Bos<str>>( &self, reference: &R::Ref<T>, ) -> Result<R::WithVal<String>, ResolveError>

Resolves the given reference against the configured base.

See resolve_against for the exact behavior of this method.

Errors

Returns Err on the same conditions as resolve_against or if an underflow occurred in path resolution when allow_path_underflow is set to false.

Trait Implementations

impl<R: Clone> Clone for Resolver<R>

fn clone(&self) -> Resolver<R>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R: Debug> Debug for Resolver<R>

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

Formats the value using the given formatter.

impl<R: Copy> Copy for Resolver<R>