README.md

axum-media

This library provides a way to use multiple mime types for serializing and deserializing structs within the axum ecosystem. Inspired by axum's Json extractor.

[dependencies]
# Enable features such as urlencoded
axum-media = { version = "0.2.0", features = ["urlencoded"]}

Example

use axum_media::{AnyMedia, ContentType};

#[tokio::main]
async fn main() {
  let app = axum::Router::new()
    .route("/", get(index))
    .route("/login", post(login))
}

async fn index(content_type: ContentType) -> impl IntoResponse {
  // Chooses the right serializer based on the Accept header
  AnyMedia(
    serde_json::json!({
      "routes": ["/", "/login"],
    }),
    content_type,
  )
}

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

// Automatically chooses the right deserializer based on the Content-Type header
async fn login(AnyMedia(data, _): AnyMedia<LoginData>) -> String {
  data.email
}

License

^{Licensed under either of Apache License, Version 2.0 or MIT license at your option.}
_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}