axum-accept 0.0.6

Typed accept negotiation for axum.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# axum-accept

[![status-badge](https://ci.codeberg.org/api/badges/15635/status.svg)](https://ci.codeberg.org/repos/15635)
[![crates.io](https://img.shields.io/crates/v/axum-accept.svg)](https://crates.io/crates/axum-accept)
[![docs.rs](https://docs.rs/axum-accept/badge.svg)](https://docs.rs/axum-accept/)
[![License](https://img.shields.io/crates/l/axum-accept)](LICENSE-APACHE)

Typed accept negotiation for axum, following [RFC7231](https://www.rfc-editor.org/rfc/rfc7231).

## Example

```rust
use axum::{extract::Json, response::{IntoResponse, Response}};
use axum_accept::AcceptExtractor;
use serde_json::json;

#[derive(AcceptExtractor, Default)]
enum Accept {
    #[accept(mediatype="text/plain")]
    TextPlain,
    #[default]
    #[accept(mediatype="application/json")]
    ApplicationJson,
}

async fn my_handler(accept: Accept) -> Response {
    match accept {
        Accept::TextPlain => "hello world".into_response(),
        Accept::ApplicationJson => Json(json!({ "content": "hello_world" })).into_response(),
    }
}
```

## Edge cases

Setting a default is recommended as it indicates behaviour more explicitly in
your code.
This is how axum-accept behaves on edge cases:

| Accept    | Has default               | No default                |
| --------- | ------------------------- | ------------------------- |
| `<empty>` | Default variant           | HTTP 406 (Not Acceptable) |
| `*/*`     | Default variant           | First variant             |
 
## License

Licensed under either of

 * Apache License, Version 2.0, ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
 * MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.