Struct Path 

pub struct Path<T>(pub T);

Path parameter extractor.

Extracts path parameters from the URL and deserializes them to type T.

Supported Types

• Single value: Path<i64> extracts the first (or only) path parameter
• Tuple: Path<(String, i64)> extracts parameters in order
• Struct: Path<MyParams> extracts parameters by field name

Error Responses

• 500 Internal Server Error: Path parameters not set by router (server bug)
• 422 Unprocessable Entity: Parameter missing or type conversion failed

Examples

Single Parameter

#[get("/users/{id}")]
async fn get_user(Path(id): Path<i64>) -> impl IntoResponse {
    format!("User ID: {id}")
}

Multiple Parameters (Tuple)

#[get("/users/{user_id}/posts/{post_id}")]
async fn get_post(Path((user_id, post_id)): Path<(i64, i64)>) -> impl IntoResponse {
    format!("User {user_id}, Post {post_id}")
}

Struct Extraction

#[derive(Deserialize)]
struct PostPath {
    user_id: i64,
    post_id: i64,
}

#[get("/users/{user_id}/posts/{post_id}")]
async fn get_post(Path(path): Path<PostPath>) -> impl IntoResponse {
    format!("User {}, Post {}", path.user_id, path.post_id)
}

Tuple Fields

0: T

Implementations

impl<T> Path<T>

pub fn into_inner(self) -> T

Unwrap the inner value.

Trait Implementations

impl<T: Clone> Clone for Path<T>

fn clone(&self) -> Path<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Path<T>

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

Formats the value using the given formatter.

impl<T: Default> Default for Path<T>

fn default() -> Path<T>

Returns the “default value” for a type.

impl<T> Deref for Path<T>

type Target = T

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<T> DerefMut for Path<T>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T: DeserializeOwned> FromRequest for Path<T>

type Error = PathExtractError

Error type when extraction fails.

async fn from_request( _ctx: &RequestContext, req: &mut Request, ) -> Result<Self, Self::Error>

Extract a value from the request.

impl<T: Copy> Copy for Path<T>