Struct UriTemplateLabel 

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

A label for the URL template that can be attached to HTTP requests as an extension.

This type is a workaround for cases where a templated URI cannot be used. When possible, prefer using templated URIs via the #[templated] macro from templated_uri, as they provide better type safety and automatic template extraction.

When both a templated URI and a UriTemplateLabel are present on a request, the explicit UriTemplateLabel takes precedence.

Example

use http_extensions::{HttpRequestBuilder, UriTemplateLabel};

let request = HttpRequestBuilder::new_fake()
    .get("https://example.com/api/users/123")
    .extension(UriTemplateLabel::new("/api/users/{id}"))
    .build()
    .unwrap();

Implementations

impl UriTemplateLabel

pub fn new(label: impl Into<Cow<'static, str>>) -> Self

Creates a new UriTemplateLabel from any type that can be converted to a Cow<'static, str>.

This accepts static strings, owned Strings, or Cow<'static, str> directly.

pub const fn new_static(label: &'static str) -> Self

Creates a new UriTemplateLabel from a static string.

This is a const function that can be used in const contexts.

pub fn as_str(&self) -> &str

Returns the label as a string slice.

pub fn into_cow(self) -> Cow<'static, str>

Converts the template into Cow<'static, str>.

Trait Implementations

impl AsRef<str> for UriTemplateLabel

fn as_ref(&self) -> &str

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

impl Clone for UriTemplateLabel

fn clone(&self) -> UriTemplateLabel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UriTemplateLabel

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

Formats the value using the given formatter.

impl Display for UriTemplateLabel

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

Formats the value using the given formatter.

impl From<&'static str> for UriTemplateLabel

fn from(label: &'static str) -> Self

Converts to this type from the input type.

impl From<String> for UriTemplateLabel

fn from(label: String) -> Self

Converts to this type from the input type.

impl From<UriTemplateLabel> for Cow<'static, str>

fn from(label: UriTemplateLabel) -> Self

Converts to this type from the input type.