TurkishValidators.FluentValidation 1.1.0

TurkishValidators 🇹🇷

<img src="icon.png" align="right" width="128" height="128" />

TurkishValidators, Türkiye'ye özgü veri tipleri (TCKN, Vergi No, IBAN, Telefon, Plaka, Posta Kodu) için geliştirilmiş; performanslı, hafif, API bağımlılığı olmayan ve genişletilebilir bir .NET doğrulama kütüphanesidir.

🚀 Özellikler

• Tamamen Offline: Hiçbir dış servise veya API'ye istek atmaz. Matematiksel algoritmalarla çalışır.
• Yüksek Performans: Allocation-free (tahsisatsız) algoritmalar ve optimize edilmiş string işlemleri.
• Geniş Kapsam:
  • ✅ TC Kimlik Numarası (Algoritma + Test Numarası Desteği)
  • ✅ Vergi Kimlik Numarası (VKN)
  • ✅ IBAN (TR IBAN Formatı + Checksum)
  • ✅ Telefon Numarası (GSM ve Sabit Hat, Operör Kontrolü)
  • ✅ Araç Plakası (81 İl Kodu, Resmi/Özel Plaka Formatları)
  • ✅ Posta Kodu (81 İl ve İlçe Validasyonu)
• Çoklu Dil Desteği (Localization): Türkçe (Varsayılan) ve İngilizce hata mesajları.
• Veri Maskeleme: KVKK/GDPR uyumlu veri maskeleme yardımcıları.
• Entegrasyonlar:
  • ASPNET Core ValidationAttribute desteği.
  • FluentValidation extension metodları.
• Test Verisi Üretimi: Testleriniz için geçerli rastgele veri üreten TurkishValidators.TestData paketi.

📦 Kurulum

Projenize NuGet üzerinden ekleyebilirsiniz:

# Core Kütüphane (Temel Doğrulayıcılar)
dotnet add package TurkishValidators

# ASP.NET Core Entegrasyonu (Attributes)
dotnet add package TurkishValidators.AspNetCore

# FluentValidation Entegrasyonu
dotnet add package TurkishValidators.FluentValidation

# Test Verisi Üreticisi (Test Projeleri İçin)
dotnet add package TurkishValidators.TestData

# System.Text.Json Entegrasyonu
dotnet add package TurkishValidators.Json

💻 Kullanım

1. Temel Kullanım (Core)

using TurkishValidators.Validators;

// TC Kimlik No Doğrulama
var tcknValidator = new TcKimlikNoValidator();
var result = tcknValidator.Validate("10000000146");
if (result.IsValid)
{
    Console.WriteLine("Geçerli TCKN!");
}
else
{
    Console.WriteLine(result.ErrorMessage); // "TC Kimlik Numarası geçersiz."
}

// Statik Kullanım
bool isValid = TcKimlikNoValidator.IsValid("10000000146");

2. ASP.NET Core Entegrasyonu (Attributes)

Model sınıflarınızda doğrudan kullanabilirsiniz:

using TurkishValidators.AspNetCore.Attributes;

public class UserDto
{
    [TcKimlikNo(ErrorMessage = "Lütfen geçerli bir TC giriniz.")]
    public string NationalId { get; set; }

    [TurkishPhone]
    public string PhoneNumber { get; set; }

    [VehiclePlate]
    public string CarPlate { get; set; }
}

3. FluentValidation Entegrasyonu

Mevcut validator sınıflarınızda zincirleme metodlar (chaining) ile kullanın:

using FluentValidation;
using TurkishValidators.FluentValidation.Extensions;

public class CustomerValidator : AbstractValidator<Customer>
{
    public CustomerValidator()
    {
        RuleFor(x => x.TcNo).MustBeTurkishIdentity();
        RuleFor(x => x.Iban).MustBeTurkishIban();
        RuleFor(x => x.Plate).MustBeVehiclePlate();
        
        // Opsiyonel Ayarlar
        RuleFor(x => x.TaxNo).MustBeTurkishTaxNumber(new VergiNoValidationOptions 
        { 
             // Ayarlar...
        });
    }
}

4. Veri Maskeleme (Masking)

Hassas verileri loglarken veya gösterirken maskeleyin:

using TurkishValidators.Masking;

string maskedTc = TcKimlikNoMasker.Mask("12345678901"); 
// Çıktı: 123******01 (Varsayılan: İlk 3, Son 2 açık)

string maskedIban = IbanMasker.Mask("TR330006100519786457841326");
// Çıktı: TR********************1326

