API Sözleşme Testi Açıklaması: Son Dakika Değişikliklerini Gönderilmeden Önce Yakalayın

  1. Ana sayfa
  2. Blog
  3. Test Otomasyonu

Test Otomasyonu

API Sözleşme Testinin Açıklaması: Çarpıcı Değişiklikleri Gönderilmeden Önce Yakalayın

Bir ekip bir API’yi değiştirdiğinde, üretime kadar başka bir ekibin uygulaması kimse fark etmeden bozulabilir. Sözleşme testi, tüm sistemi çalıştırmadan her iki tarafın da hala aynı fikirde olup olmadığını kontrol eder. Hangilerinin tüketicileri rahatsız ettiğini göstermek için beş gerçekçi API değişikliğini bir sözleşmeye göre test ettik.

10 dk okuma
API sözleşme testi açıklandı: son değişiklikleri gönderilmeden önce yakalayın

Önemli noktalar

  • Sözleşme, bir API sağlayıcısı ile tüketicileri arasında üzerinde anlaşmaya varılan istek ve yanıt şeklidir.
  • Sözleşme testleri her iki tarafı da söz konusu sözleşmeye göre ayrı ayrı kontrol eder; böylece her hizmetin çalıştırılmasına gerek kalmaz.
  • Yaptığımız kontrolde alan ekleme başarılı oldu, alan yeniden adlandırma, tür değiştirme veya numaralandırma değeri ekleme başarısız oldu.
  • Çoğunlukla Pakt ile yapılan Tüketici odaklı sözleşmeler, yalnızca tüketicilerin gerçekte ne kullandığını test eder.

Sipariş ekibi daha iyi okunduğu için total‘i amount olarak yeniden adlandırdı. Kendi testleri geçer ve konuşlandırılırlar. On dakika sonra mobil uygulama her siparişin hiçbir maliyeti olmadığını gösteriyor ve fatura hizmeti çöküyor. Her takım kendi kodunu test etti ancak kimse aralarındaki anlaşmayı test etmedi. Bu boşluk, sözleşme testinin doldurduğu şeydir.

JSON Şeması olarak küçük bir sözleşme oluşturduk ve Python jsonschema kitaplığıyla (sürüm 4.26) buna göre beş gerçekçi sağlayıcı yanıtını kontrol ettik. Aşağıdaki sonuçlar bu çalışmadan alınmıştır. Pact ve OpenAPI araçları, belgelerinde açıklanmıştır; onları bu makale için çalıştırmadık.

Hizmetlerin tek başına test edilmesiyle ilgili sorun

Birçok hizmetten oluşan bir sistemde her ekip, kendi hizmeti için birim testleri ve API testleri yazar. Bu testler, ekibin diğer hizmetlerin ne gönderip beklediğine ilişkin kendi fikrini, genellikle taklit olarak kullanır. Bir sağlayıcı değiştiğinde tüketicinin taklitleri eski şekline döner, böylece tüketicinin testleri geçmeye devam eder. Uyumsuzluk yalnızca her iki sürüm de paylaşılan bir ortamda veya üretimde buluştuğunda keşfedilir. Tam uçtan uca testler bunu yakalayabilir, ancak yavaştırlar, kırılgandırlar ve her şeyin birlikte konuşlandırılmasını gerektirirler.

Sözleşme testi nedir?

Sözleşme testi, bir API’yi çağıran bir tüketici ve ona hizmet veren bir sağlayıcı olan iki tarafın nasıl iletişim kuracakları konusunda anlaşıp anlaşmadıklarını kontrol eder: uç noktalar, yöntemler, başlıklar, istek gövdeleri, yanıt alanları, türler ve durum kodları. Sözleşme, makine tarafından okunabilen bir sözleşme olarak yazılır. Daha sonra her iki taraf da sözleşmeye göre kendi başına test edilir: Tüketici sözleşmeden oluşturulan bir modele karşı ve sağlayıcı da sözleşmenin taleplerini gerçek hizmete göre tekrarlayarak.

Diğer test türleriyle karşılaştırıldığında

Test türü Çekler Başka hizmetlerin çalıştırılması mı gerekiyor?
Birim testi Dahili mantık Hayır
API / işlevsel test Bir hizmetin davranışı Genellikle hayır
Sözleşme testi İki hizmet arasındaki anlaşma Hayır
Entegrasyon testi Birlikte çalışan gerçek hizmetler Evet
Uçtan uca test Tüm kullanıcı yolculuğu Evet, her şey

Sözleşme testleri, test piramidinde API testleri ile entegrasyon testleri arasında yer alır. Neredeyse birim testleri kadar hızlıdırlar ancak daha önce entegrasyon ortamlarına ihtiyaç duyulan sorunları yakalarlar.

Çalıştırdığımız bir sözleşme kontrolü

Aşağıda JSON Şeması olarak yazılmış, sipariş yanıtına yönelik basit bir sözleşme verilmiştir:

contract = {
  "type": "object",
  "required": ["id", "status", "total"],
  "properties": {
    "id":     {"type": "integer"},
    "status": {"enum": ["paid", "pending", "refunded"]},
    "total":  {"type": "number", "minimum": 0}
  }
}

Sağlayıcının yanıtının beş versiyonunu doğruladık:

v1 provider              PASS
v1 + new field           PASS
renamed total->amount    FAIL: 'total' is a required property
id as string             FAIL: '101' is not of type 'integer'
new status value         FAIL: 'on_hold' is not one of ['paid', 'pending', 'refunded']

Tüketiciler bilmedikleri alanları göz ardı ettiğinden currency alanı eklemek güvenliydi. total‘yi yeniden adlandırmak, kimliği metin olarak göndermek ve yeni bir durum değeri eklemek sözleşmeyi bozdu. Bunların her biri sağlayıcının kendi testlerini geçmiş olacaktır.

Kırılma ve güvenli değişiklikler

