#validation #user-input #error #iterate #url #macro #function

yanked preflight

A macro to pipe user input through multiple validation functions and iterate over the resulting errors

0.1.3 Jan 23, 2021
0.1.2 Jan 23, 2021
0.1.1 Jan 21, 2021
0.1.0 Jan 21, 2021

#39 in #iterate

MIT license

8KB
111 lines

preflight

The validate! macro validates a given input with a given set of validation functions and lets you conveniently iterate over the errors. For example:

#[macro_use] extern crate preflight;
use preflight::validators::{max_len, url_with_scheme};

let mut errors = Vec::new();

validate![profile_url
    => for err in max_len(265), url_with_scheme(&["http", "https"]) {
        errors.push(format!("profile URL {}", err));
    }
];

In the above example the validate! macro expands to:

if let Err(err) = max_len(profile_url, 265) {
    errors.push(format!("profile URL {}", err));
}
if let Err(err) = url_with_scheme(profile_url, &["http", "https"]) {
    errors.push(format!("profile URL {}", err));
}

Notice how the first expression is automatically passed as the first argument to all listed validation functions.

Since needing to validate values inside Options is very common, this crate also provides a validate_opt! macro:

validate_opt![profile_url, ...];

is equivalent to

if let Some(profile_url) = profile_url {
    validate![profile_url, ...];
}

You can easily define your own validation functions, you just need to return a Result and take the input as the first argument.

Dependencies

~0–280KB