11 releases (breaking)

new 0.9.0 Jul 5, 2024
0.7.0 May 3, 2024
0.6.0 Feb 29, 2024
0.3.0 Dec 1, 2023
0.2.0 Oct 3, 2023

#19 in #actix

Download history 247/week @ 2024-03-15 364/week @ 2024-03-22 206/week @ 2024-03-29 231/week @ 2024-04-05 352/week @ 2024-04-12 273/week @ 2024-04-19 232/week @ 2024-04-26 470/week @ 2024-05-03 357/week @ 2024-05-10 492/week @ 2024-05-17 353/week @ 2024-05-24 541/week @ 2024-05-31 312/week @ 2024-06-07 327/week @ 2024-06-14 517/week @ 2024-06-21 261/week @ 2024-06-28

1,544 downloads per month
Used in 2 crates

MIT license

72KB
1.5K SLoC

Garde-actix-web   Documentation Latest Version Build Status

Actix-web wrapper for garde, a Rust validation library.

Installation

[dependencies]
garde = "0.20"
garde-actix-web = "0.9"

Usage example

Simply use garde-actix-web exposed types as a drop in for actix types.

Your types must implement Validate from garde. Validation happens during actix's FromRequest invocation.

If payload is invalid, a 400 error is returned (404 for Path).

Custom error handling can be implemented with an extractor config (garde_actix_web::web::QueryConfig in place of actix_web::web::QueryConfig for example).

use actix_web::HttpResponse;
// instead of actix_web::web::Path
use garde_actix_web::web::Path;
use garde::Validate;

#[derive(Validate)]
struct MyStruct<'a> {
  #[garde(ascii, length(min = 3, max = 25))]
  username: &'a str,
}

fn test(id: Path<MyStruct>) -> HttpResponse {
  todo!()
}

Context needs to be provided through actix's data or app_data, if not found default will be used instead.

Feature flags

name description extra dependencies
serde_qs Enables the usage of garde for serde_qs::actix::QsQuery<T> serde_qs

Compatibility matrix

garde version serde_qs version garde-actix-web-version
0.14 0.12 0.1.x
0.15 0.12 0.2.x
0.16 0.12 0.3.x
0.17 0.12 0.4.x
0.18 0.12 0.5.x, 0.6.x
0.18 0.13 0.7.x
0.19 0.13 0.8.x
0.20 0.13 0.9.x

About us

Garde-actix-web is provided by Netwo.

We use this crate for our internal needs and therefore are committed to its maintenance, however we cannot provide any additional guaranty. Use it at your own risks.

While we won't invest in any feature we don't need, we are open to accept any pull request you might propose.

We are a France based full-remote company operating in the telecom sector. If you are interested in learning more, feel free to visit our career page.

Dependencies

~15–27MB
~478K SLoC