SmartValidationsLibrary 2.0.0

Smart Validations Library

SmartValidationsLibrary is a lightweight, non-throwing C# validation library. Every check returns a ValidationResult (IsValid + ErrorMessage) instead of an exception, and every validation also ships as an attribute so you can validate a whole object's properties in one call.

Features

• Email — IsValidEmail / [EmailValidation]
• Phone number, region-aware (USA, UK, Spain, Ireland) — IsValidPhoneNumber / [PhoneNumberValidation(Region.Spain)]
• Postal code, region-aware (USA, UK, Spain, Ireland) — IsValidPostalCode / [PostalCodeValidation(Region.Spain)]
• Date — IsValidDate
• URL (http/https) — IsValidUrl / [UrlValidation]
• Credit card number (Luhn checksum) — IsValidCreditCardNumber / [CreditCardValidation]
• Password strength, configurable — IsValidPassword / [PasswordValidation]
• IP address (IPv4/IPv6) — IsValidIPAddress / [IPAddressValidation]
• Numeric range — IsInRange / [RangeValidation(min, max)]
• String length — IsValidLength / [LengthValidation(min, max)]
• Custom rules — register your own regex via AddCustomValidation, then IsValidCustom / [CustomValidation("name")]
• Entity validation — EntityValidator.ValidateEntity<T> collects every failing property on an object, not just the first one

Installation

dotnet add package SmartValidationsLibrary

Usage

Standalone checks

using SmartValidationsLibrary;

var result = Validator.IsValidEmail("user@example.com");
if (!result.IsValid)
    Console.WriteLine(result.ErrorMessage);

Validator.IsValidPhoneNumber("612345678", Region.Spain);
Validator.IsValidPostalCode("28001", Region.Spain);
Validator.IsValidDate("2026-01-15");
Validator.IsValidUrl("https://example.com");
Validator.IsValidCreditCardNumber("4111 1111 1111 1111");
Validator.IsValidPassword("Str0ng!Pass");
Validator.IsValidIPAddress("192.168.1.1");
Validator.IsInRange(5, 1, 10);
Validator.IsValidLength("hello", 1, 10);

Validator.AddCustomValidation("digits-only", @"^\d+$");
Validator.IsValidCustom("12345", "digits-only");

Entity validation with attributes

using SmartValidationsLibrary;

public class SignupRequest
{
    [EmailValidation]
    public string Email { get; set; } = string.Empty;

    [PhoneNumberValidation(Region.Spain)]
    public string Phone { get; set; } = string.Empty;

    [PasswordValidation(minLength: 8)]
    public string Password { get; set; } = string.Empty;

    [LengthValidation(2, 50)]
    public string DisplayName { get; set; } = string.Empty;
}

var errors = EntityValidator.ValidateEntity(signupRequest);
// errors is empty when everything is valid, otherwise contains
// one ValidationResult per failing property (PropertyName + ErrorMessage).

Requirements

• .NET 10.0 or later

Development

Want to contribute? Great!

git clone https://github.com/AdrianBailador/SmartValidationsLibrary.git
cd SmartValidationsLibrary
dotnet test

Please include tests for any new functionality.

License

MIT — see LICENSE.