Struct PathPattern 

pub struct PathPattern { /* private fields */ }

Available on non-WebAssembly only.

Path pattern for URL matching Similar to Django’s URL patterns but using composition

Implementations

impl PathPattern

pub fn new(pattern: impl Into<String>) -> Result<PathPattern, String>

Available on crate feature test only.

Create a new path pattern Patterns like “/users/{id}/” are converted to regex

Examples

use reinhardt_urls::routers::{PathPattern, path};

// Create a simple pattern without parameters
let pattern = PathPattern::new(path!("/users/")).unwrap();
assert_eq!(pattern.pattern(), "/users/");

// Create a pattern with a parameter
let pattern = PathPattern::new(path!("/users/{id}/")).unwrap();
assert_eq!(pattern.param_names(), &["id"]);

pub fn pattern(&self) -> &str

Available on crate feature test only.

Get the original pattern string

Examples

use reinhardt_urls::routers::{PathPattern, path};

let pattern = PathPattern::new(path!("/users/{id}/")).unwrap();
assert_eq!(pattern.pattern(), "/users/{id}/");

pub fn param_names(&self) -> &[String]

Available on crate feature test only.

Get the list of parameter names in the pattern

Examples

use reinhardt_urls::routers::{PathPattern, path};

let pattern = PathPattern::new(path!("/users/{user_id}/posts/{post_id}/")).unwrap();
assert_eq!(pattern.param_names(), &["user_id", "post_id"]);

pub fn is_match(&self, path: &str) -> bool

Available on crate feature test only.

Test if the pattern matches a given path

Examples

use reinhardt_urls::routers::{PathPattern, path};

let pattern = PathPattern::new(path!("/users/{id}/")).unwrap();
assert!(pattern.is_match("/users/123/"));
assert!(!pattern.is_match("/users/"));

pub fn extract_params(&self, path: &str) -> Option<HashMap<String, String>>

Available on crate feature test only.

Match a path and extract parameters

Examples

use reinhardt_urls::routers::{PathPattern, path};

let pattern = PathPattern::new(path!("/users/{id}/")).unwrap();
let params = pattern.extract_params("/users/123/").unwrap();
assert_eq!(params.get("id"), Some(&"123".to_string()));

pub fn reverse( &self, params: &HashMap<String, String>, ) -> Result<String, String>

Available on crate feature test only.

Reverse URL pattern with parameters using Aho-Corasick algorithm

This method uses pre-built Aho-Corasick automaton for efficient multi-pattern matching with O(n+m+z) complexity where:

• n: pattern length
• m: total parameter values length
• z: number of placeholder matches

Arguments

• params - HashMap of parameter names to values

Returns

• Ok(String) - Reversed URL with parameters substituted
• Err(String) - If required parameters are missing

Examples

use reinhardt_urls::routers::{PathPattern, path};
use std::collections::HashMap;

let pattern = PathPattern::new(path!("/users/{id}/posts/{post_id}/")).unwrap();

let mut params = HashMap::new();
params.insert("id".to_string(), "123".to_string());
params.insert("post_id".to_string(), "456".to_string());

let url = pattern.reverse(&params).unwrap();
assert_eq!(url, "/users/123/posts/456/");

Trait Implementations

impl Clone for PathPattern

fn clone(&self) -> PathPattern

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PathPattern

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

Formats the value using the given formatter.