Merge pull request #55 from kolan72/dev

Update main before release.

Author: kolan72

README.md

@@ -18,7 +18,7 @@ ExpressValidator is a library that provides the ability to validate objects usin
 - Supports adding a property or field for validation.
 - Verifies that a property expression is a property and a field expression is a field, and throws `ArgumentException` if it is not.
 - Supports adding a `Func` that provides a value for validation.
-- Provides quick validation (refers to ease of use).
+- Provides quick and easy validation using the `QuickValidator`.
 - Supports asynchronous validation.
 - Targets .NET Standard 2.0+
 
@@ -159,6 +159,7 @@ var result = QuickValidator.Validate(
 		.ChildRules((v) => v.RuleFor(o => o.PercentValue1).InclusiveBetween(0, 100)),
 	nameof(obj));
 ```
+The `QuickValidator` also provides a `ValidateAsync` method for asynchronous validation.
 
 ## 🧩 Nuances Of Using The Library
 

src/ExpressValidator/QuickValidation/QuickValidator.cs

@@ -2,6 +2,8 @@
 using FluentValidation;
 using FluentValidation.Results;
 using System;
+using System.Threading;
+using System.Threading.Tasks;
 
 namespace ExpressValidator.QuickValidation
 {
@@ -52,6 +54,48 @@ private static ValidationResult ValidateInner<T>(T obj, Action<IRuleBuilderOptio
 					.BuildAndValidate(Unit.Default);
 		}
 
+		/// <summary>
+		/// Asynchronously validates the given object instance using <paramref name="action"/>.
+		/// </summary>
+		/// <typeparam name="T">The type of the object to validate.</typeparam>
+		/// <param name="obj">The object to validate.</param>
+		/// <param name="action">Action to add validators.</param>
+		/// <param name="propName">The name of the property if the validation fails.
+		/// If <see langword="null"/>, "Input" will be used.</param>
+		/// <param name="onSuccessValidation">Specifies a method to execute when validation succeeds.</param>
+		/// <param name="token">>A cancellation token to cancel validation.</param>
+		/// <returns></returns>
+		public static Task<ValidationResult> ValidateAsync<T>(T obj, Action<IRuleBuilderOptions<T, T>> action, string propName, Action<T> onSuccessValidation = null, CancellationToken token = default)
+		{
+			return ValidateInnerAsync(obj, action, propName ?? FALLBACK_PROP_NAME, onSuccessValidation, token);
+		}
+
+		/// <summary>
+		/// Asynchronously validates the given object instance using <paramref name="action"/>.
+		/// </summary>
+		/// <typeparam name="T">The type of the object to validate.</typeparam>
+		/// <param name="obj">The object to validate.</param>
+		/// <param name="action">Action to add validators.</param>
+		/// <param name="mode"><see cref="PropertyNameMode"/>.
+		/// If <see cref="PropertyNameMode.Default"/>, "Input" will be used.</param>
+		/// <param name="onSuccessValidation">Specifies a method to execute when validation succeeds.</param>
+		/// <param name="token">>A cancellation token to cancel validation.</param>
+		/// <returns></returns>
+		public static Task<ValidationResult> ValidateAsync<T>(T obj, Action<IRuleBuilderOptions<T, T>> action, PropertyNameMode mode = PropertyNameMode.Default, Action<T> onSuccessValidation = null, CancellationToken token = default)
+		{
+			return ValidateInnerAsync(obj, action, GetPropName<T>(mode), onSuccessValidation, token);
+		}
+
+		private static Task<ValidationResult> ValidateInnerAsync<T>(T obj, Action<IRuleBuilderOptions<T, T>> action, string propName, Action<T> onSuccessValidation = null, CancellationToken token = default)
+		{
+			var eb = new ExpressValidatorBuilder<Unit>();
+			return eb.AddFunc((_) => obj,
+								propName,
+								onSuccessValidation)
+					.WithAsyncValidation(action)
+					.BuildAndValidateAsync(Unit.Default, token);
+		}
+
 		private static string GetPropName<T>(PropertyNameMode mode) => mode == PropertyNameMode.Default ? FALLBACK_PROP_NAME : typeof(T).Name;
 	}
 }

src/ExpressValidator/docs/NuGet.md

@@ -8,7 +8,7 @@ ExpressValidator is a library that provides the ability to validate objects usin
 - Supports adding a property or field for validation.
 - Verifies that a property expression is a property and a field expression is a field, and throws `ArgumentException` if it is not.
 - Supports adding a `Func` that provides a value for validation.
-- Provides quick validation (refers to ease of use).
+- Provides quick and easy validation using the `QuickValidator`.
 - Supports asynchronous validation.
 - Targets .NET Standard 2.0+
 
@@ -144,6 +144,7 @@ var result = QuickValidator.Validate(
 		.ChildRules((v) => v.RuleFor(o => o.PercentValue1).InclusiveBetween(0, 100)),
 	nameof(obj));
 ```
+The `QuickValidator` also provides a `ValidateAsync` method for asynchronous validation.
 
 ## Nuances Of Using The Library