CLI referansı

Her komut, seçenek ve ortam değişkeni; ne yaptığı, varsayılanı ve bir örnekle. Kısa sürüm için td --help çalıştırın.

td affected [options]              Print the projects and tests a change affects
td test [options] [-- <args>]      Run only the tests a change affects
td record [options] [-- <args>]    Run all tests with coverage and store the map
td audit [options] [-- <args>]     Break your code on purpose and check the selection
td --version                       Print the version (include it in a bug report)

Tüm analizler için seçenekler

Bunlar affected, test, record ve audit ile çalışır; audit her zaman HEAD ile karşılaştırır, bu yüzden --base onda geçerli değildir.

--base <ref>

Karşılaştırılacak git ref'i. TestDetta çalışma ağacınızı HEAD ile bu ref'in merge base'iyle karşılaştırır; böylece siz branch'i ayırdıktan sonra base branch'e gelen commit'ler sizin değişiklikleriniz sayılmaz. Varsayılan: origin/main.

td test --base origin/develop
td affected --base HEAD~3      # the last three commits and anything uncommitted

--repo <path>

Analiz edilecek, depo içindeki herhangi bir yol. Varsayılan: geçerli dizin.

td affected --repo ../shop

-v, --verbose ve --log-level <level>

Loglar stderr'e gider, böylece stdout makine tarafından okunabilir kalır. -v her kararı açıklayan debug loglarını açar: bir projenin neden etkilendiğini, bir test sınıfının hangi üyeyi çalıştırdığını, bir izlemenin hangi ismi takip ettiğini. --log-level şunlardan birini seçer: trace, debug, information, warning (varsayılan), error, critical ya da none; trace ham git çıktısını da ekler.

td affected -v 2> testdetta-debug.log
td test --log-level information

--color <when> ve --theme <name>

Metin çıktısı tablolar halinde düzenlenir ve birinin okuduğu yerde renklenir: terminalde ve GitHub Actions logunda. auto (varsayılan) dosyaları ve pipe'ları renksiz bırakır, NO_COLOR ve FORCE_COLOR'a uyar; always ve never kesin karar verir. --format json hiçbir zaman renklenmez. --theme ile default, colorblind (yeşil ve kırmızı yerine mavi ve sarı) ya da mono (yalnız kalın ve soluk) seçilir; TESTDETTA_THEME her koşu için ayarlar.

td test --theme colorblind
td affected --color never > affected.txt

--max-map-age <n>

Merge base'in kendisinde harita yoksa, merge base'den en fazla n first-parent commit önce kaydedilmiş bir kapsam haritası kullanır. Aradaki değişiklikler köprülenir: haritadan bu yana değişmiş ve sizin değişikliğinize ulaşabilen herhangi bir üyeyi çalıştırmış sınıflar da seçilir. 0 yalnızca merge base'de kaydedilmiş bir haritayı kullanır. Varsayılan: 50. Bkz. Nasıl karar verir.

td test --max-map-age 20

--drift-fallback <all|name>

Daha eski bir haritadan bu yana yapılan değişiklikler üyelerle ifade edilemeyen bir şey içerdiğinde (bir derleme dosyası, yapılandırma, bir global using) ne yapılacağı. all (varsayılan) etkilenen test projelerini tamamen çalıştırır; name isimlere göre karar verir; bu daha hızlıdır ama yapılandırma ya da reflection ile bağlanan çağrıları göremez.

td test --drift-fallback name

--non-code-files <readers|project>

Bir proje klasöründe kod olmayan değişen bir dosyanın neyi çalıştıracağı; örneğin README.md, CHANGELOG.md ya da bir JSON dosyası. readers (varsayılan), derleme dosyayı derlemiyor, gömmüyor, kopyalamıyor ve bir araca vermiyorsa yalnızca kapsam haritasının onu okuduğunu gördüğü test sınıflarını çalıştırır; derlemenin kullandığı bir dosya ve haritası testlerinin okuduğu her dosyaya kefil olamayan bir test projesi yine tamamen çalışır. project, dosya ne olursa olsun dosyanın projesini ve ona bağlı her projeyi tamamen çalıştırır. Varsayılanın neye dayandığını Neler her şeyi çalıştırır sayfası anlatır.

