serdev 0.3.0

SerdeV - Serde with Validation
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

<div align="center">
    <h1>SerdeV</h1>
    SerdeV - Serde with Validation
</div>

<br>

- Just a wrapper of [Serde](https://github.com/serde-rs/serde) and 100% compatible,
- implementing `serde::{Serialize, Deserialize}` for your structs,
- with providing `#[serde(validate = "...")]` for declarative validation in `#[derive(Deserialize)]`.

<div align="right">
    <a href="https://github.com/ohkami-rs/serdev/blob/main/LICENSE" target="_blank">
        <img alt="License" src="https://img.shields.io/crates/l/ohkami.svg" />
    </a>
    <a href="https://github.com/ohkami-rs/serdev/actions" target="_blank">
        <img alt="CI status" src="https://github.com/ohkami-rs/serdev/actions/workflows/CI.yml/badge.svg"/>
    </a>
    <a href="https://crates.io/crates/serdev" target="_blank">
        <img alt="crates.io" src="https://img.shields.io/crates/v/serdev" />
    </a>
</div>

## Example ([closure.rs](https://github.com/ohkami-rs/serdev/blob/main/examples/examples/closure.rs))

```toml
[dependencies]
serdev     = "0.3"
serde_json = "1.0"
```

```rust
use serdev::{Serialize, Deserialize};

#[derive(Serialize, Deserialize, Debug)]
#[serde(validate = "|p| (p.x * p.y <= 100)
    .then_some(())
    .ok_or(\"x * y must not exceed 100\")")]
struct Point {
    x: i32,
    y: i32,
}

fn main() {
    let point = serde_json::from_str::<Point>(r#"
        { "x" : 1, "y" : 2 }
    "#).unwrap();

    // Prints point = Point { x: 1, y: 2 }
    println!("point = {point:?}");

    let error = serde_json::from_str::<Point>(r#"
        { "x" : 10, "y" : 20 }
    "#).unwrap_err();

    // Prints error = x * y must not exceed 100
    println!("error = {error}");
}
```

Of course, you can use it in combination with some validation tools like [validator](https://crates.io/crates/validator)!
( working example: [validator.rs](https://github.com/ohkami-rs/serdev/blob/main/examples/examples/validator.rs) )

## Attribute

- `#[serde(validate = "function")]`

  Automatically validate the deserialized struct by the `function`. The `function` must be an *expression* that is
  callable as type `fn(&self) -> Result<(), impl Display>` (of course the error type must be known at compile time).
  
  (*expression*: an inlined closure as above, or name/path to a `fn` or a method, or even a block expression or function calling
  or anything that are finally evaluated as `fn(&self) -> Result<(), impl Display>`)
  
  Errors are internally converted to a `String` and passed to `serde::de::Error::custom`.

- `#[serde(validate(by = "function", error = "Type"))]`

  Using given `Type` for the validation error, without conversion.
  The `function` signature must be `fn(&self) -> Result<(), Type>`.
  
  This will be preferred in **no-std** use, or, maybe when you need better performance in error cases.

Both `"function"` and `"Type"` above accept path like `"crate::util::validate"`.

Additionally, `#[serdev(crate = "path::to::serdev")]` is supported for reexport from another crate.

## License

Licensed under MIT LICENSE ( [LICENSE](https://github.com/ohkami-rs/serdev/blob/main/LICENSE) or [https://opensource.org/licenses/MIT](https://opensource.org/licenses/MIT) ).