Levge.Extensions 2.3.0

Levge.Extensions

.NET 10 uygulamaları için günlük geliştirme ihtiyaçlarını karşılayan extension method koleksiyonu.
DI kaydı gerektirmez — using Levge.Extensions; yeterlidir.

İçindekiler

• Kurulum
• StringExtensions
• EnumerableExtensions
• DateTimeExtensions
• ObjectExtensions
• TaskExtensions
• Bağımlılıklar

Kurulum

dotnet add package Levge.Extensions

StringExtensions

using Levge.Extensions;

// Null / boşluk kontrolü
string? name = null;
name.IsNullOrEmpty();        // true
"  ".IsNullOrWhiteSpace();   // true

// Kırpma (log mesajı, başlık vb.)
"Bu çok uzun bir açıklama metnidir".Truncate(20); // "Bu çok uzun bir açı..."

// camelCase dönüşümü (API field normalizasyonu)
"UserName".ToCamelCase();     // "userName"
"tenant_name".ToCamelCase();  // "tenantName"
"X-Device-Id".ToCamelCase();  // "xDeviceId"

// Slug (URL, SEO)
"Merhaba Dünya!".ToSlug();   // "merhaba-dnya"
"Hello World 2025".ToSlug(); // "hello-world-2025"

// Base64 URL (token aktarımı, e-posta linkleri)
var token = "my-secret-token".ToBase64Url();   // "bXktc2VjcmV0LXRva2Vu"
var back  = token.FromBase64Url();             // "my-secret-token"

EnumerableExtensions

// Null / boş koleksiyon kontrolü
List<int>? items = null;
items.IsNullOrEmpty(); // true
new List<int>().IsNullOrEmpty(); // true

// Toplu işlem — batch insert, e-posta gönderimi vb.
var userIds = Enumerable.Range(1, 250);
foreach (var batch in userIds.Batch(50))
{
    await _repo.BulkInsertAsync(batch); // 50'şer kayıt
}

// Sayfalama (in-memory)
var page = allOrders.Paginate(page: 2, pageSize: 20);

// ForEach
users.ForEach(u => u.IsActive = false);

DateTimeExtensions

// Unix timestamp (JWT iat/exp, log korelasyonu)
DateTime.UtcNow.ToUnixTimestamp(); // örn. 1714220400

// Token / kod geçerlilik kontrolü
var codeExpiry = DateTime.UtcNow.AddMinutes(15);
codeExpiry.IsExpired(); // false (henüz geçmedi)

// Gün aralığı sorguları
var start = DateTime.Today.StartOfDay(); // 2025-04-27 00:00:00
var end   = DateTime.Today.EndOfDay();   // 2025-04-27 23:59:59.9999999

var todayOrders = orders.Where(o => o.CreatedAt >= start && o.CreatedAt <= end);

ObjectExtensions

// Derin kopya (DTO dönüşümleri, test senaryoları)
var clone = originalConfig.DeepClone();

// JSON serializasyon (loglama, debug)
_logger.LogDebug(request.ToJson());

// Değer kümesi kontrolü
if (order.Status.IsOneOf(OrderStatus.Pending, OrderStatus.Processing))
    await NotifyAsync(order);

// Güvenli cast
var admin = user.As<AdminUser>(); // null döner, exception fırlatmaz

TaskExtensions

// Fire-and-forget (bildirim gönderimi, audit log vb.)
_notificationService.SendAsync(userId).FireAndForget(_logger, "SendNotification");

// Zaman aşımı
try
{
    await externalApiCall.TimeoutAfter(TimeSpan.FromSeconds(10));
}
catch (TimeoutException)
{
    _logger.LogWarning("Harici API zaman aşımına uğradı.");
}

// Hata yakalama + yeniden fırlatma
await _repo.SaveAsync()
    .OnFailure(ex => _logger.LogError(ex, "Kayıt başarısız."));

// Paralel görev bekleme
var tasks = users.Select(u => _emailService.SendAsync(u.Email));
await tasks.WhenAll();

Bağımlılıklar