td test --non-code-files project

--not-build-inputs <patterns>

Derlemenizin kullanmadığı kod olmayan dosyalar; depoya göre göreli, ; ile ayrılmış desenler olarak verilir ve seçenek birden çok kez kullanılabilir. Doküman dosyaları (README, CHANGELOG, LICENSE, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT, CLAUDE.md, AGENTS.md ve benzerleri) gibi, bunlar da yalnızca MSBuild onları derliyor, gömüyor ya da kopyalıyorsa veya MSBuild dosyalarınızdaki bir target adlarını açıkça yazıyorsa derleme girdisi sayılır; bir öğe deseninin onları içerebilmesi yetmez. Birini okuyan bir test yine çalışır ve çıktı bu kurala giren değişmiş dosyaları listeler. Kuralı Neler her şeyi çalıştırır sayfası anlatır.

td test --not-build-inputs "docs/**;samples/**/*.json"

--maps-dir <dir>

Kapsam haritalarını depo dışında, commit başına bir klasör olarak tutar. record haritaları <dir>/<commit>/ altına kaydeder; affected ve test ise --max-map-age sınırı içindeki en yenisini geri yükler. GitHub Actions dışındaki CI sistemlerinde, paylaşılan bir disk ya da senkronize edilen nesne depolamayla kullanın. Varsayılan: haritalar depoda .testdetta/coverage içinde durur.

td record --maps-dir /srv/testdetta-maps/shop
td test --base origin/main --maps-dir /srv/testdetta-maps/shop

td affected

Testleri çalıştırmadan, bir değişikliğin neleri etkilediğini ve nedenini yazdırır. Proje dosyalarını MSBuild'in değerlendirmesiyle okur ve yalnızca --build ile derler.

--format <text|json|paths|commands>

BiçimÇıktıKullanım amacı
text (varsayılan)Gerekçeleriyle etkilenen projeler, ardından test planıOkumak
jsonHer proje ve test sınıfı; kararı, kanıtı ve süre tahminiyleScript'ler, dashboard'lar
pathsHer satırda etkilenen bir test .csproj dosyasıBaşka bir araca girdi vermek
commandsHer test projesi için filtresiyle birlikte bir dotnet test komutuTestleri kendi yönteminizle çalıştırmak
td affected --format json > plan.json
td affected --format paths | xargs -n1 dotnet build

--tests-only

Aradaki üretim projelerini değil, yalnızca etkilenen test projelerini listeler.

--build

Bir değişiklik depodaki bir source generator'a ulaştığında, onu kullanan test projelerini derler ve ürettiği kodu kapsam haritalarıyla karşılaştırır; td test bunu her zaman yapar. Bu seçenek olmadan kaynaklardan daha yeni bir derleme varsa o okunur; yoksa bu test projeleri tamamen çalışacak olarak listelenir.

td test

Yalnızca etkilenen testleri derler ve çalıştırır: yalnızca bazı sınıflar etkilendiğinde test projesi başına bir filtreyle, hepsi etkilendiğinde ya da bir değişiklik daraltılamadığında projenin tamamını, hiçbiri etkilenmediğinde hiçbir şey. Herhangi bir test başarısız olduğunda çıkış kodu 3'tür. Bir değişiklik depodaki bir source generator'a ulaştığında, onu kullanan test projeleri önce derlenir ve yalnızca değişen üretilmiş kod sayılır; derleme başarısız olursa komut derleyicinin hatalarıyla burada durur.

--dry-run

dotnet test komutlarını çalıştırmak yerine yazdırır. global.json dosyası bir alt klasörde bulunan bir proje (cd src && dotnet test ...) şeklinde yazdırılır.

--summary-file <path>

Bir Markdown özeti ekler: her projenin sonucu, hangi sınıfların çalıştığı ve nedeni, hangilerinin atlandığı ve kazanılan kayıtlı test süresi. GitHub Actions'ta bunu $GITHUB_STEP_SUMMARY'ye yönlendirin; action bunu sizin için yapar. Bir örneğe bakın.

