Bölüm 8 — Konu 41: `assert` ile Geliştirme Zamanı Kontrolleri

Bölüm 8'in son konusundayız. assert'i Bölüm 6'da initializer list içinde kısaca görmüştük — şimdi bunu tam olarak işleyip, hata yönetimiyle olan ilişkisini netleştireceğiz.

#assert Nedir?

assert, bir koşulun doğru olduğunu varsaydığın yerlerde, bu varsayımı açıkça doğrulamak için kullanılan bir araçtır:

void main() {
  int yas = 25;
  assert(yas >= 0, "Yaş negatif olamaz");
  print("Yaş: $yas");
}

Eğer assert içindeki koşul false ise, program bir AssertionError fırlatır:

void main() {
  int yas = -5;
  assert(yas >= 0, "Yaş negatif olamaz"); // ❌ AssertionError fırlatır
  print("Bu satır hiç çalışmaz");
}

#assert ile throw/Exception Arasındaki Kritik Fark

Bu, assert'in en önemli ve en sık yanlış anlaşılan özelliğidir: assert, sadece "debug" modda çalışır — üretim (release/production) modunda tamamen devre dışı kalır ve hiçbir performans maliyeti getirmez!

void islemYap(int deger) {
  assert(deger > 0, "Değer pozitif olmalı"); // sadece debug modda kontrol edilir
  print("İşlem yapılıyor: $deger");
}

Bunu Exception ile karşılaştıralım:

void islemYapGuvenli(int deger) {
  if (deger <= 0) {
    throw Exception("Değer pozitif olmalı"); // HER ZAMAN kontrol edilir, debug/release fark etmez
  }
  print("İşlem yapılıyor: $deger");
}

Bu fark neden önemli?

#Ne Zaman assert, Ne Zaman Exception Kullanılmalı?

assert kullan, eğer:

• Kontrol ettiğin şey, senin kendi kod mantığının bir varsayımı ise ("bu fonksiyona asla negatif bir değer gelmemeli, çünkü çağıran kod zaten kontrol ediyor").
• Bu, aslında bir bug'ı yakalamak için — yani "eğer bu koşul false ise, benim kodumda bir hata var demektir."

Exception/throw kullan, eğer:

• Kontrol ettiğin şey, dış dünyadan gelen (kullanıcı girdisi, API cevabı, dosya içeriği gibi) ve gerçekten yanlış olabilecek bir veri ise.
• Bu durumun üretimde de (kullanıcı karşısında) kontrol edilmesi ve düzgün bir şekilde ele alınması gerekiyor.

// assert — geliştirici varsayımı, bug yakalamak için
void dahiliHesaplama(int index, List<int> liste) {
  assert(index >= 0 && index < liste.length, "Geçersiz index — bu bir kod hatasıdır");
  print(liste[index]);
}

// Exception — kullanıcı girdisi, üretimde de kontrol edilmeli
void kullaniciYasiKaydet(int yas) {
  if (yas < 0 || yas > 150) {
    throw ArgumentError("Geçersiz yaş değeri: $yas");
  }
  print("Yaş kaydedildi: $yas");
}

Basit bir zihinsel model: assert, kodunu yazarken kendine "bu asla olmamalı, ama olursa hemen haber ver" demenin bir yolu. Exception, "bu olabilir, ve olduğunda düzgün bir şekilde ele almam gerekiyor" demenin bir yolu.

#assert Debug Modda Nasıl Çalışır?

Flutter'da (ve genel olarak Dart'ta) iki temel çalıştırma modu vardır:

• Debug mode: Geliştirme sırasında kullanılır (flutter run ile varsayılan olarak), assert'ler aktiftir.
• Release mode: Uygulamayı kullanıcıya yayınlarken kullanılır (flutter build ile), assert'ler tamamen kaldırılır (kod satırları derlenen çıktıya bile dahil edilmez).

Bu, assert'i sıfır maliyetli bir geliştirme aracı yapar — istediğin kadar assert ekleyebilirsin, üretim performansını hiç etkilemez, ama geliştirme sırasında hataları anında yakalamana yardımcı olur.

#assert ile Karmaşık Koşullar