Değiştir Genellikle kırılıyor mu?
İsteğe bağlı bir yanıt alanı ekleyin Hayır
Yeni bir uç nokta ekleme Hayır
Yanıt alanını kaldırma veya yeniden adlandırma Evet
Alanın türünü veya biçimini değiştirme Evet
İsteğe bağlı bir istek alanını gerekli kılın Evet
Yanıta yeni bir numaralandırma değeri ekleme Genellikle tüketiciler değerleri katı bir şekilde ele alıyorsa
Durum kodlarını veya hata biçimini değiştirin Evet
Girişlerde doğrulamayı sıkılaştırın Sık sık

Enum durumu incelikli. on_hold eklemek sağlayıcıya zararsız görünür, ancak bilinen durumlar üzerinde switch ifadesi olan bir tüketici çökebilir veya hiçbir şey göstermeyebilir. İyi yazılmış tüketiciler bilinmeyen değerleri incelikle ele alır ve sözleşmeler bu beklentiyi açıkça ortaya koyar. Ani bir değişiklik kaçınılmaz olduğunda sürüm oluşturma stratejileri için anlamsal sürüm oluşturma ve REST API en iyi uygulamalarımıza bakın.

Tüketici odaklı sözleşmeler

Tüketici odaklı sözleşme testinde her tüketici, sağlayıcıdan tam olarak neye ihtiyacı olduğunu yazar: yaptığı talepler ve okuduğu alanlar. Sağlayıcı her tüketicinin sözleşmesini yerine getirmelidir. Bunun büyük bir avantajı var: Bir sağlayıcı, hiçbir tüketicinin kullanmadığı herhangi bir şeyi serbestçe değiştirebilir veya kaldırabilir ve kullanılan bir şeyi değiştirirse hangi tüketicinin bozulacağını tam olarak bilir.

Demomuz, sağlayıcı odaklı stile daha yakın olan tek bir şemayı kontrol etti. Gerçek bir tüketici odaklı sözleşme genellikle yalnızca tüketicinin gerçekten okuduğu alanları listeler, böylece hiç kimse tarafından kullanılmayan bir alan herhangi bir hata olmadan kaldırılabilir.

İpucu: Sözleşmeler, sağlayıcının iade ettiği her şeyi değil, tüketicinin neye ihtiyacı olduğunu açıklamalıdır. Her alanı ve kesin değeri belirleyen bir sözleşme, sağlayıcının testlerinin kırılgan bir kopyası haline gelir, zararsız değişikliklerde başarısız olur ve güveni aşındırır.

Pakt nasıl çalışır?

Pact, birçok dil için kütüphaneleri bulunan, en yaygın kullanılan tüketici odaklı sözleşme aracıdır. Akış, belgelerinden:

  1. Tüketici testi: Tüketicinin birim testleri, beklenen her isteği ve ihtiyaç duydukları minimum yanıtı bildiren bir Pact sahte sunucusunu çağırır.
  2. Anlaşma dosyası: bu beklentiler bir JSON sözleşmesi, yani “anlaşma” olarak kaydedilir.
  3. Paylaş: anlaşma bir Pact Broker veya PactFlow’da yayınlanır.
  4. Sağlayıcı doğrulaması: sağlayıcının CI’sı tüm anlaşmaları getirir, her isteği gerçek sağlayıcıya göre tekrar oynatır ve yanıtları kontrol eder.
  5. Dağıtım yapabilir miyim? Her iki tarafı da dağıtmadan önce, birlikte çalışacak sürümlerin doğrulanmış sözleşmelere sahip olduğu doğrulanır.

“Sipariş 101 mevcut” gibi sağlayıcı durumları, sağlayıcının her etkileşim için test verilerini ayarlamasına olanak tanır. Çoğu takımın Pakt’ı benimserken çabalarını harcadığı yer burasıdır.

OpenAPI ile sağlayıcı odaklı sözleşmeler

Çoğu ekip diğer yönden başlar: sağlayıcı bir OpenAPI spesifikasyonu yayınlar ve testler, gerçek API’nin bununla eşleştiğini ve tüketicilerin yalnızca tanımladığını kullandığını kontrol eder. Araçlar, spesifikasyona göre canlı yanıtları doğrulayabilir, ondan testler oluşturabilir veya spesifikasyonun iki versiyonunu karşılaştırabilir ve değişiklikleri işaretleyebilir. Bu, tüketici sözleşmelerinin toplanmasının imkansız olduğu, pek çok bilinmeyen tüketiciye sahip genel API’ler için işe yarar. Buradaki değiş tokuş, herhangi bir tüketicinin gerçekte hangi parçalara güvendiğini değil, mesajların dilbilgisini kontrol etmesidir.

CI’da sözleşme testleri

  • Tüketici hattı: Tüketici sözleşmesi testleri yapın ve her değişiklikte sözleşmeyi yayınlayın.
  • Sağlayıcı hattı: her değişiklikte tüm tüketici sözleşmelerini doğrulayın; Herhangi bir molada derlemede başarısız olun.
  • Dağıtmadan önce: her ortama giden tam sürümler arasındaki uyumluluğu kontrol edin.
  • Web kancaları: Bir tüketici değiştirilmiş bir sözleşmeyi yayınladığında sağlayıcının doğrulamasını hemen tetikler.

Bunu CI/CD ardışık düzenine sığdırmak “kimseyi kırdık mı?” bir toplantıdan derleme durumuna geçiş.

Tuzaklar

  • Aşırı belirtme: Türler ve zorunlu alanlar yerine kesin değerlerin belirtilmesi sözleşmeleri kırılgan hale getirir.
  • Sözleşmeleri işlevsel testler olarak ele almak: bir sözleşme, iş doğruluğunu değil şekli ve anlaşmayı kontrol eder. Fonksiyonel testleri de saklayın.
  • Sağlayıcı şunu belirtiyor: gerçekçi kurulum verileri olmadan, doğrulama yanlış nedenlerden dolayı başarılı oluyor.
  • Sahiplik yok: Birinin komisyoncuya sahip olması ve doğrulamalar başarısız olduğunda yanıt vermesi gerekir.
  • Eşzamansız mesajları unutma: Kuyruklardaki olaylar da sözleşmelerdir ve Pact gibi araçlar mesaj sözleşmelerini destekler.

Sözleşme testi ne zaman kullanılmalı?