td test --summary-file "$GITHUB_STEP_SUMMARY"

--shadow

Shadow mode: TestDetta'yı hiçbir testi atlamadan denemek için. TestDetta'nın kendisi bu modda hiçbir ağ çağrısı yapmaz ve hiçbir şey gönderilmez. Derlemeleriniz paketleri her zaman olduğu gibi restore eder; base commit üzerindeki yeniden çalıştırma da o commit'in paketlerini her derleme gibi restore eder. Kendi -- argümanlarınızın çalıştırdığı her test çalışır ve çıkış kodu bu çalıştırmanınkidir. Argümanlar bir solution (.sln, .slnx, .slnf), tek bir proje, bir dizin ya da hiçbir şey (çalışma dizinindeki tek solution ya da proje) belirtiyorsa, TestDetta tam olarak o tek dotnet test komutunu çalışma dizininizde çalıştırır ve yalnızca proje başına bir test raporu ekler: VSTest altında, kendiniz bir TRX logger belirtmediyseniz --logger trx, ya da testing platform'un rapor seçeneği. Sonuç dizininiz, logger'larınız ve çalıştırmanızın yazdığı dosyalar olduğu gibi kalır: TestDetta raporları düştükleri yerde okur ve kopyalar; yalnızca kendisinin istediği raporları (kendi TRX logger'ınızı ya da rapor seçeneğinizi belirtmediğinizde) okuduktan sonra siler. Aksi halde, örneğin çalıştırılacak tek bir solution yoksa ya da iki test projesi aynı adlı assembly'ler derliyorsa, komutunuzun çalıştırdığı her test projesi aynı dizinden, sırayla tek başına çalışır ve rapor nedenini söyler. Komutunuzun hangi test projelerini çalıştırdığı anlaşılamadığında, komutun dizini altındaki her test projesi çalışır ve rapor bunu da söyler.

TestDetta testler çalışmadan önce başarısız olursa komutunuz onsuz, verildiği gibi çalışır; sonrasında başarısız olursa çıkış kodu yine bu çalıştırmanınkidir; her iki durumda da rapor neden shadow sonucu olmadığını söyler. Ardından TestDetta çalıştırmayı test test, seçeceği testlerle karşılaştırır ve dışarıda bırakacağı her başarısız sınıfı yeniden çalıştırır: önce değişiklikle tek başına; tek başına geçerse, tam çalıştırmadaki gibi projesinin diğer sınıflarıyla birlikte (orada geçmesi onu kararsız yapar; yine düşmesi sıraya bağlı yapar); sonra aynı şekilde, ayrı bir checkout'ta base commit üzerinde. Değişiklikle düşen her test orada da düşüyorsa değişiklik onu bozmamıştır; biri orada geçiyorsa bu bir kaçırmadır. Yeniden çalıştırılamayan sınıf, kontrol edilene kadar kaçırma sayılır. Yeniden çalıştırmalar raporlarını yalnızca TestDetta'nın kendi geçici klasörüne yazar ve işi uzatabilir, en fazla sınıflandırma bütçesi kadar. Ctrl+C ya da iptal edilen bir job testleri durdurur, o klasörü ve base checkout'unu siler.

Tam çalıştırma bitmeden seçim hakkında hiçbir şey gösterilmez, böylece önce testlerinizin çıktısı gelir. Ardından rapor her kararı içerir: bu işte çalışan sınıflar seçimle karşılaştırılır, filtrenizin dışarıda bıraktığı bir sınıf kararıyla birlikte listelenir ama karşılaştırılmaz ve toplamlar karşılaştırılan sınıfları sayar. Rapor önce sonucu, tüm çalıştırmanın ölçülen süresiyle birlikte verir; sonra çalıştırmanın nasıl yapıldığını, her sınıfın kararını ve sonucunu, proje başına ölçülen süreyi seçimin çalıştıracağı kısımla yan yana ve sonucu yeniden üretmek için gerekenleri verir: TestDetta sürümü ve SHA-256'sı, commit'ler, kapsam haritaları ve özetleri, aynı td test --shadow komutu.

