Struct Path 

pub struct Path<T>(pub T);

Extracts a single path parameter, parsed into T.

For a route such as "/users/{id}", Path::<u64> reads the first captured parameter ({id}). It reads positionally, so it is intended for routes with exactly one path parameter; for routes with several, read each by name with Call::param. Extraction fails with 400 Bad Request if there is no parameter or the value does not parse into T.

use churust_core::{Churust, Path, TestClient};
let app = Churust::server()
    .routing(|r| {
        r.get("/double/{n}", |Path(n): Path<i64>| async move {
            format!("{}", n * 2)
        });
    })
    .build();
let res = TestClient::new(app).get("/double/21").send().await;
assert_eq!(res.text(), "42");

Tuple Fields

0: T

The parsed path parameter 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> FromCallParts for Path<T>

where T: DeserializeOwned + Send,

fn from_call_parts<'life0, 'async_trait>( call: &'life0 mut Call, ) -> Pin<Box<dyn Future<Output = Result<Self>> + Send + 'async_trait>>

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

Build Self from a mutable borrow of the call, or return an Error (which the handler renders as the response).

impl<T> OptionalFromCallParts for Path<T>

where T: DeserializeOwned + Send,

Absent means the route captured no parameters. A parameter that is present but does not parse into T is an error — reporting None there would claim the URL had no such parameter at all.

fn from_call_parts_opt<'life0, 'async_trait>( call: &'life0 mut Call, ) -> Pin<Box<dyn Future<Output = Result<Option<Self>>> + Send + 'async_trait>>

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

Build Self, or Ok(None) when the input is absent. Reserve Err for input that was supplied and is wrong.