Bikiran.Validation 1.0.9

Bikiran.Validation

A comprehensive validation library for .NET applications providing robust validation utilities for common data types and formats including emails, URLs, IP addresses, user credentials, files, phone numbers, server names, and more.

Features

• 15+ Validation Types (Email, Date, IP, URL, File formats, Phone, Server names, etc.)
• Extensible Validation Framework
• Customizable Error Messages
• Regex-Powered Validation
• Null Safety Handling
• Optional Field Support
• Batch Validation for collections
• Cross-Platform .NET Standard 2.0+ Support

Installation

dotnet add package Bikiran.Validation

Quick Start

using Bikiran.Validation;

// Validate an email
var emailResult = ValEmail.IsValidEmailFormat("user@example.com", "Email Address");
if (emailResult.Error)
{
    Console.WriteLine(emailResult.Message); // Display error
}

// Validate a password
var passwordResult = ValUser.IsValidPasswordFormat("SecurePass123!", "Password");
if (!passwordResult.Error)
{
    Console.WriteLine("Password is valid!");
}

// Validate a server name
var serverResult = ValServer.IsValidServerNameFormat("web-server-01", "Server Name");
if (!serverResult.Error)
{
    Console.WriteLine("Server name is valid!");
}

Available Validators

Advanced Usage

Custom Error Messages

// Customize the field name in error messages
var result = ValEmail.IsValidEmailFormat(email, "Work Email Address");
// Error message will be: "Please enter valid Work Email Address"

Optional Fields

// Use isOptional parameter for optional fields
var phoneResult = ValPhone.IsValidPhoneNumberFormat(phoneNumber, "Phone Number", isOptional: true);
if (!phoneResult.Error || phoneResult.Message == "Optional")
{
    // Field is either valid or empty (which is acceptable)
}

Customizable Length Constraints

// Customize min/max lengths
var usernameResult = ValUser.IsValidUserNameFormat(username, "Username", min: 3, max: 30);
var serverResult = ValServer.IsValidServerNameFormat(serverName, "Server", min: 3, max: 50, specialCharacter: "-_.");

Validation Rules Details

Password Requirements

• 8-32 characters
• 1 uppercase letter
• 1 lowercase letter
• 1 number
• 1 special character

Username Requirements

IsCleanUserNameFormat (Strict alphanumeric):

• 5-20 characters (customizable)
• Only alphanumeric characters (a-z, A-Z, 0-9)
• Must start with a letter or digit
• Must end with a letter or digit

IsValidUserNameFormat (Allows special characters):

• 5-20 characters (customizable)
• Alphanumeric with .-@ allowed
• Must start with a letter or digit
• Must end with a letter or digit

Server Name Requirements

IsValidServerNameFormat:

• 5-32 characters (customizable)
• Alphanumeric (a-z, A-Z, 0-9) with customizable special characters (default: -_)
• Must start with a letter or digit
• Must end with a letter or digit
• Special characters allowed only in the middle

File Validation

• Images: JPEG, PNG, SVG (max 1MB)
• Documents: PDF, DOC, DOCX (max 1MB)
• Media Files: MP4, AVI, MP3, WAV (max 100MB)

Contribution

1. Fork the repository
2. Create feature branch (git checkout -b feature/AmazingFeature)
3. Commit changes (git commit -m 'Add AmazingFeature')
4. Push to branch (git push origin feature/AmazingFeature)
5. Open Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Support

Found a bug? Please open an issue.