class Dikdortgen {
  final double genislik;
  final double yukseklik;

  Dikdortgen(this.genislik, this.yukseklik)
      : assert(genislik > 0, "Genişlik pozitif olmalı"),
        assert(yukseklik > 0, "Yükseklik pozitif olmalı");
}

void main() {
  Dikdortgen d1 = Dikdortgen(5, 10); // ✅ sorunsuz
  Dikdortgen d2 = Dikdortgen(-5, 10); // ❌ AssertionError (sadece debug modda)
}

Bölüm 6'da initializer list'te gördüğümüz gibi, birden fazla assert art arda, virgülle ayrılarak yazılabilir — her biri farklı bir varsayımı doğrular.

#assert Mesajsız da Kullanılabilir

void main() {
  int deger = 10;
  assert(deger > 0); // mesaj opsiyonel
}

Mesaj yazmak zorunlu değildir ama şiddetle önerilir — mesajsız bir assert başarısız olduğunda, sadece "bir yerde bir assert başarısız oldu" bilgisini alırsın, neden başarısız olduğunu anlamak için kodu incelemen gerekir. Anlamlı bir mesaj, hatayı anında anlamanı sağlar.

#Flutter Bağlantısı — Neden Bu Kadar Önemli?

Flutter'ın kendi iç kod tabanında binlerce assert vardır — örneğin bir widget'a geçersiz bir parametre (negatif bir genişlik gibi) verdiğinde, Flutter bunu genelde bir assert ile geliştirme sırasında hemen yakalar ve sana anlamlı bir hata mesajı gösterir. Bu, Flutter'ın "geliştirici deneyimi" felsefesinin önemli bir parçasıdır — hataları, kullanıcı karşısında değil, sen kodu yazarken yakalamaya çalışır.

#🎯 Bu Dersten Çıkarılması Gerekenler

• assert, bir koşulun doğru olduğunu doğrulamak için kullanılır; koşul false ise AssertionError fırlatır.
• assert, sadece debug modda çalışır — release modda tamamen kaldırılır, sıfır performans maliyeti getirir.
• assert, geliştirici varsayımlarını (bug'ları) yakalamak için; Exception/throw, üretimde de kontrol edilmesi gereken dış dünya kaynaklı hatalar için kullanılır.
• Anlamlı bir mesaj eklemek, assert başarısız olduğunda hatayı hızlıca anlamanı sağlar.
• Flutter, kendi iç kodunda yoğun şekilde assert kullanır — bu, hataları geliştirme sırasında erken yakalama felsefesinin bir parçasıdır.

#📝 Ödevler

• [ ] Bir fonksiyona assert ekleyerek, parametrenin belirli bir aralıkta olduğunu doğrula (örn. 0-100 arası bir puan), hem geçerli hem geçersiz değerle test et.
• [ ] Aynı kontrolü bir kere assert ile bir kere throw Exception ile yaz, ikisinin ne zaman/nasıl farklı davrandığını (debug/release bağlamında) yorumla.
• [ ] Bir class'ın constructor'ında initializer list içinde birden fazla assert kullanarak birkaç alanı doğrula.
• [ ] Mesajlı ve mesajsız iki assert örneği yaz, başarısız olduklarında verdikleri bilgi farkını karşılaştır.
• [ ] Kendi cümlelerinle, "assert ile Exception'ı ne zaman kullanmalıyım" sorusuna, bu dersten öğrendiğin kriterlerle bir karar rehberi yaz.

#🏁 Bölüm 8 Tamamlandı!

Hata yönetimini ve null safety'nin ileri detaylarını tamamladık: try/catch/finally, özel exception sınıfları, sound null safety'nin derinlemesine işleyişi ve assert. Artık kodunun hem beklenmedik hem de beklenen hata durumlarını güvenli ve profesyonel şekilde yönetebiliyorsun.

Daha önce konuştuğumuz gibi, şimdi Bölüm 1-8'i birleştiren bir mini proje ödevi ile bu bölümü pekiştirelim.

Sıradaki: Bölüm 1-8 Mini Proje — "Kütüphane Yönetim Sistemi" (Konsol Uygulaması)