možnosti příkazu Te.exe

Usage

<te.exe> test_binaries [/appendWttLogging] [/breakOnCreate] [/breakOnError] [/breakOnInvoke] [/coloredConsoleOutput] [ /console:flushWrites] [/console:position=[x,y | current] [/console:size=<x,y>] [ /console:topmost ][/defaultAppDomain] [/disableConsoleLogging] [/disableTimeouts] [/disableTimeouts] [/dpiaware ] [/enableWttLogging] [/inproc] [/isolationLevel] [/labMode] [/list] [/list] [/listProperties] [/logFile:<name>] [/logOutput:<mode>] [/miniDumpOnCrash] [/miniDumpOnError] [/name:<testname>] [/outputFolder:<folderName>] [/p:<ParamName>=<ParamValue>] [/parallel] [/persistPictResults] [/pict:<OptionName>=<OptionValue>] [/rebootStateFile] [/reportLoadingIssue] [/runas:<RunAsType>] [/ runIgnoredTests] [/runon:<MachineName>] [/screenCaptureOnError] [/select:<query>] [/sessionTimeout:<value>] [/stackFrameCount:<value>] [/stackTraceOnError] [/terminateOnFirstFailure] [/testDependencies:<files>] [/testmode:Loop] [/testmode:Stress] [/testTimeout:<value>] [ /unicodeOutput:<true/false>] [/version] [/wttDeviceString:<value>] [/wttDeviceStringSuffix:<value>]

Příkazy pro výběr/spuštění

test_binaries

Zadejte jeden nebo více testovacích souborů, které se mají spustit (oddělené mezerami). Zástupné znaky jsou podporovány.

te.exe test1.dll

Interpretace: Spusťte všechny testy v test1.dll.

te.exe test1.dll test2.dll test3.dll

Interpretace: Spusťte všechny testy v test1.dll, test2.dll a test3.dll.

te.exe *.dll

Interpretace: Spusťte všechny testy ve všech knihovnách DLL v aktuálním adresáři.

/coloredConsoleOutput:<true/false>

Určuje, jestli má taEF vypíše barevný text konzoly. Výchozí hodnota je true. Pokud je nastavená hodnota false, funkce TAEF vypíše veškerý text s výchozí barvou konzoly.

te.exe test1.dll /coloredConsoleOutput:false

/console:<optionName>=<value>

Poskytuje možnosti konfigurace používání konzoly TE. K dispozici jsou následující možnosti:

/console:flushWrites

Způsobí vyprázdnění výstupu konzoly po napsání každého řádku – užitečné při přesměrování výstupu TE.exe.

/console:position=[x,y | current ]

Nastaví pozici (v pixelech) okna konzoly vzhledem k rohu primárního monitoru. Pomocí hodnoty aktuální zadejte, že aktuální pozice konzoly by měla být uložena a použita při obnovení z restartování.

/console:size=[ <x,y> | current ]

Nastaví velikost okna konzoly (v rozměrech znaků). Velikost vyrovnávací paměti obrazovky se v případě potřeby zvětší tak, aby odpovídala velikosti okna. Pomocí hodnoty aktuální zadejte, že aktuální velikost konzoly by měla být uložena a použita při obnovení z restartování.

/console:topmost

Udržuje konzolu spuštěnou te.exe "nejvíce" v pořadí vykreslování plochy po dobu trvání provádění.

/dpiaware

Provádí testy v procesu označeném jako DPI, viz Vysoká DPI. Můžete ho také nastavit prostřednictvím metadat (DpiAware).

/inproc

Proveďte všechny testy v rámci samotného procesu TE.exe, nikoli v TE.ProcessHost.exe.

te.exe test1.dll /inproc

Note

TE podporuje spouštění pouze jedné testovací knihovny DLL najednou při použití nastavení /inproc .

/isolationLevel:<Level>

Určuje minimální úroveň izolace, která se má použít při provádění testů TAEF. Pokud je tato hodnota v konfliktu s hodnotou IsolationLevel zadanou jako metadata, stane se hodnota úrovní izolace s nejtěsnějším oborem. Další podrobnosti najdete v tématu Izolace testů .

te.exe test1.dll /isolationLevel:Class

/labMode

Provede testy a odebere potenciální blokující uživatelské rozhraní (například dialogy zasílání zpráv o chybách systému Windows při chybových testech).

/list

Uvádí názvy všech test_binaries a tříd a metod v nich. Pokud je zadána kritéria výběru, zobrazí se pouze názvy těch, které splňují daná kritéria.

 te.exe test1.dll test2.dll /list

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example1
  WEX::UnitTests::Test1::Example2
  WEX::UnitTests::Test1::Example3

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example1
  WEX::UnitTests::Test2::Example2
  WEX::UnitTests::Test2::Example3

 te.exe test1.dll test2.dll /select:@name='*Example2*' /list

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example2

 WEX: :UnitTests::Test2
  WEX::UnitTests::Test2::Example2

/listProperties

Uvádí názvy a vlastnosti všech test_binaries a tříd a metod v nich spolu s názvy funkcí Setup a Teardown, pokud jsou k dispozici. Pokud je zadána kritéria výběru, zobrazí se pouze názvy těch, které splňují daná kritéria.

 te.exe test1.dll test2.dll /listProperties

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example1
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = MTA
  WEX::UnitTests::Test1::Example2
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA
  WEX::UnitTests::Test1::Example3
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example1
   Property[ThreadingModel] = MTA
  WEX::UnitTests::Test2::Example2
   Property[ThreadingModel] = STA
  WEX::UnitTests::Test2::Example3
   Property[ThreadingModel] = MTA

 te.exe test1.dll test2.dll /select:@name='*Example2*' /listProperties

 WEX::UnitTests::Test1
  WEX::UnitTests::Test1::Example2
   Setup: Test1Setup
   Teardown: Test1Teardown
   Property[ThreadingModel] = STA

 WEX::UnitTests::Test2
  WEX::UnitTests::Test2::Example2
   Property[ThreadingModel] = STA

/name:<testname>

Výběr založený na názvu testu je jednoduchou alternativou k příkazu /select:@Name='<testname>'. Název <testu> může stále obsahovat zástupné znaky (*a?), ale nesmí být obsaženy v jednoduchých uvozovkách. Pokud jsou v příkazovém řádku zadány parametry /select a /name, má přednost dotaz /select a parametr /name bude ignorován.

te.exe test1.dll /name:*TestToLower

Interpretace: Spusťte všechny testy v test1.dll, kde názvy metod končí na TestToLower. Totéž lze reprezentovat pomocí kritérií výběru jako /select:@Name='*TestToLower'.

te.exe test1.dll /name:*StringTest*

Interpretace: Spusťte všechny testy v test1.dll, které obsahují frázi StringTest v jejich oboru názvů, třídě nebo názvu metody.

/outputFolder:<folderName>

Určuje složku, do které se umístí všechny vygenerované soubory. Výchozí hodnota je aktuální adresář. Můžete použít proměnné prostředí, například:

te.exe test1.dll /outputFolder:%TEMP%\\MyOutput

/p:<ParamName>=<ParamValue>

Definuje parametr modulu runtime s parametrem name=ParamName a hodnotou parametru=ParamValue. Tyto parametry jsou přístupné z testovací metody nebo metod nastavení/čištění.

te.exe test1.dll /p:x=5 /p:myParm=cool

X můžete v testovacím kódu získat jako jeden z několika podporovaných typů. Tady můžete například vidět, jak ho načítáte jako int, tak jako WEX::Common::String:

                int x = 0;
                String xString;
                RuntimeParameters::TryGetValue(L"x", x);
                RuntimeParameters::TryGetValue(L"x", xString);

Další informace najdete na webu TAEF. Stránka nápovědy k parametrům modulu runtime

/parallel

Provádí testy paralelně napříč několika procesory. Testy se musí přihlásit k paralelnímu spouštění tím, že se označí metadaty "Parallel".

te.exe test1.dll /parallel

Další informace najdete na stránce paralelní nápovědy .

/persistPictResults

Ukládá výsledky vygenerované PICT.exe pro testy pomocí ZDROJE DAT PICT v aktuálním spuštění. Následné spuštění testu se pokusí využít výsledky uložené v mezipaměti, jako je spuštění PICT.exe proti stejnému modelu a počátečním souborům.

/pict:<OptionName>=<OptionValue>

Poskytuje možnosti pro řízení PICT.exe, když je volána pro testy pomocí PICT DataSource. Nastavení jedné z těchto možností v současné době přepíše všechna přidružená metadata v kódu. K dispozici jsou následující možnosti:

/Pict:Order=3
Nastaví pořadí kombinací předáním hodnoty pomocí parametru příkazu /o pro PICT.exe.

/Pict:ValueSeparator=;
Nastaví oddělovač hodnot předáním hodnoty prostřednictvím parametru příkazu /d pro PICT.exe.

/Pict:AliasSeparator=+
Nastaví oddělovač aliasů předáním hodnoty prostřednictvím parametru /a příkazu pro PICT.exe.

Pict:NegativeValuePrefix=!
Nastaví předponu záporné hodnoty předáním hodnoty prostřednictvím parametru příkazu /n pro PICT.exe.

/Pict:SeedingFile=test.seed
Nastaví cestu k počátečnímu souboru předáním hodnoty prostřednictvím parametru příkazu /e pro PICT.exe.

/Pict:Random=true
Zapne nebo vypne náhodnost ve výsledcích PICT a vytvoří ze zdroje dat PICT protokol náhodné počáteční hodnoty, která byla použita.

/Pict:RandomSeed=33
Nastaví náhodné počáteční hodnoty předáním hodnoty prostřednictvím parametru příkazu /r pro PICT.exe. Nastavením se zapne pict:Random, pokud není explicitně nastavená hodnota Pict:Random.

/Pict:CaseSensitive=true
Pokud je nastavená hodnota true, zapne citlivost písmen předáním možnosti příkazu /c do PICT.exe.

/Pict:Timeout=00:01:30
Nastaví dobu čekání na dokončení PICT.exe před ukončením procesu. Hodnota je ve formátu [Den.]Hour[:Minute[:Second[. ZlomekSeconds]].

/runas:<RunAsType>

Provede testy v zadaném prostředí. Podrobné informace o využití najdete v dokumentaci ke službě RunAs .

te.exe *.dll /runas:System

Interpretace: Spusťte všechny testy jako systém.

te.exe *.dll /runas:zvýšené oprávnění

Interpretace: Spusťte všechny testy jako uživatele se zvýšenými oprávněními.

te.exe *.dll /runas:Restricted

Interpretace: Spusťte všechny testy jako uživatele se zvýšenými oprávněními.

te.exe *.dll /runas:LowIL

Interpretace: Spusťte všechny testy v procesu nízké integrity.

/runIgnoredTests

Provede nebo zobrazí seznamy (pokud je ve spojení s parametrem /list nebo /listProperties) všechny testy, včetně tříd testů a testovacích metod s metadaty Ignorovat nastavenou na hodnotu true. Ve výchozím nastavení se testovací třídy a testovací metody s metadaty "Ignore" nastavenou na "true" během provádění a při výpisu přeskočí.

/runon:<MachineName>

Provádí testy vzdáleně na zadaném počítači. TaEF ověřuje, autorizuje a nasazuje potřebné binární soubory ke spuštění testů a protokoluje všechny informace zpět do původní konzoly. Podrobné informace o využití najdete v dokumentaci k provedení křížového testu počítače .

te.exe *.dll /runon:TestMachine1

Interpretace: Spusťte všechny testy vzdáleně na testMachine1.

/select:<query>

Kritéria výběru, která se mají použít při výběru testů z každého testovacího binárního souboru. Výběrová kritéria se skládají z jedné nebo několika z následujících:

@[název vlastnosti] = [hodnota jako řetězec]

@[název vlastnosti] >= [hodnota jako float nebo celé číslo]

@[název vlastnosti] > [hodnota jako float nebo celé číslo]

@[název vlastnosti] <= [hodnota jako float nebo celé číslo]

@[název vlastnosti] < [hodnota jako float nebo celé číslo]

• Hodnoty vlastností jako řetězce musí být v jednoduchých uvozovkách.
• Složená kritéria výběru můžete zadat pomocí "and", "or" a "not" (nerozlišují se malá a velká písmena).
• Hodnoty řetězců vlastností podporují zástupné znaky prostřednictvím znaků "*" a "?".
• U hodnot typu float a integer lze znak "*" použít také jako "existuje", ale nelze ho použít pro částečné porovnávání. Například: /select:"@Priority=*" je platný, ale /select:"@Priority=4*" není.

te.exe test1.dll /select:"(@Name='*TestToLower' nebo @Owner='C2') a ne(@Priority < 3)"

Interpretace: Spusťte všechny testy v test1.dll, kde názvy metod končí na TestToLower nebo kde je vlastník C2; a kde priorita není menší než 3.

te.exe test1.dll test2.dll /select:@Priority=\*

Interpretace: Spusťte všechny testy v test1.dll a test2.dll, kde byla v metadatech testu zadána priorita.

te.exe test1.dll /select:@Name='*StringTest*'

Interpretace: Spusťte všechny testy v test1.dll, které obsahují frázi StringTest v jejich oboru názvů, třídě nebo názvu metody.

/sessionTimeout:<value>

Nastaví časový limit relace pro celé provádění Te.exe. Pokud vyprší časový limit, testovací relace se řádně přeruší a ukončovací kód procesu značí, že došlo k vypršení časového limitu.

Note

Hodnota časového limitu musí být zadána v následujícím formátu:

[Day.]Hour[:Minute[:Second[.FractionalSeconds]]]

Note

Pokud běží pod WTT, můžete tuto hodnotu použít k zajištění, že soubor protokolu Wtt zůstane nedotčený, i když vyprší časový limit relace TAEF.

te.exe test1.dll /sessionTimeout:0:0:0.5

Po 0,5 sekundách vyprší časový limit celé testovací relace.

te.exe test1.dll /sessionTimeout:0:0:45

Po 45 sekundách vyprší časový limit celé testovací relace.

te.exe test1.dll /sessionTimeout:0:20

Po 20 minutách vyprší časový limit celé testovací relace.

te.exe test1.dll /sessionTimeout:5

Po 5 hodinách vyprší časový limit celé testovací relace.

te.exe test1.dll /sessionTimeout:1.2

Po 1 dni a 2 hodinách vyprší časový limit celé testovací relace.

/terminateOnFirstFailure

Ukončí testovací běh při prvním spuštění testu. Všechny operace odstranění pro tento test jsou vyvolány, ale všechny následné testy jsou označeny jako ignorovány. Kvůli známému problému můžou testy při použití testovacího režimu pokračovat ve spuštění.

te.exe test1.dll /terminateOnFirstFailure

/testDependencies:<files>

Určuje další závislosti testů, které se mají nasadit při použití provádění testů mezi počítači. Pokud není k dispozici úplná cesta, taEF vyhledá relativní vzhledem k aktuálnímu adresáři, nikoli testovacímu adresáři.

te.exe *.dll /runon:TestMachine1 /TestDependencies:test*.jpg; file1.doc

Interpretace: Před provedením jakýchkoli testů spusťte všechny testy vzdáleně na testMachine1 a zkopírujte test*.jpga file1.doc na vzdálený počítač. Každá specifikace souboru může obsahovat zástupné znaky (test.txt; test*.dll; atd.), aby odpovídaly jednomu nebo více souborům.

/testTimeout:<value>

Nastaví časový limit globálního testu pro celé provádění Te.exe. Tato hodnota přepíše všechna metadata vypršení časového limitu testu , která byla pro daný test spuštěna.

Note

Hodnota časového limitu musí být zadána v následujícím formátu:

[Day.]Hour[:Minute[:Second[.FractionalSeconds]]]

Note

Bude ignorován při použití ve spojení s parametrem /inproc.

te.exe test1.dll /testTimeout:0:0:0.5

Každý test a metoda nastavení/vyčištění vyprší po 0,5 sekundách.

te.exe test1.dll /testTimeout:0:0:45

Po 45 sekundách vyprší časový limit každé metody testování a nastavení/vyčištění.

te.exe test1.dll /testTimeout:0:20

Po 20 minutách vyprší časový limit každé metody testování a nastavení/vyčištění.

te.exe test1.dll /testTimeout:5

Po 5 hodinách vyprší časový limit každé metody testování a nastavení/vyčištění.

te.exe test1.dll /testTimeout:1.2

Každá metoda testování a nastavení/vyčištění vyprší po 1 dni a 2 hodinách.

/unicodeOutput:<true/false>

Když je TE předaný do textového souboru, ve výchozím nastavení vypíše unicode. Jedinou výjimkou je, pokud jste požádali o připojení k existujícímu souboru ANSII (prostřednictvím ">>").

Chcete-li toto chování přepsat, můžete zadat /unicodeOutput:false. To vynutí, aby TE vždy výstupní ANSII do souboru.

te.exe test1.dll /unicodeOutput:false > output.txt

Nastavení protokolovacího nástroje

/appendWttLogging

Pokud je protokolování WTT povolené, připojí se místo přepsání k souboru protokolu. Musí být použit ve spojení s /enableWttLogging.

te.exe test1.dll /enableWttLogging /appendWttLogging

Po dokončení testu se vytvoří nebo připojí k souboru protokolu s názvem TE.wtl .

/enableWttLogging

Povolí protokolování WTT; Wttlog.dll musí být ve vaší cestě k dispozici.

te.exe test1.dll /enableWttLogging

Při dokončení testu vytvoří soubor protokolu s názvem TE.wtl .

/defaultAppDomain

Spustí spravované testy ve výchozí doméně aplikace.

te.exe managed.test1.dll /defaultAppDomain

/disableConsoleLogging

Zakáže výstup protokolu konzoly; musí být použit ve spojení s /enableWttLogging.

te.exe test1.dll /disableConsoleLogging /enableWttLogging

/logFile:<name>

Zadejte název, který se má použít jako soubor protokolu wtt; musí být použit ve spojení s /enableWttLogging.

te.exe test1.dll /logFile:myCustomLogFile.xml /enableWttLogging

Při dokončení testu vytvoří soubor protokolu s názvem myCustomeLogFile.xml .

/logOutput:<mode>

Nastaví výstupní úroveň protokolovacího nástroje. Platné hodnoty jsou:

• Vysoká: Umožňuje některé další výstupy konzoly, jako je tisk časového razítka vedle každého trasování.
• Nízká hodnota: Generuje pouze základní události (počáteční, koncová skupina atd.) a chyby. Soubor protokolu obsahuje podrobnosti s nižší prioritou, které předepíše všechny chyby, aby se zajistil kontext selhání.
• LowWithConsoleBuffering: Stejné jako Minimum, ale zahrnuje kontext selhání v souboru protokolu i výstupu konzoly.
• Nejnižší: Stejný jako Nízký, ale výstup konzoly zahrnuje pouze chyby, chyby testů a souhrn spuštění.

/version

Zobrazí podrobné informace o verzi.

/wttDeviceString:<value>

Zcela přepíše WttDeviceString, který je používán WexLoggerem při inicializaci WttLoggeru.

te.exe test1.dll /wttDeviceString:$Console

/wttDeviceStringSuffix:<value>

Připojí zadanou hodnotu k výchozímu WttDeviceString, který používá WexLogger při inicializaci WttLogger. Ignorováno, pokud je zadán také wttDeviceString .

te.exe test1.dll /wttDeviceStringSuffix:$Console

Nastavení ladění

/breakOnCreate

Před vytvořením instance každé testovací třídy se rozdělí do ladicího programu.

te.exe test1.dll /breakOnCreate

/breakOnError

Pokud dojde k chybě nebo selhání testu, rozdělí se do ladicího programu.

te.exe test1.dll /breakOnError

/breakOnInvoke

Před vyvoláním každé testovací metody se rozdělí do ladicího programu.

te.exe test1.dll /breakOnInvoke

/disableTimeouts

Zakáže všechny časové limity během provádění. To může být užitečné při ladění, aby se zabránilo vypršení časového limitu, když taEF čeká na část programu, který se ladí.

te.exe test1.dll /disableTimeouts

/miniDumpOnError

Pokud dojde k chybě nebo selhání testu, protokoluje ho a zaprokoluje ho.

te.exe test1.dll /miniDumpOnError

/miniDumpOnCrash

Pokud dojde k chybovému ukončení testu, protokoluje ho a zaprokoluje ho.

te.exe test1.dll /miniDumpOnCrash

/rebootStateFile

Explicitně povolí spouštění testů restartování .

te.exe test1.dll /rebootStateFile:myFile.xml

/reportLoadingIssue

Zobrazí dialogové okno s popisem chyby, když taEF nenačte testovací knihovnu DLL. Je nutné použít pouze ke zkoumání problémů s načítáním nativní testovací knihovny DLL.

te.exe test1.dll /reportLoadingIssue

/screenCaptureOnError

Vezme a zaznamená snímek obrazovky, pokud dojde k chybě nebo selhání testu.

te.exe test1.dll /screenCaptureOnError

/stackFrameCount:<value>

Určuje počet rámců zásobníku, které se mají zobrazit při získávání zásobníků volání. Výchozí hodnota je 50.

te.exe test1.dll /stackFrameCount:100

/stackTraceOnError

Provede trasování zásobníku a zaprokoluje ho, pokud dojde k chybě nebo selhání testu.

te.exe test1.dll /stackTraceOnError

Testovací režimy

/testmode:Loop

Umožňuje řídit provádění pomocí dvou proměnných Loop a LoopTest.

• Smyčka: Určuje, kolikrát se spustí celé spuštění. Výchozí 1.
• LoopTest: Určuje, kolikrát se spustí jednotlivý test. Výchozí hodnota 10.

te.exe test1.dll /testmode:Loop

Interpretace: Spusťte každý test v test1.dll 10krát (výchozí hodnota pro LoopTest). Celé spuštění se spustí jednou (výchozí hodnota smyčky).

te.exe test1.dll test2.dll /testmode:Loop /Loop:3 /LoopTest:1

Interpretace: Spusťte každý test v test1.dll a test2.dll jednou (určen smyčkou LoopTest). Celé spuštění (všechny kombinované testy v test1.dll a test2.dll) se spouští 3krát – podle toho, jak je určena smyčkou.

/testmode:Stress

V režimu zátěžového testu spustí funkce TAEF testy po neomezenou dobu, dokud se nezadá Ctrl+C nebo dokud se do skrytého okna TAEF neposílají WM_CLOSE zpráva. /testmode:stress musí být spuštěn ve spojení s parametrem /inproc.

te.exe test1.dll /testmode:Stress /inproc

Podrobné informace a další parametry podporované v tomto režimu naleznete v tématu Testovací režimy.