// Özel Ayarlar
var options = new MaskingOptions { VisibleStart = 0, VisibleEnd = 4, MaskChar = 'X' };
string customMask = TcKimlikNoMasker.Mask("12345678901", options);
// Çıktı: XXXXXXX8901

5. Test Verisi Üretimi (TestData)

Testlerinizde kullanmak üzere geçerli rastgele veriler üretin:

using TurkishValidators.TestData.Services;

var provider = new TurkishDataProvider();

string randomTc = provider.GenerateTcKimlikNo();
string randomIban = provider.GenerateTurkishIban();
string istPlate = provider.GenerateVehiclePlate("İstanbul"); // 34 ... ...

// Toplu Veri Üretimi
var bulkData = provider.GenerateBulk(100);

// Toplu Veri Üretimi var bulkData = provider.GenerateBulk(100);

### 6. Kredi Kartı & BIN Sorgulama (Yeni!)

Luhn algoritması kontrolü ve banka BIN analizi (Troy, Visa, Mastercard tespiti):

```csharp
using TurkishValidators.Validators;
using TurkishValidators.Enums;

bool isValid = CreditCardValidator.IsValid("4543600000000003");

var result = CreditCardValidator.GetBinInfo("4543600000000003");
if (result.IsValid)
{
    Console.WriteLine($"Bank: {result.BankName}"); // Türkiye İş Bankası
    Console.WriteLine($"Type: {result.CardType}"); // Visa
}

7. System.Text.Json Entegrasyonu (Yeni!)

JSON çıktısında veriyi otomatik maskelemek için:

1. TurkishValidators.Json paketini yükleyin.
2. Property üzerine attribute ekleyin:

using System.Text.Json;
using System.Text.Json.Serialization;
using TurkishValidators.Json.Converters;

public class UserDto
{
    [JsonConverter(typeof(TcknMaskingConverter))]
    public string Tckn { get; set; } = "12345678901";
}

// Çıktı: {"Tckn": "123******01"}

8. TurkishFaker (Statik Test Verisi) (Yeni!)

Hızlıca mock data üretmek için statik erişim:

using TurkishValidators.TestData;

string tckn = TurkishFaker.GenerateTCKN();
string iban = TurkishFaker.GenerateIBAN();
string mobil = TurkishFaker.GenerateGSM();

⚙️ Yapılandırma (Configuration)

Uygulama genelinde hata mesajı dilini veya formatını değiştirebilirsiniz:

using TurkishValidators.Config;

// Uygulama başlangıcında (Program.cs / Startup.cs)
TurkishValidatorConfig.Culture = new System.Globalization.CultureInfo("en-US");
// Artık hata mesajları İngilizce dönecektir.

🌍 Gelişmiş Dil Desteği (Advanced Localization)

Varsayılan Türkçe ve İngilizce mesajların yanı sıra, yeni diller ekleyebilir veya mevcut mesajları ezebilirsiniz:

using TurkishValidators.Config;
using TurkishValidators.Resources;

// Almanca için özel mesaj seti tanımlama
var germanMessages = new ValidationMessages
{
    TcKimlikNoEmpty = "Die TC-Identitätsnummer darf nicht leer sein.",
    TcKimlikNoLength = "Die TC-Identitätsnummer muss 11 Ziffern lang sein.",
    // Diğer mesajlar...
};

// "de-DE" kültürü için kaydet
TurkishValidatorConfig.RegisterMessages("de-DE", germanMessages);

// Veya mevcut Türkçe mesajı değiştirme
var customTr = ValidationMessages.CreateDefault();
customTr.TcKimlikNoEmpty = "Lütfen TCKN alanını boş bırakmayınız!";
TurkishValidatorConfig.RegisterMessages("tr-TR", customTr);

🔌 Uyumluluk (Compatibility)

Proje .NET Standard 2.0 hedeflemektedir, bu sayede aşağıdaki platformların tamamında sorunsuz çalışır:

• .NET 5, .NET 6, .NET 7, .NET 8+
• .NET Core 2.0+
• .NET Framework 4.6.1+

🏗️ Proje Yapısı

• src/TurkishValidators: Çekirdek kütüphane.
• src/TurkishValidators.AspNetCore: ASP.NET Core attribute'ları.
• src/TurkishValidators.FluentValidation: FluentValidation eklentileri.
• src/TurkishValidators.TestData: Test verisi üretim kütüphanesi.

🤝 Katkıda Bulunma

PR'lar kabul edilir! Lütfen önce bir issue açarak değişikliği tartışın.

📄 Lisans

Bu proje MIT lisansı ile lisanslanmıştır.