Struct UriTemplate 

pub struct UriTemplate { /* private fields */ }

An immutable, source-preserving RFC 6570 Level 4 template AST.

Implementations

impl UriTemplate

pub fn parse(source: impl AsRef<str>) -> Result<Self, UriTemplateError>

Parses a complete RFC 6570 Level 4 URI template.

pub fn source(&self) -> &str

Returns the exact source text used to construct this template.

pub fn parts(&self) -> &[UriTemplatePart]

Returns the source-preserving AST parts in expansion order.

pub fn expand( &self, values: &TemplateValues, ) -> Result<String, UriTemplateError>

Expands the template using the default hard-bounded limits.

pub fn expand_with_limits( &self, values: &TemplateValues, limits: UriTemplateExpansionLimits, ) -> Result<String, UriTemplateError>

Expands the template using caller-tightened, hard-bounded limits.

pub fn compile_reversible( &self, ) -> Result<ReversibleResourceTemplate, UriTemplateError>

Compiles this template for deterministic, byte-exact reverse matching.

RFC 6570 permits expansions that do not have a unique inverse. This operation deliberately admits only the scalar dispatch subset whose captures can be reconstructed without normalization or guessing.

Trait Implementations

impl AsRef<str> for UriTemplate

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

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

Formats the value using the given formatter.

impl Display for UriTemplate

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

Formats the value using the given formatter.

impl Eq for UriTemplate

impl FromStr for UriTemplate

type Err = UriTemplateError

The associated error which can be returned from parsing.

fn from_str(source: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for UriTemplate

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for UriTemplate

impl TryFrom<&UriTemplate> for ReversibleResourceTemplate

type Error = UriTemplateError

The type returned in the event of a conversion error.

fn try_from(template: &UriTemplate) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<UriTemplate> for ReversibleResourceTemplate

type Error = UriTemplateError

The type returned in the event of a conversion error.

fn try_from(template: UriTemplate) -> Result<Self, Self::Error>

Performs the conversion.