Neler her şeyi çalıştırır
Değişikliklerin çoğu birkaç test sınıfı seçer. Bazıları güvenli bir şekilde daraltılamaz; bu yüzden TestDetta bir test projesinin tamamını ya da bir klasörün altındaki her projeyi çalıştırır. Bu sayfa hepsini listeler; böylece geniş bir seçim asla sürpriz olmaz.
Derlemenin geneline etki eden dosyalar
Bu dosyalar altlarındaki her projenin nasıl derlendiğini değiştirir. Bunlardan birindeki değişiklik, bulunduğu klasördeki ve altındaki her test projesini çalıştırır:
| Dosya | Çalıştırdığı |
|---|---|
Directory.Build.props, Directory.Build.targets, Directory.Build.rsp | Altındaki her test projesi |
Directory.Solution.props, Directory.Solution.targets | Altındaki her test projesi |
global.json, NuGet.config, .editorconfig | Altındaki her test projesi |
Directory.Packages.props, yalnızca PackageVersion öğeleri değiştiyse | Yalnızca değişen bir paketi referans alan test projeleri ve onlara bağımlı olanlar |
Kapsam haritası olmayan, taşınabilir PDB olmadan derlenen ya da birden fazla framework'ünden yalnızca biri için -f ile kaydedilmişken testleri başka bir framework ya da hepsi için koşan bir test projesi için değişen bir source generator (testleri aynı -f ile koşturun ya da onsuz kaydedin) | Ürettiği kod bir derlemeden karşılaştırılır; burada karşılaştırılacak bir şey yoktur. Diğer durumlarda yalnızca değişen üretilmiş kod sayılır. |
ReferenceOutputAssembly="false" ile başvurulan ve değişen bir proje; ona başvuran projenin derlemesi çıktısını derlediği koda dönüştürüyorsa ya da test projesinin haritası onu hangi testlerin başlattığını veya yüklediğini kaydetmiyorsa (örneğin harita çıktının, hiçbir teste yazamadığı bir kod tarafından, mesela üçüncü taraf bir eklenti yükleyicisi tarafından yüklendiğini gördüyse), ya da test projesi birden çok framework hedefliyor ve haritası testlerin koştuğu framework'lerden yalnız birinin derlemesini tutuyorsa (-f ile kaydedilmiş; onsuz kaydedin ya da testleri aynı -f ile koşturun) | Aksi halde yalnız harita kaydedilirken onu süreç olarak başlatan ya da yükleyen test sınıfları çalışır; yalnız derleme sırası için verilmiş bir başvuru hiçbir şey çalıştırmaz. |
Bir test projesinin tamamını çalıştıran değişiklikler
| Değişiklik | Neden daraltılamaz |
|---|---|
Proje dosyası ya da onun import ettiği bir .props veya .targets dosyası | Projedeki herhangi bir şeyin nasıl derlendiğini değiştirebilir. |
Projede C#, Visual Basic ya da F# kaynak kodu olmayan ve derlemenin kullandığı bir dosya, örneğin kopyalanan bir appsettings.json, bir .resx, bir .proto ya da bir F# imza dosyası (.fsi). --non-code-files project ile projede kod olmayan herhangi bir dosya | Derlemenin ürettiğini değiştirir. Derlemenin kullanmadığı dosyalar yalnızca okuyucularını çalıştırır (aşağıda). |
Bir global using ya da bir assembly attribute'u | Her dosyaya uygulanır. |
| Hiçbir bildirimin kapsamadığı koddaki bir C# değişikliği, örneğin bir önişlemci koşulunun altında | İzlenecek bir üye yoktur. |
| Hiçbir yerde adı geçmeyen, ancak bir framework'ün reflection ile keşfedebileceği değişmiş bir tip (controller'lar, mesaj handler'ları, EF yapılandırmaları) | İsimler ve kapsam verisi onu kimin bulduğunu söyleyemez. Tip, test projenizin doğrudan başvurduğu ve çalışma anında yüklediği bir projedeyse (bir eklenti), yalnız o projenin çıktısını yükleyen test sınıfları çalışır: başvuru ReferenceOutputAssembly="false" ile verilmişse ya da normal bir başvuruysa ve projenin dışındaki hiçbir kod onun tiplerinden birinin adını anmıyorsa (yalnız derleme kopyalasın diye başvurulan bir eklenti). Kapsam haritaları cevap verebildiğinde de proje tamamen çalışmaz: imzasını, attribute'larını ve varsayılan değerlerini koruyan bir metot ya da constructor gövdesi değişikliğinde veya tipe yalnızca kodu üzerinden ulaşan bir değişiklikte, bunun yerine haritaların tipin herhangi bir üyesini çalıştırırken gördüğü sınıflar çalışır. Bu, tipin altındaki haritası olan etkilenmiş her test projesi tipi kaydetmişse ve üyelerinden hiçbiri bir testin dışında, bir static constructor'da ya da önbellek dolduran bir çağrıda çalışmamışsa ve üçüncü taraf bir kütüphane tarafından geri çağrılmamışsa geçerlidir. |
| Ürettiği şey karşılaştırılamadığında (yukarıdaki tabloya bakın), analyzer ya da source generator olarak kullanılan bir proje | Etkisi çağrılar üzerinde değil, derleme üzerindedir. |
Bunların her biri, etkilenen projeye bağımlı her test projesini de çalıştırır.
Projede derlemenin kullanmadığı dosyalar
Bir README.md, bir CHANGELOG.md ya da testlerin kaynak ağacından okuduğu bir veri dosyası hiçbir derleme çıktısını değiştirmez. Varsayılan --non-code-files readers ile böyle bir dosyadaki değişiklik, herhangi bir test projesinde yalnızca kapsam haritası kaydedilirken onu okuyan test sınıflarını çalıştırır; herhangi bir testin dışında, bir fixture kurulumunda ya da testlerin paylaştığı bir şey başlatılırken yapılan bir okuma o test projesini tamamen çalıştırır, kaydedilen hiçbir testin okumadığı bir dosya ise hiçbir şey çalıştırmaz. MSBuild dosyayı CopyToOutputDirectory olmayan bir None öğesi olarak listeliyorsa, hiçbir derleme öğe türü (Compile, EmbeddedResource, Content, AdditionalFiles, Protobuf, Razor, Avalonia, TypeScript, WPF, MAUI, Android ve Apple öğeleri) onu listelemiyorsa, dosya bir app.config ya da web.config değilse, Razor SDK kullanan bir projede .css, .js, .mjs, .scss ya da .less ile biten bir None öğesi de değilse (SDK'nın derlediği kapsamlı stiller ve JavaScript modülleri) ve deponun hiçbir MSBuild dosyası onu yorumlar ve paket meta verisi dışında anmıyor, başka türde bir öğeye katmıyor ya da her None öğesini gezen bir target içermiyorsa, dosya derlemenin kullanmadığı bir dosya sayılır.
Okumalar kendi kodunuzda ve testlerinizin kullandığı kütüphanelerde kaydedilir; örneğin .verified dosyalarını okuyan bir snapshot kütüphanesinde. Bir test projesi, haritası yoksa, haritası TestDetta kütüphanelerin okumalarını kaydetmeden önce kaydedildiyse ya da bir kütüphane okumalarını gösterecek şekilde yeniden yazılamadıysa (çıktı onu adıyla belirtir) böyle bir dosya için yine tamamen çalışır.
MSBuild dosyalarınız, bir target'ın bir dosyayla doldurabileceği öğe desenleri için de taranır. Doküman dosyaları (README, CHANGELOG, LICENSE, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT, CLAUDE.md, AGENTS.md ve benzerleri) ve --not-build-inputs ile (action girdisi not-build-inputs) verdiğiniz dosyalar bu tahmine girmez: yalnızca MSBuild onları derliyor, gömüyor ya da kopyalıyorsa veya MSBuild dosyalarınızdaki bir target adlarını yazıyorsa derleme girdisi sayılır. İmzalama ve paketleme target'larında olduğu gibi öğeleri başka öğelerden ya da yalnız bir property'den üreten target'lar aksi halde her changelog girdisinin her test projesini çalıştırmasına yol açardı. Çıktı, bu kurala giren değişmiş dosyaları listeler.
Bunun göremedikleri: yerel (native) kodun, .NET olmayan bir programın ya da kaydedilen listenin dışındaki bir .NET API'sinin (ZipFile.OpenRead, bir yoldan oluşturulan X509Certificate2) okuduğu dosyalar; ve bir SDK'nın ya da paketin, yukarıdaki listede olmayan kendi öğe türü altındaki dosyaları işleyen bir derleme adımı; ya da bir doküman dosyasını adını yazmadan bir desenle alan bir target. Derlemeniz ya da testleriniz dosyaları bu şekilde kullanıyorsa --non-code-files project seçin (action girdisi non-code-files: project): kod olmayan her dosya, eskisi gibi projesini ve ona bağlı projeleri çalıştırır.
Kapsam haritası durumları
- Daha eski bir harita ve aradaki derleme değişiklikleri. Harita merge base'inizden birkaç commit daha eskiyse ve aradaki süreçte bir derleme ya da yapılandırma dosyası değiştiyse, etkilenen test projeleri tamamen çalışır.
--drift-fallback nameise bunlar için isimlere göre karar verir. Bkz. drift bridge. - Her sınıf seçildi. Tüm sınıfları seçilen bir proje filtresiz çalışır.
- Hiçbir şeyle eşleşmeyen bir filtre. Proje filtresiz olarak yeniden çalışır ve TestDetta bunu kendi hatası olarak ele alır.
Hiç harita olmaması her şeyi çalıştırmaz: seçim isimle izlemeye geri döner; bu, kapsam verisinden daha geniştir ama yine de dardır.
Hiçbir projeye ait olmayan dosyalar
Hiçbir proje klasörünün içinde olmayan değişmiş bir dosya, örneğin README.md, .github/ altındaki dosyalar ya da depo kökündeki test verileri, hiçbir projeye ait değildir. Kapsam haritası kaydedilirken bir test onu bir yol ile okuduysa, o dosyadaki bir değişiklik ya da bir testin listelediği bir klasöre eklenen yeni bir dosya, onu okuyan test sınıflarını çalıştırır. Herhangi bir testin dışında, bir fixture'ın kurulumunda ya da testlerin paylaştığı bir şey hazırlanırken yapılan bir okuma test projesinin tamamını çalıştırır. Kaydedilen hiçbir testin okumadığı bir dosya hiçbir şey seçmez. Çıktı bu dosyaları kaydedilen testlerin okuduğu ve hiçbir testin okumadığı diye sayar.
Okumalar kendi kodunuzda ve testlerinizin kullandığı kütüphanelerde kaydedilir ve yalnızca okumaları kaydeden bir sürümle kaydedilmiş kapsam haritalarında bulunur. TestDetta'nın göremediği bir şekilde okunan bir dosyayı (yerel kod, .NET olmayan bir program) en güvenli yol <None Include="..\..\testdata\**" CopyToOutputDirectory="PreserveNewest" /> gibi test projesinin bir öğesi olarak listelemektir. Böylece dosya nerede olursa olsun projeye ait olur; değiştirilmesi ya da silinmesi projeyi çalıştırır.
Bir istisna: hiçbir projenin sahiplenmediği bir kaynak ya da derleme dosyası (.cs, .fs, .vb, .props, .targets, .projitems), import'ları tam olarak çözümlenemeyen her projenin derleme girdisi sayılır; dolayısıyla o projeler çalışır.