Struct UriTemplate 

pub struct UriTemplate(/* private fields */);

Available on crate feature net only.

A parsed RFC 6570 URI Template, levels 1 to 3.

Cloning is cheap: the parsed form is shared.

use rama_net::uri::UriTemplate;

let template = UriTemplate::try_new("/masque{?target_host,target_port}").unwrap();
let host = template.variable("target_host").unwrap();
let port = template.variable("target_port").unwrap();
let expanded = template.expand(|v| {
    if v == host { Some("2001:db8::42") } else if v == port { Some("443") } else { None }
});
assert_eq!(expanded, "/masque?target_host=2001%3Adb8%3A%3A42&target_port=443");

Implementations

impl UriTemplate

pub fn try_new( template: impl AsRef<str>, ) -> Result<UriTemplate, UriTemplateError>

Parse a URI Template of level 3 or lower.

pub fn as_str(&self) -> &str

The template text.

pub fn variable(&self, name: &str) -> Option<TemplateVariable>

The variable with this name, if the template names it.

pub fn variable_name(&self, variable: TemplateVariable) -> Option<&str>

The name of a variable of this template.

pub fn variables(&self) -> impl ExactSizeIterator

All distinct variables in order of first appearance.

pub fn operators(&self) -> impl Iterator<Item = TemplateOperator>

Every operator used by the template’s expressions, in order.

pub fn expand<'v>( &self, value: impl Fn(TemplateVariable) -> Option<&'v str>, ) -> String

Expand the template; value returns None for an undefined variable.

pub fn expand_to<'v>( &self, out: &mut String, value: impl Fn(TemplateVariable) -> Option<&'v str>, )

Expand the template, appending to out.

Trait Implementations

impl Clone for UriTemplate

fn clone(&self) -> UriTemplate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UriTemplate

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

Formats the value using the given formatter.

impl Display for UriTemplate

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

Formats the value using the given formatter.

impl Eq for UriTemplate

impl Hash for UriTemplate

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for UriTemplate

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

Equality operator ==.

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

Inequality operator !=.