Sözleşme testi, birkaç ekibin birbirini çağıran hizmetlere sahip olması, dağıtımların bağımsız olması ve entegrasyon ortamlarının yavaş veya güvenilmez olması durumunda karşılığını verir. Bir API ve bir ön ucun birlikte konuşlandırıldığı tek bir ekip için iyi API testleri yeterli olabilir. API test kılavuzumuz bu başlangıç ​​noktasını kapsar.

Okyanusu kaynatmadan başlamak

  1. Bir çift seçin: entegrasyonu en sık bozulan veya en önemli olan tüketici ve sağlayıcı.
  2. İki veya üç temel etkileşim için tüketicinin beklentilerini yazın ve yalnızca okuduğu alanları belirtin.
  3. Sağlayıcıyı yerel olarak onlara karşı doğrulayın ve doğru nedenlerden dolayı sağlayıcı durumlarını onaylanana kadar düzeltin.
  4. Her iki tarafı da CI’ya ekleyin, böylece her iki takım da anlaşmayı ihlal ettiğini dakikalar içinde öğrenir.
  5. Birkaç hafta sonra inceleme: herhangi bir şey yakaladı mı ve kaçırdığı bir şey kırıldı mı? Daha sonra bir sonraki çifte kadar uzatın.

Küçükten başlamak çabayı görünür tutar ve güven oluşturur. Her hizmeti aynı anda sözleşme altına almaya çalışan ekipler, genellikle herhangi bir fayda görmeden önce araç ve test verileri üzerinde dururlar.

Son sözler

Sözleşme testi, her takımın kendi testlerinin göremediği önemli değişiklikleri yakalar: yeniden adlandırılan alanlar, değişen türler ve yeni numaralandırma değerleri. Önemli bir tüketici-sağlayıcı çiftiyle başlayın, sözleşmeleri tüketicinin gerçekte ne kullandığına odaklayın, sağlayıcıyı CI’da doğrulayın ve bir dağıtım kontrolü ekleyin. Basit testimizde, beş makul değişiklikten üçü, sağlayıcının kendi paketi tarafından görülemeyen tüketicileri bozabilirdi.

Sık sorulan sorular

API sözleşme testi nedir?

Tüm hizmetleri bir arada çalıştırmak yerine, her iki tarafı da paylaşılan bir sözleşmeye göre ayrı ayrı kontrol ederek, bir API sağlayıcısı ile tüketicilerinin istek ve yanıt formatları üzerinde anlaşıp anlaşmadıklarını test etmek.

Tüketici odaklı sözleşme testi nedir?

Her tüketicinin yaptığı istekleri ve ihtiyaç duyduğu alanları tanımladığı bir yaklaşım. Sağlayıcı tüm tüketici sözleşmelerine göre doğrulanmıştır, bu nedenle hangi değişikliklerin birisini bozacağını bilir.

Pakt nedir?

Pact, tüketici odaklı sözleşme testleri için popüler bir açık kaynaklı araçtır. Tüketici testleri, sağlayıcının daha sonra gerçek uygulamasına göre doğruladığı sözleşme dosyalarını oluşturur.

Alan eklemek önemli bir değişiklik mi?

İsteğe bağlı bir yanıt alanı eklemek genellikle güvenlidir; testimizde geçti. Bir alanın yeniden adlandırılması, kaldırılması veya türünün değiştirilmesi tüketicileri kırar.

Sözleşme testleri uçtan uca testlerin yerini mi alıyor?

Birçoğunun, özellikle de yalnızca servislerin konuşabildiğini kontrol etmek için kullanılanların yerini alıyor. Kritik kullanıcı yolculukları için birkaç uçtan uca test bulundurun.

Öğrenmeye devam et

Stack Quora ile çalışın

Test, WordPress veya SEO konusunda yardıma mı ihtiyacınız var?

Ekiplerin daha iyi yazılımlar sunmasına ve sitelerini büyütmesine yardımcı oluyoruz. Bize ne üzerinde çalıştığınızı söyleyin, biz de bir sonraki adım için net bir öneride bulunalım.

Okumaya devam et

Daha fazla kılavuz test, yapay zeka ve modern geliştirme

Bu makaleyi beğendiniz mi? Bir konu seçin ve doğrudan en yeni eğitimlerimize geçin.

Yapay zekâ

Açıklanan RAG Parçalama Stratejileri: Sabit, Örtüşme, Cümle, Yinelemeli ve Başlıklar, Ölçülen

RAG parçalama stratejileri, Tiktoken 0.14 ile tek bir belgede karşılaştırıldı: sabit boyut, örtüşme, cümle paketleme, özyinelemeli bölme ve başlık t…

Makaleyi okuyun →
Yazılım geliştirme

API Idempotency Açıklaması: Idempotency Anahtarları ve Güvenli Yeniden Denemeler, Test Edildi

API uyumsuzluğu, çalıştırdığımız bir Python sunucusu ve istemcisiyle açıklandı: Kayıp bir yanıt, anahtar olmadan çift ücretlendirmeye ve tek anahtar…

Makaleyi okuyun →
DevOps

Git Stash Açıklaması: Kaydet, Uygula, Aç ve Takip Edilmeyen Dosyalar, Test Edildi

Git stash, Git 2.56'da çalıştırdığımız komutlarla açıklandı: bir mesajla itin, izlenmeyen dosyalar, listele ve göster, pop vs. uygula, dizini koruma…

Makaleyi okuyun →
Yazılım testi

İkili Test Açıklandı: Tüm Çiftler 216 Testi Nasıl 13'e Düşürdü, Test Edildi

İkili test, Python 3.13'te çalıştırdığımız bir oluşturucuyla açıklandı: 13 testin kapsadığı 216 kombinasyondan oluşan bir kontrol, doğrulanmış kapsa…

Makaleyi okuyun →
Test otomasyonu

Test Çiftleri Açıklaması: Test Edilmiş Python Koduyla Sahte, Saplama, Casus, Sahte ve Sahte

Test çiftleri, pytest 9.2'de çalıştırılan bir Python örneğiyle açıklanmıştır: kukla, saplama, casus, sahte ve sahte, her birinin ne zaman kullanılac…

Makaleyi okuyun →
Veritabanları ve SQL

