Universal Data Validator (Rust)
A comprehensive data validation library for Rust that works across API, database, and form contexts.
Features
- ✅ Rich Validator Types: String, Int, Email, URL
- ✅ Schema-Based Validation: Define complex data structures
- ✅ Custom Validators: Add your own validation logic
- ✅ Clear Error Messages: Detailed error reporting with field paths
- ✅ Minimal Dependencies: Only regex for pattern matching
- ✅ Production Ready: Comprehensive test coverage
Installation
Add this to your Cargo.toml:
[]
= "1.0"
Quick Start
use ;
use HashMap;
Usage Examples
String Validation
use validators;
// Basic string
let validator = string;
// String with length constraints
let username_validator = string.min.max;
// String with pattern
let phone_validator = string.pattern;
// String with choices
let theme_validator = string.choices;
// Optional string
let bio_validator = string.optional;
Integer Validation
// Integer with range
let age_validator = int.min.max;
// Optional integer
let score_validator = int.optional;
Email and URL Validation
let email_validator = email;
let url_validator = url;
Schema Validation
use ;
use HashMap;
let schema = new
.field
.field
.field
.field
.field;
let mut data = new;
data.insert;
data.insert;
data.insert;
let result = schema.validate;
if result.is_valid else
Real-World Examples
User Registration
use ;
let registration_schema = new
.field
.field
.field
.field;
API Request Validation
let api_request_schema = new
.field
.field
.field;
Error Handling
use ;
use HashMap;
let schema = new
.field;
let mut data = new;
data.insert;
let result = schema.validate;
if !result.is_valid
API Reference
Validators
-
validators::string()- String validator.min(n)- Minimum length.max(n)- Maximum length.pattern(regex)- Regex pattern.choices(vec)- Allowed values.optional()- Make field optional
-
validators::int()- Integer validator.min(n)- Minimum value.max(n)- Maximum value.optional()- Make field optional
-
validators::email()- Email validator.optional()- Make field optional
-
validators::url()- URL validator.optional()- Make field optional
Schema
Schema::new()- Create a new schema.field(name, validator)- Add a field validator.validate(data)- Validate data and return ValidationResult
ValidationResult
.is_valid()- Check if validation passed.errors()- Get list of validation errors
ValidationError
.field- Field name that failed validation.message- Error message.value- Optional value that failed validation
Testing
# Run tests
# Run tests with output
# Run tests with coverage
License
MIT License
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
Changelog
1.0.0 (2024-01-15)
- Initial release
- Support for string, int, email, URL validators
- Schema-based validation
- Comprehensive test coverage