Sınırlar: raporlar depo altında ve sonuç dizininizde aranır, bu yüzden run settings'te depo dışına ayarlanmış bir sonuç dizini okunmaz. Base checkout'u depo dışındaki geçici bir klasörde bulunur, bu yüzden depo kökünün üstündeki dosyalar (bir üst klasördeki Directory.Build.props, global.json ya da NuGet.config) orada görülmez; base üzerindeki yeniden çalıştırması derlenemeyen bir sınıf sınıflandırılmamış olarak raporlanır. Testing platform üzerindeki bir test projesi rapor seçeneğini derleme çıktısına göre alır (bilmediği bir seçenek çalıştırmasını başarısız kılar, bu yüzden paket referanslarından hiçbir seçenek tahmin edilmez): çalıştırmadan önce derlenmemişse rapor olmadan çalışır ve rapor onu "no test report: the project was not built before the run" ile belirtir, bu yüzden başarısızlıkları karşılaştırılamaz. Önce derleyin ve aşağıdaki gibi --no-build verin.

dotnet build MySolution.sln -c Release
td test --shadow --summary-file "$GITHUB_STEP_SUMMARY" -- MySolution.sln -c Release --no-build

--shadow-no-classify

Seçimin dışarıda bıraktığı başarısız sınıfları yeniden çalıştırmaz. Bunlar o zaman sınıflandırılmamış olarak raporlanır.

--shadow-report <path>

JSON raporun yazılacağı yer. Varsayılan: depoda .testdetta/testdetta-shadow.json.

--shadow-analysis-timeout <time>

TestDetta'nın testlerden önceki analizinin en fazla ne kadar sürebileceği. Varsayılan: 10m. Bu süre aşılınca analiz durdurulur, her test yine çalışır ve rapor neden shadow sonucu olmadığını söyler.

--shadow-rerun-timeout <time>, --shadow-rerun-idle-timeout <time>

Değişiklikle yapılan bir yeniden çalıştırmanın en fazla ne kadar sürebileceği ve süreçlerinin, takılmış sayılıp durdurulmadan önce ne kadar süre neredeyse hiç CPU kullanmadan kalabileceği. Varsayılanlar: 15m ve 5m. Durdurulan bir yeniden çalıştırmanın sınıfları sınıflandırılmamış olarak raporlanır.

--shadow-base-timeout <time>, --shadow-base-idle-timeout <time>

Aynısı, base commit üzerindeki yeniden çalıştırma için; o, kendi checkout'unda önce restore ve derleme yapar. Varsayılanlar: 30m ve 10m; boşta kalma sınırı daha uzundur, çünkü restore, CPU neredeyse dururken ağı bekler.

--shadow-classify-budget <time>

Sınıflandırmanın tamamının en fazla ne kadar sürebileceği: tüm yeniden çalıştırmalar ve base checkout'u birlikte. Varsayılan: 45m. Süren bir yeniden çalıştırma bütçenin bittiği yerde durdurulur ve o zamana kadar sınıflandırılmamış başarısızlıklar, nedeniyle birlikte sınıflandırılmamış olarak raporlanır. Tam çalıştırma ve çıkış kodu bundan asla etkilenmez. Rapor, kullanılan sınırları ve bütçenin ne kadarının harcandığını gösterir.

Bir <time> değeri 90s, 15m, 1h ya da 1h30m biçimindedir, en fazla 168h; düz bir sayı dakika demektir; 0 ya da none sınır yok demektir. GitHub Action'da aynı adlı girdiler (shadow-analysis-timeout, shadow-rerun-timeout, shadow-classify-budget vb.) bunları ayarlar.

td test --shadow --shadow-classify-budget 20m --shadow-base-timeout none

-- <dotnet test arguments>

-- sonrasındaki her şey her dotnet test çağrısına iletilir. Kendi --filter filtreniz korunur: TestDetta onu kendi sınıf filtresiyle birleştirir, yalnızca seçilen testlerden filtrenize uyanlar çalışır. xUnit v3 trait, method ve namespace filtreleri seçimi aynı şekilde daraltır. Çalıştırıcının sınıf filtresiyle birleştiremediği bir filtre (xUnit v3 class veya query filtresi, TUnit tree-node filtresi) verilirse proje filtrenizle birlikte tamamen çalışır. Shadow mode'da bunlar sizin kendi test komutunuzdur; bkz. --shadow.

