FlowValidate 1.0.8

FlowValidate

FlowValidate is a lightweight, fluent validation library for validating request-based models in .NET 8.0.
It offers an intuitive API for model validation, making it easy to enforce rules for your application�s request models. FlowValidate simplifies the process of adding validation logic to your models with an easy-to-use interface, reducing boilerplate code.

Features

• Property Validation: Validate standard properties, nested classes, and collections.
• Custom Validation Methods: Includes pre-built methods like Should, Must, IsNotEmpty, and IsEqual. These methods make property validation easier and allow you to create custom validation logic.
• Dependency Injection (DI) Support: Easily integrate with your application's DI system.
• Detailed Error Messages: Provides detailed validation error messages for easy debugging.
• Lightweight & Fast: Designed for high performance, optimized for .NET 8.0.
• Middleware Support: FlowValidate can be used as middleware to validate models automatically on each request, reducing boilerplate code.

Installation

You can install FlowValidate via NuGet Package Manager

Injection

var builder = WebApplication.CreateBuilder(args);

builder.Services.FlowVal(AssemblyReference.Assembly); 

var app = builder.Build();

app.FlowValApp();

app.Run();

For example, we create a uservalidator

   public class UserValidator : BaseValidator<User>
   {
       public UserValidator()
       {
           RuleFor(user => user.Name)
                .Must(name => !string.IsNullOrEmpty(name)).WithMessage("Name property is null !")
                .Contains("e").WithMessage("Name property value have to contains 'e' .")
                .Length(3, 10).WithMessage("Length doesn't follow the rules")
                .IsEqual("XoarkanX").WithMessage("Name value is not equal qith expected value !")
                .IsEmail().WithMessage("Name is not email")
                .Should(name =>
                {
                    if (!name.Contains("e"))
                        throw new Exception("Name cannot start with 'X'.");

                }, "Custom validation FAILED !").WithMessage("Additional error message if needed.")
               .Should(name => char.IsUpper(name[0]), "Name must start with an uppercase letter");

           ValidateNested(user => user.UserCustomer, new UserCustomersValidator());

           RuleFor(user => user.Age)
               .Length(1, 2).WithMessage("Age range can't be bigger than three step")
               .IsEqual(17).WithMessage("yas 17 olmali");

           ValidateCollection(
               ubas => ubas.UserBaskets,
               new UserBasketsValidator(),
               item => item
           );

           RuleFor(user => user.Age)
               .Should(age =>
               {
                   throw new Exception();
               }, "example error");

           RuleFor(user => user)
               .Must(user =>
               {
                   if (!user.Name.Contains("y"))
                       return false;
                   return true;
               }).WithMessage("user name must be contains 'y' character !")
               .Must(user =>
               {
                   if (user.Name.Length < 5)
                       return false;
                   return true;
               }).WithMessage("user name length at least be than 3");
       }
   }

we can verify as manuel

var user = new User
{
    Name = "XoarkanX", 
    Age = 18,  
    UserCustomer = new()
    {
        Email = "",
        PhoneNumber = "1234f56789"
    },
    UserBaskets = new()
    {
        new UserBasket(){Count = 0,Name = ""},
        new UserBasket(){Count = 52,Name = ""}
    }
};

var validator = new UserValidator();
var result = validator.Validate(user);

output