Cordon

Cordon is a highly expressive data validation library built for .NET developers. With its fluent syntax and extensible rule engine, it establishes precise "guardrails" for data flows. Whether validating API inputs, form submissions, or cleansing heterogeneous data streams, Cordon enables enterprise-grade validation with minimal code.

Features

• Non-intrusive Integration: No configuration required—integrate directly into existing projects.
• Fluent Validation Syntax: Chainable, declarative APIs that make validation logic clear and readable.
• Comprehensive Coverage: Full validation support for fields, objects, nested structures, and collections.
• Scenario-based Rule Activation: Dynamically compose validation logic based on business requirements.
• Multilingual Support: Built-in internationalization with error messages available in multiple languages.
• Highly Customizable: Define custom validation logic and validation attributes to fit any business rule.
• Dependency Injection Friendly: Register directly into the .NET service container.
• Asynchronous Validation Support: Validation logic can be executed asynchronously; both sync and async scenarios are fully supported.
• Flexible Architecture: Designed for ease of use, extension, and maintainability.
• Cross-platform and Dependency-free: Runs on all major platforms with zero external dependencies.
• High-Quality Code Assurance: Built under strict coding standards, with 98% unit and integration test coverage.
• .NET 8+ Compatibility: Fully compatible with .NET 8 and later versions.

Installation

dotnet add package Cordon

Getting Started

We have many examples on our homepage. Here's your first one to get you started:

public class User : IValidatableObject
{
    [Min(1, ErrorMessage = "{0} must not be less than 1")]
    public int Id { get; set; }

    [Required]
    public string? Name { get; set; }

    public IEnumerable<ValidationResult> Validate(ValidationContext context)
    {
        return context.ContinueWith<User>()
            .RuleFor(u => u.Name).NotBlank().MinLength(3).UserName().WithMessage("{0} is not a valid internet username")
            .RuleFor(u => u.Id).Max(int.MaxValue)
            // Support rule sets (scenarios)
            .RuleSet("rule", v => 
            {
                v.RuleFor(u => u.Name).EmailAddress().WithMessage({0} is not a valid email format");
            }).ToResults();
    }
}

More Documentation

Documentation

You can find the Cordon documentation on our homepage.

Contributing

The main purpose of this repository is to continue developing the core of Cordon, making it faster and easier to use. The development of Cordon is publicly hosted on Gitee, and we appreciate community contributions for bug fixes and improvements.

License

Cordon is released under the MIT open source license.