Merge pull request #5 from Liero/feature/v1

Feature/v1

Author: Liero

.github/workflows/ci-main.yml

@@ -7,7 +7,7 @@ on:
     types: [ published ]
 
 env:
-    NETCORE_VERSION: '5.0.x'
+    NETCORE_VERSION: '6.0.x'
     DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
     DOTNET_CLI_TELEMETRY_OPTOUT: true
     PROJECT_NAME: FluentValidation

.github/workflows/ci-pr.yml

@@ -6,7 +6,7 @@ on:
 
 env:
     PROJECT_NAME: vNext.BlazorComponents.FluentValidation
-    NETCORE_VERSION: '5.0.x'
+    NETCORE_VERSION: '6.0.x'
 
 jobs:
   build:

Demo/Demo.csproj

@@ -1,10 +1,11 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>net5.0</TargetFramework>
+    <TargetFramework>net6.0</TargetFramework>
   </PropertyGroup>
-
+	
   <ItemGroup>
+	  
     <ProjectReference Include="..\WebAssemblyDemo\WebAssemblyDemo.csproj" />
   </ItemGroup>
 

Demo/Program.cs

@@ -1,26 +1,32 @@
+using Microsoft.AspNetCore.Builder;
 using Microsoft.AspNetCore.Hosting;
-using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
 using Microsoft.Extensions.Hosting;
-using Microsoft.Extensions.Logging;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
 
-namespace Demo
+
+var builder = WebApplication.CreateBuilder(args);
+
+// Add services to the container.
+builder.Services.AddRazorPages();
+builder.Services.AddServerSideBlazor();
+var app = builder.Build();
+
+// Configure the HTTP request pipeline.
+if (!app.Environment.IsDevelopment())
 {
-    public class Program
-    {
-        public static void Main(string[] args)
-        {
-            CreateHostBuilder(args).Build().Run();
-        }
-
-        public static IHostBuilder CreateHostBuilder(string[] args) =>
-            Host.CreateDefaultBuilder(args)
-                .ConfigureWebHostDefaults(webBuilder =>
-                {
-                    webBuilder.UseStartup<Startup>();
-                });
-    }
+    app.UseExceptionHandler("/Error");
+    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
+    app.UseHsts();
 }
+
+app.UseHttpsRedirection();
+
+app.UseStaticFiles();
+
+app.UseRouting();
+app.MapRazorPages();
+app.MapControllers();
+app.MapBlazorHub();
+app.MapFallbackToPage("/_Host");
+
+app.Run();

Demo/Startup.cs

@@ -1,5 +1,5 @@
 # FluentValidation
-A library for using FluentValidation with Blazor
+A library for using FluentValidation with Blazor that supports async validation, severity levels and more.
 
 ![Build & Test Main](https://github.com/Liero/vNext.BlazorComponents.FluentValidation/workflows/Build%20&%20Test%20Main/badge.svg)
 
@@ -61,32 +61,29 @@ You can then use it as follows within a `EditForm` component.
 ```
 
 ## Discovering Validators
-By default, the component will check for validators registered with DI first. If it can't find any, it will then try scanning the applications assemblies to find validators using reflection.
+The component locates validators using `IValidatorFactory` optional service.
+The `DefaultValidatorFactory` implementation check for validators registered with DI first.
 
-You can control this behaviour using the `DisableAssemblyScanning` parameter. If you only wish the component to get validators from DI, set the value to `true` and assembly scanning will be skipped.
-
-```razor
-<FluentValidationValidator DisableAssemblyScanning="@true" />
-```
-**Note:** When scanning assemblies the component will swallow any exceptions thrown by that process. This is to stop exceptions thrown by scanning third party dependencies crashing your app.
+If it finds multiple validators, validators withing the same assembly and namespace are takes precedence. 
+If it can't find any, it will then try scanning the applications assemblies
 
+You can override default behaviour on by registering `IValidatorFactory` service:
 
-For advanced scenarios, you can customize how the validators are discovered
+```csharp
+   services.AddSingleton<IValidatorFactory>(new DefaultValidatorFactory { DisableAssemblyScanning = false })
+`
 
+or per FluentValidationValidator component
 ```razor
-<FluentValidationValidator ValidatorFactory="CreateValidator" />
-```
-```csharp
-IValidator CreateValidator(ValidatorFactoryContext ctx)
-{
-    if (ctx.Model == Person.Address)
-    {
-        return new AddressValidator();
-    }
-    return (IValidator)ctx.ServiceProvider.GetService(ctx.ValidatorType);
-}
+  <FluentValidationValidator ValidatorFactory="customValidatorFactory" />
+
+  @code {
+      IValidatorFactory customValidatorFactory = new MyCustomValidatorFactory();
+  }
 ```
 
+ See [DefaultValidatorFactory.cs](vNext.BlazorComponents.FluentValidation\DefaultValidatorFactory.cs) for more info.
+
 ## Validating Complex Models
 
 ```csharp

README.md

@@ -1,8 +1,6 @@
-using FluentValidation;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
+#nullable disable
+
+using FluentValidation;
 
 namespace WebAssemblyDemo.Models
 {

WebAssemblyDemo/Models/Address.cs

@@ -1,8 +1,6 @@
-using FluentValidation;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
+#nullable disable
+
+using FluentValidation;
 
 namespace WebAssemblyDemo.Models
 {

WebAssemblyDemo/Models/EmailModel.cs

@@ -1,15 +1,11 @@
 using FluentValidation;
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Threading.Tasks;
 
 namespace WebAssemblyDemo.Models
 {
     public class Person
     {
-        public string FirstName { get; set; }
-        public string LastName { get; set; }
+        public string? FirstName { get; set; }
+        public string? LastName { get; set; }
         public int? Age { get; set; }
         public Address Address { get; set; } = new Address();
     }

WebAssemblyDemo/Models/Person.cs

@@ -6,18 +6,25 @@
 <hr class="mb-5" />
 
 <EditForm Model="@Model" OnSubmit="@SubmitForm">
-    <FluentValidationValidator />
+    <FluentValidationValidator @ref="_validator" />
     <ValidationSummary />
 
-    <div class="form-group">
-        <label>EmailAddress: </label>
+    <div class="mb-3">
+        <labe class="form-label">EmailAddress: </labe>
         <InputText @bind-Value="@Model.EmailAddress" class="form-control w-auto" />
         <ValidationMessage For="@(() => Model.EmailAddress )" />
     </div>
 
     @if (!ValidationRunning)
     {
-        <button class="btn btn-primary" type="submit">Save</button>
+        <div class="d-flex gap-3">
+            <button class="btn btn-primary" type="submit">Save</button>
+
+            @if (context.GetValidationMessages().Any())
+            {
+                <button class="btn btn-secondary" type="button" @onclick="Clear">Clear Errors</button>
+            }
+        </div>
     }
     else
     {
@@ -30,15 +37,19 @@
 <br />
 
 @code {
-    [Inject] IJSRuntime JS { get; set; }
+    FluentValidationValidator? _validator;
+
+    [Inject] IJSRuntime JS { get; set; } = default!;
 
     EmailModel Model { get; set; } = new EmailModel();
 
     bool ValidationRunning { get; set; }
 
+
     async Task SubmitForm(EditContext editContext)
     {
         ValidationRunning = true;
+        StateHasChanged();
         try
         {
             await editContext.ValidateAsync();
@@ -54,5 +65,10 @@
         }
     }
 
+    void Clear()
+    {
+        _validator?.ClearMessages();
+    }
+
 
 }