Aquila.Validater 1.0.5

Aquila.Validater

🚀 A lightweight, fluent, enterprise-ready validation library for .NET 9 (MAUI Android & Windows compatible).

Aquila.Validater is a powerful and extensible validation engine built for modern .NET applications including:

• .NET 9
• .NET MAUI (Android & Windows)
• Web APIs
• Desktop Applications
• ERP Systems
• Business Applications

It provides clean, readable, and fluent validation with zero external dependencies.

✨ Features

🔹 Basic Validation

• Required
• Min Length
• Max Length

🔹 String Rules

• Alphanumeric
• Numbers Only
• Letters Only
• No Special Characters

🔹 Format Validation

• Email
• Mobile
• Strong Password
• URL

🔹 India-Specific Validation

• Aadhaar
• GST Number
• IFSC Code
• UPI ID
• PIN Code
• Vehicle Number

🔹 Numeric Validation

• Positive Number
• Negative Number
• Percentage (0–100)
• Decimal Precision
• Currency Format

🔹 Date Validation

• Past Date Only
• Future Date Only
• Minimum Age (e.g., 18+)
• Date Within X Days
• Between Two Dates

📦 Installation

NuGet Package Manager

Install-Package Aquila.Validater

.NET CLI

dotnet add package Aquila.Validater

🚀 Quick Start

using Aquila.Validater;

var result = AquilaV.Validate(email)
    .Required("Email is required")
    .Email("Invalid email format")
    .Result();

if (!result.IsValid)
{
    Console.WriteLine(result.ErrorMessage);
}

🔗 Fluent Chaining Examples

Email Validation

var result = AquilaV.Validate("test@example.com")
    .Required()
    .Email()
    .Result();

Strong Password Validation

var result = AquilaV.Validate("Admin@123")
    .Required()
    .MinLength(8)
    .StrongPassword()
    .Result();

Alphanumeric Username

var result = AquilaV.Validate("User123")
    .Alphanumeric()
    .Result();

Numbers Only

var result = AquilaV.Validate("123456")
    .NumbersOnly()
    .Result();

Letters Only

var result = AquilaV.Validate("Aquila")
    .LettersOnly()
    .Result();

No Special Characters

var result = AquilaV.Validate("Aquila Software 2026")
    .NoSpecialCharacters()
    .Result();

🇮🇳 India Validation Examples

GST Number

var result = AquilaV.Validate("29ABCDE1234F1Z5")
    .GST()
    .Result();

Aadhaar

var result = AquilaV.Validate("123412341234")
    .Aadhaar()
    .Result();

IFSC Code

var result = AquilaV.Validate("HDFC0001234")
    .IFSC()
    .Result();

UPI ID

var result = AquilaV.Validate("name@upi")
    .UPI()
    .Result();

PIN Code

var result = AquilaV.Validate("600001")
    .PinCode()
    .Result();

Vehicle Number

var result = AquilaV.Validate("TN01AB1234")
    .VehicleNumber()
    .Result();

🔢 Numeric Examples

Positive Number

var result = AquilaV.Validate("100")
    .Positive()
    .Result();

Negative Number

var result = AquilaV.Validate("-50")
    .Negative()
    .Result();

Percentage (0–100)

var result = AquilaV.Validate("85")
    .Percentage()
    .Result();

Decimal Precision (2 Places)

var result = AquilaV.Validate("12.34")
    .DecimalPrecision(2)
    .Result();

Currency Validation

var result = AquilaV.Validate("₹1,000.00")
    .Currency()
    .Result();

📅 Date Validation Examples

Past Date Only

var result = AquilaV.ValidateDatePast(selectedDate);

Future Date Only

bool isFuture = DateRules.IsFutureDate(selectedDate);

Age Validation (18+)

bool isAdult = DateRules.IsMinimumAge(dateOfBirth, 18);

Date Within Last 30 Days

bool valid = DateRules.IsWithinDays(selectedDate, 30);

Between Two Dates

bool valid = DateRules.IsBetween(date, startDate, endDate);

🧩 Example in .NET MAUI ViewModel

var result = AquilaV.Validate(Email)
    .Required("Email required")
    .Email()
    .Result();

EmailError = result.IsValid ? "" : result.ErrorMessage;

📘 ValidationResult

if (!result.IsValid)
{
    Console.WriteLine(result.ErrorMessage);
}

Properties:

• IsValid
• ErrorMessage
• ErrorCode

🎯 Design Principles

• Lightweight
• Zero dependencies
• Compiled Regex for performance
• Fluent and readable
• Extendable architecture
• MAUI ready
• Enterprise-ready

🔒 Security Notes

• Aadhaar validation is format-based only
• This package does NOT store or transmit sensitive data
• Always follow local legal compliance when handling government IDs

🛣 Roadmap

Planned enhancements:

• Generic Validator<T>
• Multiple error collection support
• Localization support
• Custom rule registration
• Multi-country validation packs
• Enterprise policy presets

👤 Author

Aswin Sadhasivam Aquila Innovations

If you want next level, I can now:

• Add GitHub badges (NuGet version, downloads, build status)
• Create professional NuGet package description (short 4000-char optimized)
• Write release notes for v1.0.0
• Create a marketing-ready version of README
• Or prepare for official NuGet publishing

What’s next? 🚀