ValiCraft

KO | EN

gitlite — search

#python #ai #llm #android #machine-learning #rust #deep-learning #linux #awesome-list #pytorch #mcp #ios #openai #open-source

(★ 15)

A powerful, compile-time validation framework for .NET that crafts fast and boilerplate-free validation logic.

ValiCraft 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ValiCraft

[![NuGet](https://img.shields.io/nuget/v/ValiCraft.svg)](https://www.nuget.org/packages/ValiCraft/)
[![NuGet Downloads](https://img.shields.io/nuget/dt/ValiCraft.svg)](https://www.nuget.org/packages/ValiCraft/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A high-performance validation library for .NET that uses source generators to craft fast, allocation-free validation logic at compile time.

## Why ValiCraft?

ValiCraft takes a fundamentally different approach to validation. Instead of interpreting validation rules at runtime, ValiCraft uses C# source generators to analyze your validator definitions at compile time and generate highly optimized, native validation code.

**Key Benefits:**

- **🚀 Extreme Performance** — Validation executes in nanoseconds with zero allocations for valid models
- **📦 Zero Runtime Overhead** — No reflection, no expression tree compilation, no runtime code generation
- **🔧 Compile-Time Safety** — Validation logic is generated and type-checked at build time
- **✨ Clean API** — Fluent builder pattern with IntelliSense support
- **🔌 DI Ready** — Source-generated dependency injection with no reflection

## Quick Start

### 1. Define Your Model

```csharp
public class User
{
    public required string Username { get; set; }
    public string? Email { get; set; }
    public int Age { get; set; }
}
```

### 2. Create a Validator

```csharp
using ValiCraft;
using ValiCraft.Attributes;

[GenerateValidator]
public partial class UserValidator : Validator<User>
{
    protected override void DefineRules(IValidationRuleBuilder<User> builder)
    {
        builder.Ensure(x => x.Username)
            .IsNotNullOrWhiteSpace()
            .HasMinLength(3)
            .HasMaxLength(50);

builder.Ensure(x => x.Email)
            .IsNotNullOrWhiteSpace()
            .IsEmailAddress();

builder.Ensure(x => x.Age)
            .IsGreaterOrEqualThan(0)
            .IsLessThan(150);
    }
}
```

The `[GenerateValidator]` attribute tells the source generator to create the validation implementation. The `partial` keyword is required to allow the generated code to extend your type.

**Optional Configuration:**

The `[GenerateValidator]` attribute supports the following properties:

- `IncludeDefaultMetadata` (default: `false`) — When `true`, includes default metadata (`RequestType` and `ValidationCount`) in the generated `ValidationErrors` object.

```csharp
[GenerateValidator(IncludeDefaultMetadata = true)]
public partial class UserValidator : Validator<User>
{
    // ...
}
```

### 3. Run Validation

```csharp
var validator = new UserValidator();
var user = new User { Username = "john", Email = "john@example.com", Age = 30 };

ValidationErrors? result = validator.Validate(user);

if (result is null)
{
    Console.WriteLine("User is valid!");
}
else
{
    Console.WriteLine($"Validation failed: {result.Message}");
}
```

## Performance

ValiCraft delivers exceptional performance compared to traditional validation libraries. Here's a snapshot (full benchmarks in [docs/performance.md](docs/performance.md)):

### Simple Validation - Valid Model
| Method                | Mean          | Gen0   | Allocated |
|---------------------- |--------------:|-------:|----------:|
| ValiCraft             |    19.1820 ns |      - |         - |
| ValiCraftWithMetaData |    12.7780 ns |      - |         - |
| FluentValidation      |   168.0000 ns | 0.1097 |     688 B |

### Simple Validation - Invalid Model
| Method                | Mean          | Gen0   | Allocated |
|---------------------- |--------------:|-------:|----------:|
| ValiCraft             |    62.7240 ns | 0.0854 |     536 B |
| ValiCraftWithMetaData |    98.6020 ns | 0.1236 |     776 B |
| FluentValidation      | 2,035.4290 ns | 1.0681 |   6,712 B |

> **Note:** ValiCraft validators have near-zero instantiation cost (~3ns, 24B for the class instance) because the source generator produces validation logic that requires no runtime initialization. See [full benchmark results](docs/performance.md) for collection, complex, and instantiation benchmarks.

## Installation

```bash
dotnet add package ValiCraft
```

## Documentation

| Topic | Description |
|-------|-------------|
| [Core Concepts](docs/core-concepts.md) | Defining validators, running validation, and working with results |
| [Built-in Rules](docs/built-in-rules.md) | 50+ built-in rules for strings, numbers, collections, dates, and more |
| [Advanced Features](docs/advanced-features.md) | Error customization, failure modes, conditional validation, collection/nested/polymorphic validation, async, static validators, and custom rules |
| [Dependency Injection](docs/dependency-injection.md) | AOT-friendly DI registration, service lifetimes, and multi-project solutions |
| [Performance](docs/performance.md) | Full benchmark results and comparisons |

## Diagnostics

ValiCraft emits helpful compiler diagnostics when there are issues with your validators:

| Code | Description |
|------|-------------|
| `VALC201` | Missing `partial` keyword on validator class |
| `VALC202` | Missing `Validator<T>` or `AsyncValidator<T>` base class |
| `VALC203` | Invalid rule invocation — use `.Is()` or a valid extension method |
| `VALC204` | Invalid lambda in `EnsureEach` — expects a lambda as the last parameter |
| `VALC205` | Cannot retrieve parameter name from lambda definition |
| `VALC206` | Invalid builder argument used in scope |
| `VALC207` | Missing `[MapToValidationRule]` attribute on extension method |
| `VALC208` | Invalid statement in `DefineRules` — only builder invocations are allowed |
| `VALC301` | Static validator has parameterized constructor |
| `VALC302` | Static validator has instance field |
| `VALC303` | Static validator has instance property |
| `VALC304` | Static validator has instance method |
| `VALC402` | Disallowed `RunValidation` call — `RunValidation` is for internal use by generated code only |

These diagnostics appear directly in your IDE with exact source locations.

## Requirements

- **.NET 8.0** or higher
- **C# 12** or higher

## License

MIT — see [LICENSE](LICENSE) for details.

## Contributing

Contributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

ValiCraft

ValiCraft 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

ValiCraft

ValiCraft 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README