Test Validators
Problem
You want readable, stack-agnostic assertions for valid and invalid models without depending on a specific test framework.
Solution
<PackageReference Include="Jeninnet.Validation.Assertions" Version="1.0.0-preview.2" />
using Jeninnet.Validation.Assertions;
[TestClass]
public sealed class CustomerValidatorTests
{
[TestMethod]
public void Valid_model_has_no_errors()
{
var result = new CustomerValidator().Validate(new Customer
{
Name = "Ada",
Email = "ada@example.com",
Age = 30
});
result.ShouldNotHaveValidationErrors();
}
[TestMethod]
public void Invalid_model_reports_each_member()
{
var result = new CustomerValidator().Validate(new Customer
{
Name = "",
Email = "not-an-email",
Age = 12
});
result.ShouldHaveValidationErrors()
.WithErrorCount(4)
.ForMember(nameof(Customer.Name))
.ContainsRule(ValidationMessageKeys.NOT_EMPTY);
result.ShouldHaveValidationErrors()
.ForMember(nameof(Customer.Email))
.ContainsRule(ValidationMessageKeys.EMAIL);
}
}
The example uses MSTest as the host; the assertions package itself is framework-agnostic. Replace the attributes with your test frameworkâs equivalents.
TestValidate
var test = new CustomerValidator().TestValidate(model);
test.ShouldHaveValidationErrorFor(nameof(Customer.Email))
.ContainsRule(ValidationMessageKeys.EMAIL);
test.ShouldNotHaveValidationErrorFor(nameof(Customer.Age));
For async validators:
var test = await validator.TestValidateAsync(model, cancellationToken);
test.ShouldNotHaveValidationErrors();
Test generated and fluent parity
var fluent = new CustomerValidator().Validate(model);
var generated = new GeneratedCustomerValidator().Validate(model);
var fluentMembers = fluent.Errors.Select(error => error.MemberName);
var generatedMembers = generated.Errors.Select(error => error.MemberName);
if (!fluentMembers.SequenceEqual(generatedMembers))
{
throw new InvalidOperationException("Fluent and generated validators disagree.");
}
Verify
Run the test suite:
dotnet test tests/Jeninnet.Validation.Tests/Jeninnet.Validation.Tests.csproj