Struct RoutePath 

pub struct RoutePath { /* private fields */ }

Representa una ruta como un path inicial más una lista opcional de parámetros.

Modela rutas del estilo /path/to/resource?foo=bar&debug o https://example.com/path?foo=bar, pensadas para usarse en atributos HTML como href, action o src.

RoutePath no valida ni interpreta la estructura del path; simplemente concatena los parámetros de consulta sobre el valor proporcionado.

Ejemplos

// Ruta relativa con parámetros y una *flag* sin valor.
let route = RoutePath::new("/search")
    .with_param("q", "rust")
    .with_param("page", "2")
    .with_flag("debug");
assert_eq!(route.to_string(), "/search?q=rust&page=2&debug");

// Ruta absoluta a un recurso externo.
let external = RoutePath::new("https://example.com/export").with_param("format", "csv");
assert_eq!(external.to_string(), "https://example.com/export?format=csv");

Implementations

impl RoutePath

pub fn new(path: impl Into<CowStr>) -> Self

Crea un RoutePath a partir de un path inicial.

Por ejemplo: RoutePath::new("/about").

pub fn with_param( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Añade o sustituye un parámetro key=value. Si la clave ya existe, el valor se sobrescribe.

También añade el método alter_param() generado por #[builder_fn]

Permite modificar la instancia (&mut self) con los mismos argumentos pero sin consumirla.

pub fn alter_param(&mut self, ...) -> &mut Self

pub fn with_flag(self, flag: impl Into<String>) -> Self

Añade o sustituye un flag sin valor, por ejemplo ?debug.

También añade el método alter_flag() generado por #[builder_fn]

Permite modificar la instancia (&mut self) con los mismos argumentos pero sin consumirla.

pub fn alter_flag(&mut self, ...) -> &mut Self

pub fn path(&self) -> &str

Devuelve el path inicial tal y como se pasó a RoutePath::new, sin parámetros.

Trait Implementations

impl Default for RoutePath

fn default() -> Self

Returns a RoutePath default.

impl Display for RoutePath

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

Formats the value using the given formatter.

impl From<&'static str> for RoutePath

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

Converts to this type from the input type.

impl From<String> for RoutePath

fn from(path: String) -> Self

Converts to this type from the input type.