Struct Duper 

pub struct Duper<T>(pub T);

Duper extractor / response.

When used as an extractor, it can deserialize request bodies into some type that implements DeserializeOwned. The request will be rejected (and a DuperRejection will be returned) if:

• The request doesn’t have a Content-Type: application/duper or Content-Type: application/x-duper header.
• The body doesn’t contain a syntactically valid Duper value.
• The body contains a syntactically valid Duper value, but it couldn’t be deserialized into the target type.
• Buffering the request body fails.

Since parsing Duper values requires consuming the request body, the Duper extractor must be last if there are multiple extractors in a handler.

Extractor example

use axum::{Router, routing::post};
use axum_duper::Duper;
use serde::Deserialize;

#[derive(Deserialize)]
struct CreateUser {
    email: String,
    password: String,
}

async fn create_user(Duper(payload): Duper<CreateUser>) {
    // payload is a `CreateUser`
}

let app = Router::new().route("/users", post(create_user));

When used as a response, it can serialize any type that implements Serialize to Duper, and will automatically set the Content-Type: application/duper header.

If the Serialize implementation decides to fail, or if a map with non-string keys is used, a 500 response will be issued, whose body is the error message in UTF-8.

Response example

use axum::{Router, routing::get, extract::Path};
use axum_duper::Duper;
use serde::Serialize;
use uuid::Uuid;

#[derive(Serialize)]
struct User {
    id: Uuid,
    username: String,
}

async fn get_user(Path(user_id) : Path<Uuid>) -> Duper<User> {
    let user = find_user(user_id).await;
    Duper(user)
}

async fn find_user(user_id: Uuid) -> User {
    // ...
}

let app = Router::new().route("/users/{id}", get(get_user));

Tuple Fields

0: T

Implementations

impl<T> Duper<T>

where T: DeserializeOwned,

pub fn from_bytes(bytes: &[u8]) -> Result<Self, DuperRejection>

Construct a Duper<T> from a byte slice. Most users should prefer to use the FromRequest impl, but special cases may require first extracting a Request into Bytes, then optionally constructing a Duper<T>.

pub fn from_string(string: &str) -> Result<Self, DuperRejection>

Construct a Duper<T> from a str slice. Most users should prefer to use the FromRequest impl, but special cases may require first extracting a Request into String, then optionally constructing a Duper<T>.

Trait Implementations

impl<T> Deref for Duper<T>

type Target = T

The resulting type after dereferencing.

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

Dereferences the value.

impl<T> From<T> for Duper<T>

fn from(value: T) -> Self

Converts to this type from the input type.

impl<T, S> FromRequest<S> for Duper<T>

where T: DeserializeOwned, S: Send + Sync,

type Rejection = DuperRejection

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request(req: Request, state: &S) -> Result<Self, Self::Rejection>

Perform the extraction.

impl<T> IntoResponse for Duper<T>

where T: Serialize,

fn into_response(self) -> Response

Create a response.

impl<T, S> OptionalFromRequest<S> for Duper<T>

where T: DeserializeOwned, S: Send + Sync,

type Rejection = DuperRejection

If the extractor fails, it will use this “rejection” type.

async fn from_request( req: Request, state: &S, ) -> Result<Option<Self>, Self::Rejection>

Perform the extraction.