105 lines
6.0 KiB
Markdown
105 lines
6.0 KiB
Markdown
# axum-valid
|
|
|
|
[](https://crates.io/crates/axum-valid)
|
|
[](https://github.com/gengteng/axum-valid/blob/main/LICENSE)
|
|
[](https://deps.rs/repo/github/gengteng/axum-valid)
|
|
[](https://github.com/gengteng/axum-valid/actions/workflows/ci.yml)
|
|
[](https://coveralls.io/github/gengteng/axum-valid?branch=main)
|
|
|
|
This crate provides a `Valid` type that can be used in combination with `Json`, `Path`, `Query`, and `Form` extractors to validate the entities that implement the `Validate` trait from the `validator` crate.
|
|
|
|
Additional extractors like `TypedHeader`, `MsgPack`, `Yaml` etc. are supported through optional features. The full list of supported extractors is in the Features section below.
|
|
|
|
## Basic usage
|
|
|
|
```shell
|
|
cargo add axum-valid
|
|
```
|
|
|
|
```rust,no_run
|
|
use validator::Validate;
|
|
use serde::Deserialize;
|
|
use axum_valid::Valid;
|
|
use axum::extract::Query;
|
|
use axum::{Json, Router};
|
|
use axum::routing::{get, post};
|
|
|
|
#[derive(Debug, Validate, Deserialize)]
|
|
pub struct Pager {
|
|
#[validate(range(min = 1, max = 50))]
|
|
pub page_size: usize,
|
|
#[validate(range(min = 1))]
|
|
pub page_no: usize,
|
|
}
|
|
|
|
pub async fn pager_from_query(
|
|
Valid(Query(pager)): Valid<Query<Pager>>,
|
|
) {
|
|
assert!((1..=50).contains(&pager.page_size));
|
|
assert!((1..).contains(&pager.page_no));
|
|
}
|
|
|
|
pub async fn pager_from_json(
|
|
Valid(Json(pager)): Valid<Json<Pager>>,
|
|
) {
|
|
assert!((1..=50).contains(&pager.page_size));
|
|
assert!((1..).contains(&pager.page_no));
|
|
}
|
|
|
|
#[tokio::main]
|
|
async fn main() -> anyhow::Result<()> {
|
|
let router = Router::new()
|
|
.route("/query", get(pager_from_query))
|
|
.route("/json", post(pager_from_json));
|
|
axum::Server::bind(&([0u8, 0, 0, 0], 8080).into())
|
|
.serve(router.into_make_service())
|
|
.await?;
|
|
Ok(())
|
|
}
|
|
```
|
|
|
|
When validation errors occur, the extractor will automatically return 400 with validation errors as the HTTP message body.
|
|
|
|
To see how each extractor can be used with `Valid`, please refer to the example in the [documentation](https://docs.rs/axum-valid) of the corresponding module.
|
|
|
|
## Features
|
|
|
|
| Feature | Description | Default | Example | Tests |
|
|
|------------------|------------------------------------------------------------------------------------------------------|---------|---------|-------|
|
|
| default | Enables support for `Path`, `Query`, `Json` and `Form` | ✅ | ✅ | ✅ |
|
|
| json | Enables support for `Json` | ✅ | ✅ | ✅ |
|
|
| query | Enables support for `Query` | ✅ | ✅ | ✅ |
|
|
| form | Enables support for `Form` | ✅ | ✅ | ✅ |
|
|
| typed_header | Enables support for `TypedHeader` | ❌ | ✅ | ✅ |
|
|
| typed_multipart | Enables support for `TypedMultipart` and `BaseMultipart` from `axum_typed_multipart` | ❌ | ✅ | ✅ |
|
|
| msgpack | Enables support for `MsgPack` and `MsgPackRaw` from `axum-msgpack` | ❌ | ✅ | ✅ |
|
|
| yaml | Enables support for `Yaml` from `axum-yaml` | ❌ | ✅ | ✅ |
|
|
| extra | Enables support for `Cached`, `WithRejection` from `axum-extra` | ❌ | ✅ | ✅ |
|
|
| extra_typed_path | Enables support for `T: TypedPath` from `axum-extra` | ❌ | ✅ | ✅ |
|
|
| extra_query | Enables support for `Query` from `axum-extra` | ❌ | ✅ | ✅ |
|
|
| extra_form | Enables support for `Form` from `axum-extra` | ❌ | ✅ | ✅ |
|
|
| extra_protobuf | Enables support for `Protobuf` from `axum-extra` | ❌ | ✅ | ✅ |
|
|
| all_extra_types | Enables support for all extractors above from `axum-extra` | ❌ | ✅ | ✅ |
|
|
| all_types | Enables support for all extractors above | ❌ | ✅ | ✅ |
|
|
| 422 | Use `422 Unprocessable Entity` instead of `400 Bad Request` as the status code when validation fails | ❌ | ✅ | ✅ |
|
|
| into_json | Validation errors will be serialized into JSON format and returned as the HTTP body | ❌ | ✅ | ✅ |
|
|
| full | Enables all features | ❌ | ✅ | ✅ |
|
|
|
|
## Compatibility
|
|
|
|
* axum-valid 0.7.x works with axum-extra v0.7.x
|
|
* axum-valid 0.8.x works with axum-extra v0.8.x
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License.
|
|
|
|
## References
|
|
|
|
* [axum](https://crates.io/crates/axum)
|
|
* [validator](https://crates.io/crates/validator)
|
|
* [serde](https://crates.io/crates/serde)
|
|
* [axum-extra](https://crates.io/crates/axum-extra)
|
|
* [axum-yaml](https://crates.io/crates/axum-yaml)
|
|
* [axum-msgpack](https://crates.io/crates/axum-msgpack)
|
|
* [axum_typed_multipart](https://crates.io/crates/axum_typed_multipart) |