validex 0.1.1

Input validating library.
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

[![Crates.io](https://img.shields.io/crates/v/validex.svg)](https://crates.io/crates/validex)
[![Documentation](https://docs.rs/validex/badge.svg)](https://docs.rs/validex)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

# validex


A Rust validation library.

Unlike [validator](https://github.com/Keats/validator) library, which use syntex or string.

[validex](https://github.com/nurmohammed840/validex) use concrete rust values in `#[check(...)]` attribute.
Any types that implement [`Check`](https://docs.rs/validex/latest/validex/trait.Check.html) trait can be used in `#[check(...)]`.

This enables IDE-friendly features like: auto-import/fix, goto-def, syntax highlight, hover docs, etc...

## Features


- `Check` derive macros for validating structs.
- Zore-cost abstractions: [`All`](https://docs.rs/validex/latest/validex/struct.All.html), [`Any`](https://docs.rs/validex/latest/validex/struct.Any.html) and [`Not`](https://docs.rs/validex/latest/validex/struct.Not.html) combinators.
- Flexible and Extensible: use functions or any type that implements `Check` trait.
- Detailed error reporting: preserves all relevant information.
- IDE friendly: Works well with Rust Analyzer.

## Example


Add `validex` to your `Cargo.toml`:

```toml
[dependencies]
validex = "0.1"
```

Here is an simple example:

```rust
use validex::*;

fn validate_url(_: &impl AsRef<str>) -> Result<(), String> {
    Ok(())
}

fn validate_user_id(id: &u32) -> Result<(), &'static str> {
    if *id == 13 {
        return Err("13 is an unlucky number");
    }
    Ok(())
}

#[derive(Check)]

struct UserData {
    #[check(
        Any((
            Range(20..=30),
            All((Not(45), Range(40..=50))),
            100,
        )),
        validate_user_id
    )]
    id: u32,
    #[check(Maybe((
        Not("example.com"),
        Length(..=20),
        validate_url,
    )))]
    site: Option<String>,
    #[check(Range(13..=28), Not(Range(18..=24)))]
    age: u32,
}

#[derive(Check)]

struct User {
    #[check(UserData::check)]
    data: UserData,
}

fn main() {
    let user = User {
        data: UserData {
            id: 45,
            site: Some("personal-blog.net".into()),
            age: 25,
        },
    };
    if let Err(err) = user.check() {
        println!("{:}", err);
    }
}
```