-f <tfm> verildiğinde koşu yalnızca o framework'ün derlemelerini yükler. Değişen proje ve onunla test projeleriniz arasındaki her proje o framework'ü hedefliyorsa, yalnızca başka framework'ler için derlenen bir değişiklik (o derlemelerin dışarıda bıraktığı bir #if altındaki kod) hiçbir test seçtirmez.

td test -- -c Release --logger trx
td test -- --no-restore
td test -- --filter "Category!=Integration"

td record

Tüm testleri kapsam ölçümüyle çalıştırır ve her test projesi için .testdetta/coverage (ya da --maps-dir) altına bir harita yazar. Bunu varsayılan branch'inizde çalıştırın; bu aynı zamanda o branch'in tam test koşusudur. Testler başarısız olduğunda çıkış kodu 3'tür; haritalar yine de yazılır ve başarısız sınıflar, projeleri etkilendiğinde her seferinde çalışır.

-c, --configuration <name>

Derleme yapılandırması. Varsayılan: Debug.

-f, --framework <tfm>

Birden fazla framework hedefleyen bir test projesinde kaydedilecek hedef framework. Varsayılan: projenin bu makinede çalışabilen ilk hedef framework'ü (.NET Framework yalnız Windows'ta).

td record -f net10.0

--project <path>

Yalnızca bu test projesini kaydeder; yol depo köküne görelidir. Birden fazla proje için tekrarlayın. CI'da çalışamayan projeleri, örneğin veritabanı gerektiren entegrasyon testlerini, dışarıda bırakın; bunlar için isimlere göre karar verilir.

td record --project tests/Shop.Tests/Shop.Tests.csproj --project tests/Api.Tests/Api.Tests.csproj

-- <args>

Kendi dotnet test argümanlarınız, yani test işinizin kullandıkları: kayıt, bunların filtresi ve run settings dosyasıyla, kendi ekledikleriyle birleştirilerek koşar; diğer seçenekleriniz olduğu gibi geçer. Proje dosyalarınızda tanımlı bir filtre ve run settings de korunur. Bkz. Test yapılandırmanız.

td record -- --filter "Category!=Integration" --settings ci.runsettings

--parallel <n>

Daha hızlı kayıt için her projenin test sınıflarını n test sürecine dağıtır. Her süreç testlerini yine birer birer çalıştırır. Test paketinizin aynı anda birden fazla test sürecini kaldırabilmesi gerekir (sabit port ya da paylaşılan dosya olmamalı). Varsayılan: 1.

--no-build

Yeniden derlemek yerine aynı yapılandırmayla yapılmış önceki bir derlemenin çıktısını kaydeder.

dotnet build -c Release
td record -c Release --no-build

td audit

TestDetta'nın seçimini kendi kodunuzda, bizim açık kaynak depolarda test ettiğimiz yöntemle test eder. Kodunuzun üyelerini IL mutantlarıyla birer birer bozar (bir metot hata fırlatır, varsayılan bir değer döndürür, diğer dala gider ya da bir alan başka bir değerle başlar), değişikliği yükleyebilen her test projesini eksiksiz çalıştırır ve TestDetta'nın o değişiklik için kapsam haritalarınızdan, tam olarak td test gibi yaptığı seçimin başarısız olan her test sınıfını içerdiğini denetler. Her şüphe TestDetta'nın aleyhine sayılır: seçimin dışarıda bıraktığı bir sınıf, kaçırma sayılmadan önce değişiklikle tek başına ve değişiklik olmadan tek başına yeniden çalıştırılır; seçimin çalıştırdığı bir sınıf da ancak aynı iki çalıştırmadan sonra yakalanmış sayılır. Değişiklikle çöken ya da takılan bir test çalıştırması değişiklik olmadan yeniden çalıştırılır: seçimin dışarıda bıraktığı kısım yalnızca değişiklik olmadan tamamlanıyorsa ve değişiklikle tekrarlandığında yine çöküyor ya da takılıyorsa bu bir kaçırmadır (tekrarlanmayan bir çökmede değişiklik için karar verilemez); seçimin çalıştırdığı kısımdaki bir çökme ancak tekrarlandığında yakalanmış sayılır. TestDetta'nın kendisi hiçbir ağ çağrısı yapmaz; kopyada başlattığı derlemeler ve test çalıştırmaları paketleri sizinkiler gibi restore eder.

