Nasıl karar verir
TestDetta seçimi adım adım ve yalnızca kanıtı olan yerlerde daraltır. İzleyemediğini bildiği her şeyde daha fazlasını çalıştırmaya geri döner; hiç göremediği birkaç kalıp Sınırlamalar altında listelenir.
Daha fazlasını seç, asla daha azını değil
Kaçırılan bir test bir hatadır; fazladan bir test yalnızca CI süresine mal olur. Aşağıdaki her kural bundan çıkar. Analiz, bir değişikliğin bir projeyi ya da sınıfı etkileyip etkilemediğinden emin olamadığında onu etkilenmiş sayar ve gerekçe çıktıda görünür.
Beş adım
1. Projeler
Değişen dosyalar ait oldukları projelere eşlenir ve ProjectReference'lar üzerinden onlara bağımlı her projeye kadar izlenir. Directory.Build.props, global.json ve .editorconfig gibi derlemenin geneline etki eden dosyalar altlarındaki her projeyi etkiler.
2. Semboller
C#, Visual Basic ve F# dosyalarında eski ve yeni söz dizimi ağaçları karşılaştırılır. Yorum ve boşluk değişiklikleri hiçbir şey seçmez; diğer durumlarda TestDetta hangi tiplerin ve üyelerin değiştiğini bilir.
3. Kapsam
td record çalıştıktan sonra, base commit'te kaydedilmiş ve hangi test sınıfının hangi metodu çalıştırdığını gösteren bir harita, değişen metotlar, property'ler ve constructor'lar için test sınıflarını doğrudan verir. Değişen bir alan ya da property başlatıcısı, derlendiği constructor'ın değişikliği sayılır. Bir projenin assembly'sini kendi yolundan yükleyen test sınıfı, örneğin bütün bildirimleri yansımayla okuyan bir public API karşılaştırma testi, o proje her değiştiğinde çalışır.
4. İsimler
Yeni kod, alanlar ve sabitler gibi kapsam verisinin göremediği şeyler, test sınıflarına ya da kapsam haritasının bildiği koda ulaşana kadar kaynak kodda isimleriyle izlenir.
5. Geri dönüşler
Bir değişiklik izlenemediğinde test projesinin tamamı çalışır:
- bir projede C#, Visual Basic ya da F# kaynağı olmayan (bir F# imza dosyası da bunlardan sayılır) ve derlemenin kullandığı dosyalar, örneğin kopyalanan bir
appsettings.json,.csprojya da bir.resx; derlemenin kullanmadığı bir dosya, örneğin birREADME.md, yalnızca onu okuyan test sınıflarını çalıştırır (ayrıntılar); - global using'ler ve assembly attribute'ları;
- bir framework'ün reflection ile keşfettiği tipler, örneğin controller'lar, mesaj handler'ları ve EF yapılandırmaları.
Filtre öz denetimi
TestDetta, seçilen bir projeyi test sınıfları üzerinde bir filtreyle çalıştırır. Hiçbir testle eşleşmeyen bir filtre TestDetta içinde bir hata olarak ele alınır: proje filtresiz olarak yeniden çalıştırılır.
Kapsam haritaları
td record tüm testleri kapsam ölçümüyle çalıştırır ve her test projesi için bir harita yazar. Haritaları en iyisi branch'inizin merge base'inde kaydetmektir; CI'da ise varsayılan branch'teki her commit için bir harita kaydedersiniz.
Eski haritalar ve drift bridge
Merge base'den en fazla 50 commit önce kaydedilmiş bir harita yine kullanılır (--max-map-age, varsayılan 50; 0 yalnızca merge base'de kaydedilmiş bir haritayı kullanır). Aradaki kod değişiklikleri haritanın bilmediği çağrılar oluşturmuş olabilir; bu yüzden TestDetta, o zamandan beri değişmiş ve sizin değişikliğinize ulaşabilen herhangi bir üyeyi çalıştırmış sınıfları da seçer ve yeni kodu isimle izler.
Aradaki bir şey üyelerle ifade edilemediğinde, örneğin bir derleme dosyası ya da appsettings.json, etkilenen test projeleri tamamen çalışır. --drift-fallback name ise bunun yerine, harita yokmuş gibi isimlere göre karar verir: daha hızlıdır, ancak yapılandırma ya da reflection ile bağlanan çağrıları göremez.
Harita olmadan
Kurulumdan sonraki ilk pull request'ler ya da çok geride kalanlar, erişilebilir mesafede bir harita bulamaz. TestDetta bu durumda yalnızca isimlere göre seçer; bu güvenlidir ama daha fazlasını seçer ve bunu logunda belirtir. td record varsayılan branch'te çalıştıktan sonra seçim isabetli hale gelir.
Bir harita, branch'inizin başladığı bir commit'te kaydedilmiş olmalıdır: branch'in kendi commit'lerinden birinde kaydedilen harita merge base'in atası değildir ve kullanılmaz. Daha eski bir biçimdeki haritalar, örneğin TestDetta 0.1.x'in kaydettikleri, varsayılan branch yeniden kaydedene kadar "record the maps again" uyarısıyla yok sayılır; bkz. Sınırlamalar.
Nedenini görmek
td affected ve td test --dry-run, etkilenen her test projesini filtreli mi, tamamen mi yoksa hiç mi çalışacağının gerekçesiyle birlikte yazdırır; td affected --format json her test sınıfı için verilen kararı da ekler. -v her kararı stderr'e yazar; örneğin bir projenin neden etkilendiğini ya da bir sınıfın hangi değişikliği çalıştırdığını.
$ td test --dry-run --base origin/main
TestDetta 0.5.2 · 1 changed file · 2 affected test projects
Tests to run
┌──────────────────┬──────────┬─────────┬───────┬──────────────────────────────────────────────────────────┐
│ Test project │ Run │ Classes │ Saved │ Why │
├──────────────────┼──────────┼─────────┼───────┼──────────────────────────────────────────────────────────┤
│ tests/Shop.Tests │ filtered │ 3 / 41 │ - │ 3 of 41 test class(es) run or reference the changed code │
│ tests/Api.Tests │ skipped │ 0 / 12 │ - │ no test class runs or references the changed code │
└──────────────────┴──────────┴─────────┴───────┴──────────────────────────────────────────────────────────┘
tests/Shop.Tests → 3 classes
Shop.Tests.CartTests
Shop.Tests.CheckoutTests
Shop.Tests.OrderTests