Skip to content

Latest commit

 

History

History
70 lines (36 loc) · 3.63 KB

README.md

File metadata and controls

70 lines (36 loc) · 3.63 KB

Monkey validator => a Linq approach to validation

This library aims at making validation easy, fluent and versatile.

Types of Validation

On The Fly

Use this type of validation anywhere in your code. Just called the GetValidator() on any object and start chaining your validation.

on the fly

Reusable

Create an ad-hoc validator class inheriting from CustomMonkeyValidatorBase<T> and build your validator in the abstract SetupValidator() method.

Reusable

validators can be chained, and the validation will pickup all errors before throwing.

MultiChaining

Conditional Validation

You can use an if/else if/else logic for more complex scenarios

ConditionalValidationExample

Fail Fast

If you want to break the validation if a certain condition is met, you can use the FailFastIf() extension, which will throw immediatelly if the predicate returns false.

failfast

Custom On Fail

If you want to insert your own logic on validation failure, you can use the overload that takes an Action<List<string>> where List<string> are the validation errors.

155908647-ed83b6f7-e41c-4529-9191-fca65e934f8c

You can set the optional throwMonkeyException flag to true if you just want to add some logic before the default exception is thrown.

CustomResult

Custom Rules

For on the fly, one time only custom rules, you can simply chain a CustomRule() and pass in your predicate.

155909572-eb2a1cf9-5a9b-4c10-8dd0-9e8c1aef49f3

For rules you want to reuse, but are not specific enough to put on a Validator class, I'd recommend creating a static class to extend the MonkeyValidator<T> with your rule fragments:

155909683-61bad9ca-f50e-49dc-b4f8-92f702faef94

which you can then chain to your other validators.

CustomResult

Injectable Validation

Sometimes, validation can hinder testability. A complex validator can become rather troublesome for testers, especially for testing edge cases where the validation has little to no bearing to the section of code being tested.

We can circumvent the issue by creating an injectable service like so:

injectable validation

This has the added advantage that if we need to inject other services that are required to fulfil our validation, those are encapsulated in the IStringValidator, and thus not required when unit testing. The IStringValidator can then be reused to add all the validation methods related to strings.

Foreach Logic

Foreach