Kaynak kodunuza ve derleme çıktınıza hiçbir zaman yazılmaz. TestDetta çalışma ağacını bir çalışma klasörüne kopyalar (dosya sistemi destekliyorsa copy-on-write klon olarak), derlemeyi ve testleri orada yapar ve sonunda klasörü siler; Ctrl+C, bir zaman aşımı ya da bir hatadan sonra da. Öldürülen bir çalıştırmanın bıraktığı klasörü bir sonraki çalıştırma siler. Orada herhangi bir şey derlenmeden önce MSBuild'e her projenin nereye yazdığını sorar ve bunun herhangi bir kısmı kopyanın dışındaysa (örneğin mutlak bir çıktı yolu) başlamaz. Her değişiklik HEAD ile karşılaştırıldığı için çalışma ağacında commit edilmemiş değişiklik olmamalıdır; denetim sürerken depo başka bir commit'e geçerse ya da değişiklik alırsa, bir hatayla durur. Kendi filtresi bir sınıf filtresiyle birleştirilemeyen bir test projesi (bir xUnit v3 sınıf ya da sorgu filtresi, bir TUnit tree-node filtresi) denetlenmez ve rapor nedenini söyler; tam MSBuild gerektiren projeler (eski, SDK olmayan projeler) ve kopyada derlenmeyen, test raporu yazmayan ya da değişiklik olmadan yapılan çalıştırmada tamamlanmayan projeler de denetlenmez. Source generator ya da analyzer olarak kullanılan projelerin üyeleri örneğe alınmaz ve rapor bunları sayar. Testing platform projeleri o çalıştırmadan önce kopyada derlenir; bunu bütçe karşılar. Üyeler, üye ve tohum değerinin özetinden gelen sabit bir sırayla, tüm üyeler arasında eşit şekilde alınır: bir haritanın bir üyeyi bir testin çalıştırdığını söyleyip söylememesi seçimde hiçbir rol oynamaz.

Sonuç, kaçırma oranının yukarı yuvarlanmış %95 üst sınırını ve dayandığı değişiklik sayısını verir; ardından çalıştırmalarının karar veremediği (inconclusive) ya da bir iptal veya hatanın yarıda kestiği (stopped) değişiklikleri ve bunların her biri kaçırma olsaydı sınırın ne olacağını:

On your code: 112 changes, 103 broke tests, 0 missed (95% upper bound 2.9%, n = 103); 2 inconclusive, 0 stopped (worst case, counting them as misses: 95% upper bound 5.9%, n = 105); target of 100 reached.
graduation evidence: no: worst case 5.9% > 3.0% because 2 inconclusive and 0 stopped are counted as misses

İkinci satır, çalıştırmanın shadow mode'dan çıkışın (graduation) istediği kanıt olup olmadığını söyler: testleri bozan en az 100 değişiklik, hiç kaçırma yok ve gösterildiği haliyle en kötü durum sınırı en fazla %3,0. Değilse, çalıştırmanın karşılamadığı her koşulu belirtir ("not yet: 87 changes broke tests, 100 needed", "no: 1 missed"). --member ile yapılan bir çalıştırma hiçbir zaman sayılmaz ve --target-broken ölçütü değiştirmez.

Rapor (.testdetta/testdetta-audit.json ve --summary-file ile job summary) her değişikliği ve sonucunu listeler. Bir kaçırma için sınıfı, onu dışarıda bırakan karar zincirini (TestDetta'nın neyin değiştiğini gördüğünü, test projesi ve sınıf için nasıl ve neden karar verildiğini, haritanın commit'ini), aynı kararı görmek için elle yapılacak düzenlemeyi ve o değişikliği tek başına tekrarlayan komutu verir. Bir kaçırma olduğunda çıkış kodu 3'tür.

