Mecesoft.ShortGuid 1.0.1

Mecesoft.ShortGuid

Kısa, URL‑güvenli, padding’siz Base64 temsiline sahip Guid sarmalayıcısı (ShortGuid) ve .NET/EF Core entegrasyonları.

Özellikler

• 22 karakterlik ShortGuid (Base64 URL‑safe, '=' padding yok; '+' → '-', '/' → '_').
• System.Text.Json için gömülü JsonConverter (atribüt ile).
• Binding senaryoları için TypeConverter.
• EF Core için ValueConverter ve model geneli için kolay uzantı (UseShortGuidConverters).
• net9.0 hedefi, Nullable ve ImplicitUsings etkin.

Kurulum

• Projeyi referans alın veya NuGet paketini oluşturup yayınlayın.
• NuGet package ID: Mecesoft.ShortGuid (paketi yerel olarak dotnet pack ile üretebilirsiniz).

Hızlı Başlangıç

1. ShortGuid oluşturma ve yazdırma

using Mecesoft.ShortGuid;

var sg = ShortGuid.NewGuid();
string s = sg.ToString(); // 22 karakter
ShortGuid parsed = ShortGuid.Parse(s); // round‑trip
Guid g = sg;                 // implicit cast ShortGuid -> Guid
ShortGuid sg2 = (ShortGuid)g; // implicit cast Guid -> ShortGuid

2. System.Text.Json ile kullanım (atribüt zaten tanımlı)

using System.Text.Json;
using Mecesoft.ShortGuid;

var sg = ShortGuid.NewGuid();
var json = JsonSerializer.Serialize(new { id = sg });
var obj = JsonSerializer.Deserialize<Wrapper>(json);

public record Wrapper(ShortGuid id);

3. EF Core modeli genelinde dönüştürücü uygulama

using Mecesoft.ShortGuid.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore;

public class AppDbContext : DbContext
{
    public DbSet<User> Users => Set<User>();

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.UseShortGuidConverters(); // ShortGuid <-> Guid converter tüm ShortGuid alanlarına uygulanır
    }
}

public class User
{
    public ShortGuid Id { get; set; }
}

ShortGuid biçimi

• 16 baytlık Guid verisi Base64’e çevrilir, ardından URL‑güvenli hâle getirilir ve sondaki "==" kaldırılır.
• Örnek: 5Qqz8l5wQ0mY1m6dH7e5xQ (uzunluk 22).
• Parse/TryParse hem normal Guid string’i hem de 22 karakterlik ShortGuid’i kabul eder.

Derleme ve Paketleme

• Gereksinimler: .NET SDK 9.x, internet erişimi (EF Core 9 bağımlılığı için).
• Derle: dotnet build Mecesoft.ShortGuid/Mecesoft.ShortGuid.csproj -c Release
• Paketle: dotnet pack Mecesoft.ShortGuid/Mecesoft.ShortGuid.csproj -c Release
  • Proje GeneratePackageOnBuild=true ayarlı olduğundan dotnet build de .nupkg üretir.

Lisans

• MIT License (bkz. LICENSE).