Struct Path 

pub struct Path<E> { /* private fields */ }

Extracts path parameters as cache key parts.

Uses actix-router patterns to match and extract named segments from the request path.

Type Parameters

• E - The inner extractor to chain with. Use Path::new to start a new extractor chain (uses NeutralExtractor internally), or use the PathExtractor extension trait to chain onto an existing extractor.

Pattern Syntax

• {name} — captures a path segment (characters until /)
• {name:regex} — captures with regex constraint (e.g., {id:\d+})
• {tail}* — captures remaining path (e.g., /blob/{path}* matches /blob/a/b/c)

Examples

use hitbox_http::extractors::Path;

// Extract user_id and post_id from "/users/42/posts/123"
let extractor = Path::new("/users/{user_id}/posts/{post_id}");

Using the builder pattern:

use hitbox_http::extractors::{Method, path::PathExtractor};

let extractor = Method::new()
    .path("/api/v1/users/{user_id}");

Key Parts Generated

For path /users/42/posts/123 with pattern /users/{user_id}/posts/{post_id}:

• KeyPart { key: "user_id", value: Some("42") }
• KeyPart { key: "post_id", value: Some("123") }

Format Examples

Request Path	Pattern	Generated Key Parts
/users/42	/users/{id}	id=42
/api/v2/items	/api/{version}/items	version=v2
/files/docs/report.pdf	/files/{path}*	path=docs/report.pdf
/orders/123/items/456	/orders/{order_id}/items/{item_id}	order_id=123&item_id=456

Implementations

impl<S> Path<NeutralExtractor<S>>

pub fn new(resource: &str) -> Self

Creates a path extractor that captures named segments from request paths.

Each captured segment becomes a cache key part with the segment name as key. See the struct documentation for pattern syntax.

Chain onto existing extractors using PathExtractor::path instead if you already have an extractor chain.

Trait Implementations

impl<E: Debug> Debug for Path<E>

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

Formats the value using the given formatter.

impl<ReqBody, E> Extractor for Path<E>

where ReqBody: Body + Send + 'static, ReqBody::Error: Send, E: Extractor<Subject = CacheableHttpRequest<ReqBody>> + Send + Sync,

type Subject = <E as Extractor>::Subject

The type from which cache key components are extracted.

fn get<'life0, 'async_trait>( &'life0 self, subject: Self::Subject, ) -> Pin<Box<dyn Future<Output = KeyParts<Self::Subject>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Extract cache key components from the subject.