td audit --summary-file "$GITHUB_STEP_SUMMARY" -- -c Release

--target-broken <n>

n değişiklik testleri bozduğunda durur. Varsayılan: 100; hiç kaçırma ve hiç inconclusive ya da stopped değişiklik yoksa bu, %95 üst sınırını gösterildiği haliyle %3,0'a indirir (%2,95, yukarı yuvarlanmış).

--max-mutants <n>

n değişiklik testleri çalıştırdıktan sonra durur. Varsayılan: sınır yok.

--budget <time>

Bu süre geçtikten sonra yeni bir değişikliğe başlamaz. O sırada hâlâ çalışan bir değişiklik kendi zaman sınırları içinde tamamlanır ve sayılır; bu yüzden denetim o değişiklik kadar, --parallel ile her worker başına bir değişiklik kadar uzun sürebilir; bir değişiklik birkaç çalıştırma yapar ve her birine projesinin değişiklik olmadan yapılan çalıştırmasının beş katına kadar süre tanınır: onu yarıda durdurmak en yavaş değişiklikleri, en sık da kaçırmaları sonuçtan atardı. Bütçeden sonra bittiğinde rapor ne kadar aştığını ve hangi değişikliklerin devam ettiğini söyler; bir CI işinin zaman sınırının altında bu payı bırakın. Shadow sınırlarıyla aynı <time> sözdizimi. Varsayılan: 4h.

--parallel <n>

Aynı anda test edilen değişiklik sayısı; her biri çalışma ağacının kendi kopyasında. Her biri test host'ları çalıştırır, bu yüzden bellek kullanımı n ile artar. Varsayılan: 1.

--seed <n>, --kinds <list>, --member <Type.Member>

Sıranın tohum değeri (varsayılan 1); değişiklik türleri: throw, return-default, flip-branch, field-value ya da all (varsayılan); ve bir rapordaki değişikliği tekrarlamak için bozduğu üye (birkaçı için seçeneği tekrarlayın).

--report <path>, --work-dir <dir>

JSON raporunun nereye yazılacağı (varsayılan: .testdetta/testdetta-audit.json) ve kopyayı içeren çalışma klasörünün nereye konacağı (varsayılan: /tmp, Windows'ta geçici klasör). Kopyanın klon olabilmesi için çalışma klasörünü deponun bulunduğu diskte tutun.

td audit --target-broken 150 --budget 6h --work-dir "$RUNNER_TEMP"

Ortam değişkenleri

DeğişkenNe yapar
TESTDETTA_THEMEHer çalıştırma için renk teması: default, colorblind ya da mono. --theme önceliklidir. Bkz. --theme.
NO_COLOR--color auto ile herhangi bir değer rengi kapatır.
FORCE_COLOR--color auto ile 0 dışındaki her değer, çıktı bir dosyaya ya da pipe'a gitse de rengi açar; 0 kapatır. NO_COLOR ondan önce gelir.
TESTDETTA_MSBUILDLegacy (SDK olmayan) projeleri derleyecek tam MSBuild çalıştırılabilir dosyası; TestDetta'nın kendi bulduğunun yerine başka birini kullanmak istediğinizde. Bkz. Uyumluluk.

Önceki sürümlerin lisans değişkenleri (TESTDETTA_LICENSE, TESTDETTA_LICENSE_FILE, TESTDETTA_LICENSE_SCOPE, TESTDETTA_LICENSE_REFRESH) yok sayılır; bkz. Lisans.

Çıkış kodları

KodAnlamı
0Başarılı; "test gerekmiyor" durumu dahil.
1Analiz başarısız oldu: git, dosya sistemi ya da bir proje dosyası; record için ayrıca hiçbir test projesi kaydedilemediğinde; audit için ayrıca çalışamadığında ya da iptal edildiğinde; test --shadow için testler çalışmadan önce iptal edildiğinde.
2Geçersiz komut satırı.
3Testler başarısız oldu (test, test --shadow'un tam çalıştırması ve record); bir kaçırma (audit).