推荐使用:validator - Rust结构体验证库
validatorSimple validation for Rust structs项目地址:https://gitcode.com/gh_mirrors/vali/validator
项目介绍
validator
是一个基于Rust的宏(Macros 1.1 custom derive)库,旨在简化结构体的验证过程。受Python的marshmallow和Django的Django validators启发,validator
提供了一系列内置的验证器和自定义验证功能,使得结构体字段的验证变得简单而直观。
项目技术分析
validator
库的核心优势在于其简洁的API和强大的验证功能。通过自定义宏,开发者可以轻松地为结构体字段添加验证规则,如电子邮件、URL、长度、范围等。此外,validator
还支持嵌套结构体的验证,以及自定义验证函数,极大地增强了其灵活性和可扩展性。
项目及技术应用场景
validator
适用于任何需要对结构体进行复杂验证的Rust项目。特别适合以下场景:
- Web开发:在处理用户输入时,确保数据的有效性和完整性。
- API服务:在接收和处理外部数据时,进行严格的验证以防止错误数据进入系统。
- 数据处理:在数据清洗和转换过程中,确保数据的正确性。
项目特点
- 简洁的API:通过自定义宏,可以轻松地为结构体字段添加验证规则。
- 内置验证器:提供了一系列常用的验证器,如电子邮件、URL、长度、范围等。
- 自定义验证:支持自定义验证函数,满足更复杂的验证需求。
- 嵌套验证:支持嵌套结构体的验证,使得复杂数据结构的验证变得简单。
- 错误处理:验证错误以结构化的方式返回,便于错误处理和反馈。
安装与使用
安装 validator
库非常简单,只需在 Cargo.toml
文件中添加以下依赖:
[dependencies]
validator = { version = "0.18", features = ["derive"] }
以下是一个简单的使用示例:
use serde::Deserialize;
use validator::{Validate, ValidationError};
#[derive(Debug, Validate, Deserialize)]
struct SignupData {
#[validate(email)]
mail: String,
#[validate(url)]
site: String,
#[validate(length(min = 1), custom(function = "validate_unique_username"))]
#[serde(rename = "firstName")]
first_name: String,
#[validate(range(min = 18, max = 20))]
age: u32,
#[validate(range(exclusive_min = 0.0, max = 100.0))]
height: f32,
}
fn validate_unique_username(username: &str) -> Result<(), ValidationError> {
if username == "xXxShad0wxXx" {
return Err(ValidationError::new("terrible_username"));
}
Ok(())
}
let signup_data = SignupData {
mail: "test@example.com".to_string(),
site: "http://example.com".to_string(),
first_name: "John".to_string(),
age: 19,
height: 175.5,
};
match signup_data.validate() {
Ok(_) => println!("Validation passed!"),
Err(e) => println!("Validation failed: {:?}", e),
}
通过以上示例,可以看到 validator
库的强大功能和简洁的API设计。无论是简单的字段验证还是复杂的嵌套结构体验证,validator
都能提供优雅的解决方案。
结论
validator
是一个功能强大且易于使用的Rust结构体验证库。无论你是Web开发者、API服务提供者还是数据处理专家,validator
都能帮助你轻松实现数据验证,确保系统的稳定性和数据的有效性。强烈推荐在Rust项目中使用 validator
库,体验其带来的便捷和高效。
validatorSimple validation for Rust structs项目地址:https://gitcode.com/gh_mirrors/vali/validator