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.
- 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:
- 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.
- Anlaşma dosyası: bu beklentiler bir JSON sözleşmesi, yani “anlaşma” olarak kaydedilir.
- Paylaş: anlaşma bir Pact Broker veya PactFlow’da yayınlanır.
- 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.
- 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
- Bir çift seçin: entegrasyonu en sık bozulan veya en önemli olan tüketici ve sağlayıcı.
- İki veya üç temel etkileşim için tüketicinin beklentilerini yazın ve yalnızca okuduğu alanları belirtin.
- 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.
- Her iki tarafı da CI’ya ekleyin, böylece her iki takım da anlaşmayı ihlal ettiğini dakikalar içinde öğrenir.
- 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
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.
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.
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ştirmeAPI 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 →DevOpsGit 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 otomasyonuTest Ç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 SQLSQL 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 SQLSQL 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ştirmeJavaScript 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ştirmePython 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ştirmeWeb 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 →DevOpsGit 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 otomasyonuAnlı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 testiMutasyon 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 →DevOpsAçı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 otomasyonuPython 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 testiShift-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 SQLAçı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 SQLSQL 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ştirmePython 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ştirmeES 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ştirmePython 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 →DevOpsSSH 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 →DevOpsHTTP Ö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 otomasyonuAPI 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 testiRisk 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 SQLAçı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 SQLAçı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ştirmePython 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ştirmeJavaScript'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ştirmePython 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 →DevOpsYAML 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 →DevOpsCron İş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 →DevOpsAçı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ştirmeAPI 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 otomasyonuPython'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 testiKod 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 SQLSQL'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 SQLAçı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ştirmeTypeScript 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ştirmePython *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ştirmePython 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 →DevOpsDocker 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 otomasyonuTDD 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 testiKullanı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 SQLAçı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 SQLSQL 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ştirmeJWT 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ştirmeJavaScript 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ştirmePython 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 →DevOpsMavi-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 otomasyonuKesintili 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 testiYü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 testiTest 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 SQLSQL 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 SQLSQL 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ştirmeJavaScript 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ştirmePython 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ştirmePython 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 →DevOpsYeni 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 otomasyonuSelenyum 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 testiEş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 testiYazı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 SQLSQL 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 SQLSQL İş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ştirmeGit 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ştirmeJavaScript 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ştirmePython 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 →DevOpsYeni 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 →DevOpsDocker 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 otomasyonuYeni 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 testiYazı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ştirmeGit 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ştirmePython 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 SQLSQL 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 →