SQL COALESCE Açıklaması: Varsayılanlar, NULLIF, IFNULL vs ISNULL ve Tuzaklar, Test Edildi

SQL COALESCE, SQLite 3.50'de çalıştırdığımız sorgularla açıklandı: ilk boş olmayan değerler, boş dizeler, matematikte NULL, sıfıra bölme için NULLIF…

Makaleyi okuyun →
Veritabanları ve SQL

SQL Kendi Kendine Birleştirme Açıklaması: Çalışan-Yönetici, Çiftler ve Sıra Karşılaştırmaları, Test Edildi

SQL kendi kendine birleştirme, SQLite 3.50'de yürüttüğümüz sorgularla açıklanmıştır: çalışan ve yönetici, yöneticiden daha fazla kazanç, benzersiz ç…

Makaleyi okuyun →
Yazılım geliştirme

JavaScript Spread Operatörü Açıklaması: Spread vs Rest, Kopyalar ve Yakalamalar, Test Edildi

JavaScript yayılma operatörü, Düğüm 24'te çalıştırdığımız kodla açıklandı: diziler, nesneler, sığ kopyalar, dinlenme parametreleri, Math.max limiti …

Makaleyi okuyun →
Yazılım geliştirme

Python Koleksiyonları Modülünün Açıklaması: Counter, defaultdict, deque ve Daha Fazlası, Test Edildi

Python koleksiyonları, Python 3.13'te çalıştırdığımız kodla açıklanmıştır: Counter, defaultdict, deque, nametuple, OrderedDict ve ChainMap, artı bir…

Makaleyi okuyun →
Yapay zekâ

Yüksek Lisans Bağlam Penceresi Açıklandı: Tokenlar, Limitler ve Daha Fazlası Nasıl Sığdırılır, Ölçülmüştür

LLM bağlam penceresi, tiktoken kullanarak ölçtüğümüz jeton sayımlarıyla açıklandı: düz yazı, kod ve Hintçe için kelimeler ve jetonlar, giriş ve çıkı…

Makaleyi okuyun →
Yazılım geliştirme

Web Kancaları Açıklandı: Nasıl Çalışırlar ve Güvenli Bir Şekilde Nasıl Alınırlar?

Web kancaları, Python'da çalıştırdığımız bir alıcı ve göndericiyle açıkladı: push ve yoklama, HMAC-SHA256 imzaları, üzerinde oynanmış ve tekrar oyna…

Makaleyi okuyun →
DevOps

Git Cherry-Pick Açıklaması: İhtiyacınız Olan Taahhüdü Kopyalayın, Güvenle, Test Edildi

Git Cherry-Pick, Git 2.56'da çalıştırdığımız komutlarla açıkladı: bir düzeltmeyi bir yayın dalına kopyalamak, yeni karmalar ve yama kimlikleri, -x, …

Makaleyi okuyun →
Test otomasyonu

Anlık Görüntü Testinin Açıklaması: Nasıl Çalışır, Ne Zaman Yardımcı Olur ve Ne Zaman Acıtır

Anlık görüntü testi, yürüttüğümüz bir pytest ve şuruplu demo ile açıklandı: anlık görüntüler oluşturma, kod değişikliğinden sonra farkı okuma, zaman…

Makaleyi okuyun →
Yazılım testi

Mutasyon Testi Açıklandı: %100 Kapsam Neden Hala Hatamızı Gözden Kaçırdı

Mutasyon testi, oluşturduğumuz ve çalıştırdığımız küçük bir mutasyon aracıyla açıklandı: 14 mutant, %79 puan alan %100 çizgi kapsamına sahip bir tes…

Makaleyi okuyun →
Yapay zekâ

İstemi Enjeksiyonun Açıklaması: Yapay Zeka Uygulamaları Nasıl Kandırılıyor ve Bunları Nasıl Savunabilirsiniz?

