FluentAnnotationsValidator 2.0.0-preview1

FluentAnnotationsValidator

A fluent, type-safe validation engine for .NET that transforms [ValidationAttribute] annotations into runtime validation logic. Designed for ergonomic configuration, conditional logic, and culture-aware localization.

🌟 What's New in v2.0.0-preview1

FluentAnnotationsValidator v2.0.0-preview1 is a fresh rewrite. All legacy APIs from v1.x have been removed.

• Multi-attribute validation per property
• DSL-based configuration via ValidationConfigurator
• Conditional rules with .When(...), .Localized(...), .UseFallbackMessage(...)
• Convention-based registration from scanned assemblies
• Pluggable IValidationMessageResolver
• Scoped culture + resource binding per type
• Legacy support removed — clean slate architecture

To use the legacy version, pin to v1.2.2.

Quickstart

Basic Setup

Using AddFluentAnnotations():

using FluentAnnotationsValidator.Extensions;

services.AddFluentAnnotations();

Advanced Setup

Using either:

1. AddFluentAnnotationsValidators(...):

services.AddFluentAnnotationsValidators(typeof(LoginDto))
    .UseFluentAnnotations()
    .For<LoginDto>()
        .WithCulture(CultureInfo.GetCultureInfo("fr-FR"))
        .WithValidationResource<ValidationMessages>()
    .Build();

2. AddFluentAnnotations(...) with common behavior options configuration:

services.AddFluentAnnotations(
    configureBehavior: options =>
    {
        // common culture and resource type for all validation attributes
        options.CommonCulture = CultureInfo.GetCultureInfo("fr-FR");
        options.CommonResourceType = typeof(ValidationMessages);
    }
);

3. AddFluentAnnotations(...) with scoped and common culture and resource types:

services.AddFluentAnnotations(
    builder =>
        // Conditional Localization rule for German 
        // culture and resource type scoped to LoginDto
        builder.For<LoginDto>()
            .When(x => x.LangCode == 'DE')
            .WithCulture(CultureInfo.GetCultureInfo("de-DE"))
            .WithValidationResource<AuthenticationMessages>()
        .Build(),
    configureBehavior: options =>
    {
        // common French culture and resource type for all validation rules
        options.CommonCulture = CultureInfo.GetCultureInfo("fr-FR");
        options.CommonResourceType = typeof(ValidationMessages);
    }
);

Installation

dotnet add package FluentAnnotationsValidator --version 2.0.0-preview1

Key Concepts

Test Coverage

• ✅ [Required], [EmailAddress], [MinLength], [Range], [StringLength]
• ✅ .resx and static resource support
• ✅ Record constructor annotations
• ✅ Upfront rule hydration + conditional overrides

Learn More

• GitHub Repository
• Documentation

Contribute

Help shape validation ergonomics for developers worldwide. Open to extensions, diagnostics, and new DSL patterns — bring your ideas!