Geliştiriciler için hızlı ekleme açıklandı: doğrudan ve dolaylı saldırılar, anahtar kelime filtrelerinin neden başarısız olduğu (testimiz 4'ten 1'in…

Makaleyi okuyun →
DevOps

Açıklanan DNS Kayıtları: Gerçek Aramalarla A, AAAA, CNAME, MX, TXT ve TTL

DNS kayıtları yaptığımız aramalarla açıklandı: çözünürlüğün nasıl çalıştığı, A ve AAAA, CNAME kuralları, MX ve boş MX, SPF ve doğrulama için TXT, NS…

Makaleyi okuyun →
DevOps

Özellik Bayraklarının Açıklaması: Güvenli Sürümler, Kademeli Kullanıma Sunmalar ve Bayrak Hijyeni

Çalıştırdığımız bir kullanıma sunma simülasyonuyla açıklanan özellik bayrakları: bayrak türleri, kararlı karma ile kullanıma sunma yüzdesi, kill ana…

Makaleyi okuyun →
Test otomasyonu

Python Faker ile Test Verisi Üretimi: Gerçekçi, Tekrarlanabilir ve Güvenli Veri

Python Faker ile veri oluşturmayı test edin, çalıştırın ve ölçün: tekrarlanabilir veriler, yerel ayarlar, benzersiz değerler, etki alanı şeklindeki …

Makaleyi okuyun →
Yazılım testi

Shift-Sol Testinin Açıklaması: Ekibi Yavaşlatmadan Hataları Daha Erken Bulun

Sola kaydırma testi açıklandı: ne anlama geliyor, erken kusurların neden daha ucuz olduğu, gereksinim incelemelerinden CI kontrollerine kadar uygula…

Makaleyi okuyun →
Veritabanları ve SQL

Açıklanan SQL Dizisi İşlevleri: TRIM, SUBSTR, REPLACE, CONCAT ve Veri Temizleme

Çalıştırdığımız sorgularla açıklanan SQL dize işlevleri: birleştirme ve NULL, TRIM, UPPER ve LOWER, SUBSTR ve INSTR, REPLACE, dolgulama, Unicode uzu…

Makaleyi okuyun →
Veritabanları ve SQL

SQL Tetikleyicilerinin Açıklaması: ÖNCE ve SONRA Tetikleyiciler, Denetim Günlükleri ve Tuzaklar

SQL tetikleyicileri, çalıştırdığımız tetikleyicilerle açıklandı: ÖNCE ve SONRA, ESKİ ve YENİ, denetim günlükleri, doğrulama, stok güncellemeleri, NE…

Makaleyi okuyun →
Yazılım geliştirme

Python JSON Modülünün Açıklaması: dökümler, yüklemeler, Özel Türler ve Yaygın Hatalar

Python JSON modülü çalıştırdığımız kodla açıkladı: dökümler ve yüklemeler, dosyalar, tür dönüşümleri, tarihler ve ondalık sayılar, özel kodlayıcılar…

Makaleyi okuyun →
Yazılım geliştirme

ES Modülleri ve CommonJS Karşılaştırması: Node.js'de JavaScript İçe Aktarmaları Nasıl Çalışır, Test Edildi

ES modülleri ve CommonJS karşılaştırması, Node.js'de çalıştırdığımız kodla açıklanmıştır: içe ve dışa aktarma sözdizimi, gereksinim, canlı bağlamala…

Makaleyi okuyun →
Yazılım geliştirme

Python Regex'in Açıklaması: Desenler, Gruplar, Öncüler ve Tuzaklar, Test Edildi

Python regex'i çalıştırdığımız kalıplarla açıklandı: arama vs eşleşme, tümünü bulma, gruplar ve adlandırılmış gruplar, açgözlü vs tembel, alt, önden…

Makaleyi okuyun →
Yapay zekâ

Yüksek Lisans Yapılandırılmış Çıktı Açıklaması: Yapay Zeka Modellerinden Güvenilir JSON Alma

LLM yapılandırılmış çıktısı, Pydantic'te çalıştırdığımız doğrulamayla açıklandı: JSON modu ve şemaları, kısıtlı kod çözme, model çıktısının kırılma …

Makaleyi okuyun →
DevOps

SSH Anahtarlarının Açıklaması: Nasıl Çalışırlar, ssh-keygen, Ed25519 ve Güvenli Alışkanlıklar

SSH anahtarları, oluşturduğumuz anahtarlarla açıklanmıştır: genel ve özel anahtarlar, ssh-keygen, Ed25519 ve RSA, parmak izleri, parolalar, ssh-agen…

Makaleyi okuyun →
DevOps

HTTP Önbelleğe Alma Açıklaması: Canlı Testle Önbellek Kontrolü, ETag ve 304 Yanıtları

HTTP önbelleğe alma, çalıştırdığımız küçük bir sunucuyla açıklandı: Önbellek Kontrolü yönergeleri, maksimum yaş, önbellek yok ve depo yok, ETag yeni…

Makaleyi okuyun →
Test otomasyonu

API Sözleşme Testi Açıklaması: Son Dakika Değişikliklerini Gönderilmeden Önce Yakalayın

API sözleşme testi, yürüttüğümüz bir şema kontrolüyle açıklandı: sözleşmenin ne olduğu, tüketici odaklı sözleşmeler, Pakt, OpenAPI, son tüketicileri…

Makaleyi okuyun →
Yazılım testi

Risk Tabanlı Test Açıklaması: Riskleri Puanlayın, Bir Matris Oluşturun ve Neyin Önemli Olduğunu Test Edin

Riske dayalı testler adım adım açıklanmıştır: risklerin belirlenmesi, olasılık ve etkinin puanlanması, bir risk matrisi oluşturulması, riskin test d…

Makaleyi okuyun →
Veritabanları ve SQL

Açıklanan SQL Kısıtlamaları: NULL DEĞİL, BENZERSİZ, KONTROL ve YABANCI ANAHTAR, Test Edildi

SQL kısıtlamaları yaptığımız testlerle açıklandı: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY ve FOREIGN KEY, NULL boşlukları, SQLite'ın yabancı anaht…

Makaleyi okuyun →
Veritabanları ve SQL

Açıklanan SQL Tarih İşlevleri: Tarihleri Hatasız Ekleme, Karşılaştırma ve Gruplandırma

Çalıştırdığımız sorgularla açıklanan SQL tarih işlevleri: aralık ekleme, ay sonu sürprizleri, tarih farklılıkları, BETWEEN tuzağı, güne göre gruplam…

Makaleyi okuyun →
Yazılım geliştirme

Python asyncio'nun Açıklaması: eşzamansız, bekleme, toplama ve Gerçek Zamanlamalı Görev Grubu

Python asyncio, zamanladığımız kodla açıkladı: eşyordamlar, bekleme, toplama, GörevGroup, hata işleme, zaman aşımları, eşzamanlılığın sınırlandırılm…

Makaleyi okuyun →
Yazılım geliştirme

JavaScript'te Debounce ve Throttle: Nasıl Çalışır, Her Biri Ne Zaman Kullanılır, Test Edildi

JavaScript'te geri çekilme ve kısma, Node.js'de ölçtüğümüz zamanlamalarla açıklanmıştır: her birinin nasıl çalıştığı, basit uygulamalar, öncü ve son…

Makaleyi okuyun →
Yazılım geliştirme

Python Bağlam Yöneticilerinin Açıklaması: with Statement, contextlib ve Gerçek Kullanımlar

Python içerik yöneticileri çalıştırdığımız kodla açıkladı: nasıl çalışır, __enter__ ve __exit__, contextlib.contextmanager, bastırma, ExitStack, ver…

Makaleyi okuyun →
Yapay zekâ

LLM Sıcaklığı ve En İyisi Açıklandı: Yapay Zeka Modelleri Bir Sonraki Sözcüğü Nasıl Seçiyor?

LLM sıcaklığı ve en yüksek puan, yürüttüğümüz bir simülasyonla açıklandı: olasılıklar nasıl yeniden şekillendirilir, en üst düzey neleri korur, göre…

Makaleyi okuyun →
DevOps

YAML Açıklandı: Sözdizimi, Norveç Sorunu ve Test Ettiğimiz Diğer Tuzaklar

YAML bir ayrıştırıcı testiyle açıklandı: temel sözdizimi, listeler ve haritalar, Norveç sorunu, değişkenlere dönüşen sürümler, sekizli posta kodları…

Makaleyi okuyun →
DevOps

Cron İşleri Açıklandı: Sözdizimi, Gerçek Programlar ve Bunları Bozan Hatalar

Cron işleri, doğruladığımız programlarla açıklandı: beş alan, operatörler, gerçek örnekler, ayın günü VEYA haftanın günü tuzağı, çevre sorunları, ka…

Makaleyi okuyun →
Yapay zekâ

Yapay Zeka Halüsinasyonları Açıklandı: Dil Modelleri Neden İşleri Düzeltiyor ve Nasıl Azaltılabilir?

Yapay zeka halüsinasyonları açıkladı: ne olduklarını, dil modellerinin bunları neden ürettiğini, yaygın türlerini, temellendirme ve yönlendirmelerle…

Makaleyi okuyun →
DevOps

Açıklanan Ortam Değişkenleri: .env Dosyaları, Sırlar ve Yapılandırma Doğru Yapıldı

Çalıştırdığımız Python örnekleriyle açıklanan ortam değişkenleri: bunları okumak ve ayarlamak, neden her değerin bir dize olduğu, .env dosyaları, sü…

Makaleyi okuyun →
Yazılım geliştirme

API Hız Sınırlamasının Açıklaması: Algoritmalar, Başlıklar ve 429 Hatalarının Ele Alınması

API hızı sınırlaması, çalıştırdığımız bir simülasyonla açıklanmıştır: belirteç kümesi, sabit pencere, kayan pencere, 429 yanıt, hız sınırı başlıklar…

Makaleyi okuyun →
Test otomasyonu

Python'da alay etme: Unittest.mock, patch ve Testleri Yalan Yapan Hatalar

Unittest.mock ile Python'da alay etme, test edildi: Sahte ve dönüş_değeri, yan_etki, bir adın kullanıldığı yerde yama uygulama, spesifikasyon ve oto…

Makaleyi okuyun →
Yazılım testi

Kod Kapsamının Açıklaması: Hat ve Şube Kapsamı ve %100'ün Gerçek Anlamı

Kod kapsamı gerçek bir kapsama.py çalışmasıyla açıklanmıştır: hat, şube ve durum kapsamı, bir raporun okunması, %100 kapsamın neden hâlâ hataları ka…

Makaleyi okuyun →
Veritabanları ve SQL

SQL'de DELETE vs TRUNCATE vs DROP: Farklılıklar, Geri Alma ve Her Biri Ne Zaman Kullanılmalı

DELETE vs TRUNCATE vs DROP test edilmiş SQL ile açıklandı: her birinin neyi kaldırdığı, geri aldığı, tetiklediği, kimlik sıfırlaması, hızı ve Postgr…

Makaleyi okuyun →
Veritabanları ve SQL

Açıklanan SQL Görünümleri: Örneklerle Tuzakları Oluşturun, Kullanın ve Önleyin

Çalıştırdığımız sorgularla açıklanan SQL görünümleri: görünüm oluşturma, canlı sonuçlar, sütunları gizleme, performans, güncellenebilir ve gerçekleş…

Makaleyi okuyun →
Yazılım geliştirme

TypeScript Arayüzü ve Tür: Gerçek Farklılıklar, Derleyiciyle Test Edildi

TypeScript arayüzü ve türü, gerçek derleyiciyle kontrol edildi: her ikisinin de yapabileceği, yalnızca birinin yapabileceği, bildirim birleştirme, g…

Makaleyi okuyun →
Yazılım geliştirme

Python *args ve **kwargs'ın Açıklaması: Açık Örneklerle Esnek Fonksiyonlar

Python *args ve **kwargs çalıştırdığımız kodla açıklanmıştır: paketleme ve paketten çıkarma, parametre sırası, yalnızca anahtar kelime ve yalnızca k…

Makaleyi okuyun →
Yazılım geliştirme

Python Lambda İşlevleri: Söz Dizimi, Gerçek Kullanımlar ve Ne Zaman Kullanılmaması Gerektiği

Çalıştırdığımız kodla açıklanan Python lambda işlevleri: sözdizimi, anahtarla sıralama, harita ve filtre, kapatmalar, geç bağlama tuzağı ve normal b…

Makaleyi okuyun →
Yapay zekâ

Yapay Zeka Ajanları Nelerdir? Çalıştırabileceğiniz Basit Bir Aracı Döngüsüyle Nasıl Çalışırlar?

Yapay zeka ajanları nedir? Aracı döngüsüne, araçlara, belleğe ve korkuluklara ilişkin basit bir kılavuz, çalıştırdığımız küçük bir Python döngüsü, g…

Makaleyi okuyun →
DevOps

İzleme ve Gözlemlenebilirlik: Günlükler, Metrikler ve İzlerle Gerçek Fark

İzleme ve gözlemlenebilirliğin açıklanması: bilinen ve bilinmeyen arızalar, günlükler, ölçümler ve izler, ödeme olayının gözden geçirilmesi, altın s…

Makaleyi okuyun →
DevOps

Docker Birimleri ve Bağlama Bağlantıları: Konteyner Verilerini Doğru Şekilde Kalıcılaştırın

Docker birimleri ile bağlama bağlamaları arasındaki karşılaştırma açıklandı: kapsayıcı verilerinin neden kaybolduğu, adlandırılmış birimler, bağlama…

Makaleyi okuyun →
Test otomasyonu

TDD ve BDD: Temel Farklılıklar, Her İki Şekilde Geliştirilmiş Bir Özellik ve Her Birinin Ne Zaman Kullanılacağı

TDD ve BDD, her iki yönde de oluşturulmuş bir indirim özelliğiyle açıklandı: çalıştırdığımız kodla kırmızı-yeşil-refactor, Verilen-Ne Zaman-O Zaman …

Makaleyi okuyun →
Yazılım testi

Kullanıcı Kabul Testi (UAT): Süreç, Kontrol Listesi ve Gerçek Örnekler

Kullanıcı kabul testi açıklandı: bunu kimin yürüttüğü, QA'dan farkı, yedi adımlı bir süreç, bir UAT test senaryosu şablonu, bir kontrol listesi, otu…

Makaleyi okuyun →
Veritabanları ve SQL

Açıklanan SQL NULL Değerleri: IS NULL, COALESCE, NULLIF ve Kaçınılması Gereken Tuzaklar

SQL NULL değerleri, çalıştırdığımız sorgularla açıklandı: üç değerli mantık, IS NULL, COALESCE, NULLIF, toplamaların, birleştirmelerin ve sıralamanı…

Makaleyi okuyun →
Veritabanları ve SQL

SQL CASE WHEN İfadesi: Sözdizimi, Gerçek Örnekler ve Yaygın Hatalar

SQL CASE WHEN çalıştırdığımız sorgularla açıkladı: basit ve aranmış formlar, koşul sırası, SUM'lu pivotlar, COUNT hileleri, özel sıralama, güncellem…

Makaleyi okuyun →
Yazılım geliştirme

JWT Nedir? JSON Web Belirteçleri Bir Çalışma Örneğiyle Açıklanıyor

JWT nedir? JSON Web Tokens açıkladı: üç bölüm, çalıştırdığımız kodda oluşturulan ve üzerinde değişiklik yapılan bir token, JWT ile oturumlar, depola…

Makaleyi okuyun →
Yazılım geliştirme

JavaScript Olay Döngüsü Açıklaması: Örneklerle Çağrı Yığını, Mikro Görevler ve Zamanlayıcılar

JavaScript olay döngüsü çalıştırdığımız kodla açıklandı: çağrı yığını, görev ve mikro görev kuyrukları, setTimeout 0'ın neden anında olmadığı, engel…

Makaleyi okuyun →
Yazılım geliştirme

Python Jeneratörleri ve Verim Açıklaması: Gerçek Örneklerle Bellekten Tasarruf Edin

Python üreteçleri ve verim, çalıştırdığımız kodla açıklandı: nasıl duraklatılır ve devam ettirilir, ölçülen bellek tasarrufları, işlem hatları, sons…

Makaleyi okuyun →
Yapay zekâ

Gömmeler Nelerdir? Vektörler ve Kosinüs Benzerliği Basitçe Açıklandı

Gömmeler nedir? Vektörler, kosinüs benzerliği ve anlamsal aramaya ilişkin sade dilli bir kılavuz; çalıştırdığımız küçük bir örnek, yaygın kullanımla…

Makaleyi okuyun →
DevOps

Mavi-Yeşil ve Kanarya Konuşlandırılması: Farklılıklar, Takaslar ve Nasıl Seçilir

Mavi-yeşil ve kanarya konuşlandırması açıklandı: her birinin nasıl çalıştığı, maliyet, risk ve geri alma, test ettiğimiz istikrarlı kullanıcı grubu,…

Makaleyi okuyun →
Test otomasyonu

Kesintili Testler: Bunların Sebepleri ve Nasıl Düzeltileceği

Yaptığımız demolarla açıklanan hatalı testler: ana nedenler, birinin nasıl doğrulanacağı ve teşhis edileceği, zamanlama için uygun düzeltmeler, payl…

Makaleyi okuyun →
Yazılım testi

Yük Testi ve Stres Testi: Farklılıklar, Metrikler ve k6 Örnekleri

Yük testi ve stres testinin açıklaması: her birinin neyi kanıtladığı, ani yükselme ve soğuma testleri, önemli ölçümler, ortalamaların neden yanıltıc…

Makaleyi okuyun →
Yazılım testi

Test Senaryosu ve Test Senaryosu: Temel Farklılıklar, Örnekler ve Her Biri Ne Zaman Kullanılmalı?

Test senaryosu ve test senaryosunun açıklaması: net tanımlar, yan yana tablo, senaryolardan vakalara, şablonlara ve her birinin ne zaman kullanılaca…

Makaleyi okuyun →
Veritabanları ve SQL

SQL Sorgu Optimizasyonu: Zamanlamalarla Yürütme Planlarını Okuyun ve Yavaş Sorguları Düzeltin

SQL sorgu optimizasyonu bir milyon satırda test edilmiştir: yürütme planlarını okuyun, doğru dizinleri ekleyin, değiştirilemeyen filtreleri düzeltin…

Makaleyi okuyun →
Veritabanları ve SQL

SQL UNION ve UNION ALL: Farklılıklar, Örnekler ve Test Edilmiş Performans

SQL UNION ve UNION ALL, yürüttüğümüz sorgularla açıklandı: kopyalar, her ikisinin de takip ettiği kurallar, gerçek bir veri hatası, ölçülen performa…

Makaleyi okuyun →
Yazılım geliştirme

JavaScript Fetch API Eğitimi: GET, POST, Hata İşleme ve Zaman Aşımları

Yerel bir sunucuya karşı test edilen bir JavaScript Fetch API öğreticisi: GET ve POST, 404'ün neden atmadığı, yeniden kullanılabilir bir yardımcı, s…

Makaleyi okuyun →
Yazılım geliştirme

Python Dosya İşleme: Örneklerle Okuma, Yazma, CSV, JSON ve pathlib

Python dosya işleme, çalıştırdığımız kodla açıklanmıştır: açık modlar, büyük dosyaları okuma, CSV, JSON, pathlib, ikili dosyalar, güvenli yazma, hat…

Makaleyi okuyun →
Yazılım geliştirme

Python Sınıfları ve Nesneleri: Gerçek Örneklerle OOP Eğitimi

Çalıştırdığımız kodla açıklanan Python sınıfları ve nesneleri: __init__, yöntemler, sınıf ve örnek nitelikleri, kalıtım, özellikler, dunder yöntemle…

Makaleyi okuyun →
Yapay zekâ

Büyük Dil Modeli Nedir? Yüksek Lisans'ların Nasıl Çalıştığı, Abartmadan Açıklanıyor

Büyük dil modeli nedir? LLM'ler sade bir dille açıklandı: belirteçler, yerleştirmeler, dikkat, eğitim, sıcaklık ve bağlam pencereleri, küçük bir son…

Makaleyi okuyun →
DevOps

Yeni Başlayanlar İçin Linux Komutları: Örneklerle Temel Terminal Kılavuzu

Yeni başlayanlar için göreve göre gruplandırılmış Linux komutları: pratik bir günlük analizi örneğiyle gezinme, dosyalar, günlükleri görüntüleme, gr…

Makaleyi okuyun →
Test otomasyonu

Selenyum ve Oyun Yazarı: Temel Farklılıklar, Karşılaştırılan Kod ve Hangisinin Seçileceği

Selenium ve Playwright karşılaştırması: mimari, bekleme, tarayıcı ve dil desteği, hata ayıklama, her iki araçta da aynı test, geçiş tavsiyesi ve nas…

Makaleyi okuyun →
Yazılım testi

Eşdeğerlik Bölümleme: Test Tasarımı Tekniğinin Çalışılmış Örneklerle Açıklanması

Eşdeğerlik bölümlemenin açıklaması: geçerli ve geçersiz bölümlerin nasıl bulunacağı, yaşlara yönelik çalışılmış örnekler, şifreler ve kuponlar, yürü…

Makaleyi okuyun →
Yazılım testi

Yazılım Testinde Şiddet ve Öncelik: Farklılıklar, Matris ve Gerçek Örnekler

Yazılım testinde önem ve önceliğin açıklanması: net tanımlar, örnekler içeren dört yönlü bir matris, seviye ölçekleri, her birini kimin belirlediği …

Makaleyi okuyun →
Veritabanları ve SQL

SQL Alt Sorguları Eğitimi: Türler, İlişkili Alt Sorgular ve Örneklerle EXISTS

Çalıştırdığımız sorguları içeren bir SQL alt sorgu eğitimi: skaler, IN, FROM ve SELECT alt sorguları, ilişkili alt sorgular, EXISTS, NOT IN NULL tuz…

Makaleyi okuyun →
Veritabanları ve SQL

SQL İşlemleri ve ACID Açıklaması: COMMIT, ROLLBACK ve İzolasyon Seviyeleri

SQL işlemleri ve ACID, yürüttüğümüz bir banka transferiyle açıklandı: COMMIT, ROLLBACK, kayıt noktaları, kilitler, izolasyon seviyeleri, kirli okuma…

Makaleyi okuyun →
Yazılım geliştirme

Git Komutları Hile Sayfası: Gerçekte Kullandığınız Komutlar, Örneklerle

Git komutları göreve göre gruplandırılmış kısa bilgiler sayfası: kurulum, aşamalandırma, dallar, uzaktan kumandalar, saklama, geçmiş ve gerçek bir d…

Makaleyi okuyun →
Yazılım geliştirme

JavaScript Vaatlerinin Açıklaması: ardından, catch, Promise.all ve Yaygın Hatalar

Çalıştırdığımız kodla açıklanan JavaScript vaatleri: durumlar, ardından ve yakalama zincirleri, hata yönetimi, Promise.all, allSettled, yarış ve her…

Makaleyi okuyun →
Yazılım geliştirme

Python Sözlüğü Eğitimi: Yöntemler, Örnekler ve Ortak Kalıplar

Çalıştırdığımız kodları içeren bir Python sözlüğü eğitimi: dikteler oluşturma, okuma ve güncelleme, temel yöntemler, birleştirme, kavramalar, sayma …

Makaleyi okuyun →
Yapay zekâ

RAG Nedir? Geri Almayla Artırılmış Üretim Bir Çalışma Örneğiyle Açıklanıyor

RAG nedir? Almayla artırılmış oluşturma adım adım açıklanmıştır: indeksleme, parçalama, yerleştirmeler, alma, çalışan küçük bir Python örneği, değer…

Makaleyi okuyun →
DevOps

Yeni Başlayanlar İçin Terraform Eğitimi: İlk Dosyadan Modüllere Kod Olarak Altyapı

Yeni başlayanlar için bir Terraform eğitimi: Bulut hesabı olmadan başlayın, başlatmayı öğrenin, planlayın ve uygulayın, ardından değişkenler, çıktıl…

Makaleyi okuyun →
DevOps

Docker ve Kubernetes: Temel Farklılıklar, Birlikte Nasıl Çalıştıkları ve İhtiyacınız Olanlar

Docker ve Kubernetes şöyle açıkladı: Her birinin ne yaptığı, her ikisinde de aynı uygulamanın çalıştırılması, Docker Compose ve Swarm'ın karşılaştır…

Makaleyi okuyun →
Test otomasyonu

Yeni Başlayanlar İçin Pytest Eğitimi: Fikstürler, Parametrelendirme ve Gerçek Örnekler

Yeni başlayanlar için pytest 9.2'de yürüttüğümüz testleri içeren bir pytest öğreticisi: iddialar, fikstürler, parametrelendirme, yarışma, işaretleyi…

Makaleyi okuyun →
Yazılım testi

Yazılım Test Yaşam Döngüsü (STLC): 6 Aşama, Giriş ve Çıkış Kriterleri, Örnek

Yazılım testi yaşam döngüsü şunları açıkladı: giriş ve çıkış kriterleri, teslimatlar, çalışılmış bir oturum açma özelliği örneği, Agile'da STLC ve S…

Makaleyi okuyun →
Yazılım geliştirme

Git merge vs rebase: farklar, örnekler ve hangisi ne zaman kullanılır

Git merge vs rebase; gerçek log çıktısı, karşılaştırma tablosu, rebase'in altın kuralı ve güvenli bir ekip iş akışıyla anlatılıyor.

Makaleyi okuyun →
Yazılım geliştirme

Python Liste Üreteci (List Comprehension): Sözdizimi, Örnekler ve Kaçınılacak Durumlar

Python list comprehension anlatımı: sözdizimi, filtreleme, if-else, iç içe döngüler, ölçülmüş süreler ve düz for döngüsünün daha iyi olduğu durumlar.

Makaleyi okuyun →
Veritabanları ve SQL

SQL JOIN Örneklerle Açıklama (Inner, Left, Right, Full)

SQL JOIN'leri örnek tablolar ve sorgularla adım adım öğrenin: INNER, LEFT, RIGHT, FULL, CROSS ve SELF; yaygın hatalar ve performans ipuçları.

Makaleyi okuyun →