Partager via

options de commande Te.exe

  • Article

Utilisation

<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] [/ dpiaware ] [/enableWttLogging] [/inproc] [/isolationLevel] [/labMode] [/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>]

Commandes sélection/exécution

test_binaries

Spécifiez un ou plusieurs fichiers de test à exécuter (séparés par des espaces). Les caractères génériques sont pris en charge.

te.exe test1.dll

Interprétation : exécutez tous les tests dans test1.dll.

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

Interprétation : exécutez tous les tests dans test1.dll, test2.dll et test3.dll.

te.exe *.dll

Interprétation : exécutez tous les tests dans toutes les dll du répertoire actif.

/coloredConsoleOutput :<true/false>

Spécifie si TAEF doit générer ou non du texte de la console colorée. La valeur par défaut est true. Si la valeur est false, TAEF génère tout le texte avec la couleur de console par défaut.

te.exe test1.dll /coloredConsoleOutput:false

/console :<optionName>=<value>

Fournit des options pour configurer l’utilisation de TE de la console. Les options suivantes sont disponibles :

/console :flushWrites

Provoque le vidage de la sortie de la console une fois que chaque ligne est écrite : utile lorsque la sortie de TE.exe a été redirigée.

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

Définit la position (en pixels) de la fenêtre de console par rapport au coin du moniteur principal. Utilisez la valeur actuelle pour spécifier que la position de la console actuelle doit être stockée et utilisée lors du redémarrage.

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

Définit la taille de la fenêtre de console (en dimensions de caractère). La taille de la mémoire tampon d’écran est augmentée pour correspondre à la taille de la fenêtre si nécessaire. Utilisez une valeur actuelle pour spécifier que la taille de la console actuelle doit être stockée et utilisée lors du redémarrage.

/console :topmost

Maintient l’exécution de la console te.exe « la plus haute » dans l’ordre z de bureau pendant la durée de l’exécution.

/dpiaware

Exécute des tests dans un processus marqué comme prenant en charge les ppp, consultez Haute résolution. Cela peut également être défini via des métadonnées (« DpiAware »).

/inproc

Exécutez tous les tests au sein du processus TE.exe lui-même plutôt que dans TE. ProcessHost.exe.

te.exe test1.dll /inproc

Remarque

TE prend uniquement en charge l’exécution d’une dll de test à la fois lors de l’utilisation du paramètre /inproc .

/isolationLevel :<Level>

Spécifie le niveau minimal d’isolation à utiliser lors de l’exécution de tests TAEF. Si cette valeur est en conflit avec isolationLevel spécifiée en tant que métadonnées, la valeur devient le niveau d’isolation avec l’étendue la plus étroite. Pour plus d’informations, consultez l’isolation des tests.

te.exe test1.dll /isolationLevel:Class

/labMode

Exécute des tests et supprime l’interface utilisateur bloquante potentielle (par exemple, les boîtes de dialogue Rapport d’erreurs Windows sur les tests de blocage).

/list

Répertorie les noms de toutes les test_binaries et les classes et méthodes qu’ils contiennent. Si des critères de sélection sont spécifiés, répertorie uniquement les noms des personnes qui répondent aux critères.

 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

Répertorie les noms et les propriétés de toutes les test_binaries et les classes et méthodes qu’ils contiennent, ainsi que les noms de fonctions Setup et Teardown, si disponible. Si des critères de sélection sont spécifiés, répertorie uniquement les noms des personnes qui répondent aux critères.

 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>

La sélection basée sur le nom de test est une alternative facile à « /select :@Name='<testname> ». Le <nom> de test peut toujours contenir des caractères génériques (« * » et « ? »), mais ne doit pas être contenu dans des guillemets simples. Si /select et /name sont spécifiés à l’invite de commandes, la requête /select est prioritaire et /name est ignorée.

te.exe test1.dll /name :*TestToLower

Interprétation : exécutez tous les tests dans test1.dll où les noms de méthode se terminent par « TestToLower ». La même chose peut être représentée à l’aide de critères de sélection comme /select :@Name='*TestToLower'.

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

Interprétation : exécutez tous les tests dans test1.dll qui contiennent l’expression « StringTest » dans leur espace de noms, leur classe ou leur nom de méthode.

/outputFolder :<folderName>

Spécifie un dossier pour placer tous les fichiers générés. L'emplacement par défaut est le répertoire actif. Vous pouvez utiliser des variables d’environnement, par exemple :

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

/p :<ParamName>=<ParamValue>

Définit un paramètre runtime avec le nom du paramètre=ParamName et la valeur de paramètre=ParamValue. Ces paramètres sont accessibles à partir d’une méthode de test ou d’une méthode de configuration/nettoyage.

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

Vous pouvez saisir x comme l’un des types pris en charge dans votre code de test. Par exemple, ici, vous pouvez nous voir récupérer en tant qu’int et weX ::Common ::String :

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

Pour plus d’informations, visitez le TAEF. Page d’aide des paramètres d’exécution.

/parallèle

Exécute des tests en parallèle sur plusieurs processeurs. Les tests doivent accepter l’exécution parallèle en étant marqués avec les métadonnées « Parallel ».

te.exe test1.dll /parallel

Pour plus d’informations, consultez la page d’aide parallèle .

/persistPictResults

Met en cache les résultats générés par PICT.exe pour les tests à l’aide de PICT DataSource dans l’exécution actuelle. L’exécution de test suivante tente d’utiliser les résultats mis en cache par rapport à l’exécution de PICT.exe sur le même modèle et les mêmes fichiers de départ.

/pict :<OptionName>=<OptionValue>

Fournit des options pour contrôler PICT.exe lorsqu’elle est appelée pour les tests à l’aide d’une source de données PICT. La définition de l’une de ces options remplace actuellement toutes les métadonnées associées dans le code. Les options suivantes sont disponibles :

/Pict :Order=3
Définit l’ordre des combinaisons en passant la valeur via l’option de commande /o pour PICT.exe.

/Pict :ValueSeparator= ;
Définit le séparateur de valeur en passant la valeur via l’option de commande /d pour PICT.exe.

/Pict :AliasSeparator=+
Définit le séparateur d’alias en passant la valeur via l’option de commande /a pour PICT.exe.

Pict :NegativeValuePrefix= !
Définit le préfixe de valeur négative en passant la valeur via l’option de commande /n pour PICT.exe.

/Pict :SeedingFile=test.seed
Définit le chemin d’accès au fichier d’amorçage en passant la valeur via l’option de commande /e pour PICT.exe.

/Pict :Random=true
Active ou désactive le caractère aléatoire dans les résultats PICT et rend le journal de la source de données PICT la valeur initiale aléatoire utilisée.

/Pict :RandomSeed=33
Définit l’amorçage aléatoire en passant la valeur via l’option de commande /r pour PICT.exe. La définition de cette option active Pict :Random, sauf si Pict :Random est explicitement défini sur false.

/Pict :CaseSensitive=true
Lorsque la valeur est true, active la sensibilité de la casse en passant l’option de commande /c à PICT.exe.

/Pict :Timeout=00:01:30
Définit le temps d’attente de PICT.exe pour terminer avant de tuer son processus. La valeur est au format [Day.] Heure[ :Minute[ :Seconde[. FractionalSeconds]]].

/runas :<RunAsType>

Exécute des tests dans un environnement spécifié. Reportez-vous à la documentation RunAs pour obtenir des informations détaillées sur l’utilisation.

te.exe *.dll /runas :System

Interprétation : exécutez tous les tests en tant que système.

te.exe *.dll /runas :Elevated

Interprétation : exécutez tous les tests en tant qu’utilisateur avec élévation de privilèges.

te.exe *.dll /runas :Restricted

Interprétation : exécutez tous les tests en tant qu’utilisateur non élevé.

te.exe *.dll /runas :LowIL

Interprétation : exécutez tous les tests dans un processus d’intégrité faible.

/runIgnoredTests

Exécute ou répertorie (conjointement avec /list ou /listProperties) tous les tests, y compris les classes de test et les méthodes de test avec les métadonnées « Ignorer » définies sur « true ». Par défaut, les classes de test et les méthodes de test avec les métadonnées « Ignorer » définies sur « true » sont ignorées pendant l’exécution et lors de la liste.

/runon :<MachineName>

Exécute des tests à distance sur l’ordinateur spécifié. TAEF authentifie, autorise et déploie les fichiers binaires nécessaires pour exécuter les tests et consigne toutes les informations dans la console d’origine. Pour plus d’informations sur l’utilisation, reportez-vous à la documentation sur l’exécution des tests inter-machines.

te.exe *.dll /runon :TestMachine1

Interprétation : exécutez tous les tests à distance sur « TestMachine1 ».

/select :<query>

Critères de sélection à utiliser lors de la sélection de tests à partir de chaque binaire de test. Les critères de sélection sont composés d’une ou plusieurs des options suivantes :

@[nom de propriété] = [valeur en tant que chaîne]

@[nom de propriété] >= [valeur en tant que float ou integer]

@[nom de propriété] > [valeur en tant que float ou integer]

@[nom de propriété] <= [valeur en tant que float ou integer]

@[nom de propriété] < [valeur en tant que float ou integer]

  • Les valeurs de propriété sous forme de chaînes doivent se trouver entre guillemets simples.
  • Vous pouvez spécifier un critère de sélection composite à l’aide de « et », « ou » et « non » (non respect de la casse).
  • Les valeurs de chaîne de propriété prennent en charge les caractères génériques via « * » et « ? ».
  • Pour les valeurs float et integer, le caractère « * » peut également être utilisé comme « exists », mais ne peut pas être utilisé pour la correspondance partielle. Par exemple : /select :"@Priority=* » est valide, mais /select :"@Priority=4* » n’est pas.

te.exe test1.dll /select :"(@Name='*TestToLower' ou @Owner='C2') et not(@Priority < 3) »

Interprétation : exécutez tous les tests dans test1.dll où les noms de méthode se terminent par « TestToLower » ou où le propriétaire est « C2 » ; et où Priority n’est pas inférieure à 3.

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

Interprétation : exécutez tous les tests dans test1.dll et test2.dll où la priorité a été spécifiée dans leurs métadonnées de test.

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

Interprétation : exécutez tous les tests dans test1.dll qui contiennent l’expression « StringTest » dans leur espace de noms, leur classe ou leur nom de méthode.

/sessionTimeout :<value>

Définit un délai d’attente de session pour toute l’exécution de Te.exe. Si le délai d’expiration expire, la session de test est abandonnée avec grâce et le code de sortie du processus signifie qu’un délai d’attente s’est produit.

Remarque

La valeur de délai d’attente doit être spécifiée au format suivant :

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

Remarque

Si elle s’exécute sous WTT, cette valeur peut être utilisée pour vous assurer que le fichier journal Wtt reste intact même si la session TAEF expire.

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

La session de test entière expire après .5 secondes.

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

La session de test entière expire après 45 secondes.

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

La session de test entière expire après 20 minutes.

te.exe test1.dll /sessionTimeout :5

La session de test entière expire après 5 heures.

te.exe test1.dll /sessionTimeout :1.2

Toute la session de test expire après 1 jour et 2 heures.

/terminateOnFirstFailure

Termine l’exécution du test la première fois qu’un échec de test est rencontré. Toutes les opérations de suppression pour ce test sont appelées, mais tous les tests suivants sont marqués comme ignorés. En raison d’un problème connu, les tests peuvent continuer à s’exécuter lors de l’utilisation d’un mode de test.

te.exe test1.dll /terminateOnFirstFailure

/testDependencies :<files>

Spécifie des dépendances de test supplémentaires à déployer lors de l’utilisation de l’exécution des tests inter-ordinateurs. Sauf si un chemin d’accès complet est fourni, TAEF effectue une recherche par rapport au répertoire actif, et non au répertoire de test.

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

Interprétation : exécutez tous les tests à distance sur « TestMachine1 », puis copiez « test*.jpg » et « file1.doc » sur l’ordinateur distant avant d’exécuter des tests. Chaque spécification de fichier peut contenir des caractères génériques (test.txt ; test*.dll ; etc.) pour correspondre à un ou plusieurs fichiers.

/testTimeout :<value>

Définit un délai d’attente de test global pour toute l’exécution de Te.exe. Cette valeur remplace toutes les métadonnées de délai d’attente de test qui ont peut-être été définies pour un test donné en cours d’exécution.

Remarque

La valeur de délai d’attente doit être spécifiée au format suivant :

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

Remarque

Est ignoré lorsqu’il est utilisé conjointement avec /inproc.

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

Chaque méthode de test et de configuration/nettoyage expire après .5 secondes.

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

Chaque méthode de test et de configuration/nettoyage expire après 45 secondes.

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

Chaque méthode de test et de configuration/nettoyage expire après 20 minutes.

te.exe test1.dll /testTimeout :5

Chaque méthode de test et de configuration/nettoyage expire après 5 heures.

te.exe test1.dll /testTimeout :1.2

Chaque méthode de test et de configuration/nettoyage expire après 1 jour et 2 heures.

/unicodeOutput :<true/false>

Lorsque TE est redirigé vers un fichier texte, il génère unicode par défaut. L’une des exceptions à ceci est que vous avez demandé d’ajouter à un fichier ANSII existant (via '>>').

Pour remplacer ce comportement, vous pouvez spécifier /unicodeOutput :false. Cela force TE à toujours générer ANSII dans le fichier.

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

Paramètres de l’enregistreur d’événements

/appendWttLogging

Lorsque la journalisation WTT est activée, ajoute au fichier journal plutôt que de l’écraser. Doit être utilisé conjointement avec /enableWttLogging.

te.exe test1.dll /enableWttLogging /appendWttLogging

Crée ou ajoute un fichier journal appelé TE.wtl lors de l’exécution du test.

/enableWttLogging

Active la journalisation WTT ; Wttlog.dll devez être disponible dans votre chemin d’accès.

te.exe test1.dll /enableWttLogging

Produit un fichier journal appelé TE.wtl lors de l’exécution du test.

/defaultAppDomain

Exécute des tests managés dans le domaine d’application par défaut.

te.exe managed.test1.dll /defaultAppDomain

/disableConsoleLogging

Désactive la sortie du journal de la console ; doit être utilisé conjointement avec /enableWttLogging.

te.exe test1.dll /disableConsoleLogging /enableWttLogging

/logFile :<name>

Spécifiez un nom à utiliser comme fichier journal wtt ; doit être utilisé conjointement avec /enableWttLogging.

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

Génère un fichier journal appelé myCustomeLogFile.xml lors de l’exécution du test.

/logOutput :<mode>

Définit le niveau de sortie de l’enregistreur d’événements. Les valeurs valides sont :

  • Élevé : active une sortie de console supplémentaire, par exemple l’impression d’un horodatage en regard de chaque trace.
  • Faible : émet uniquement les événements principaux (début, groupe final, etc.) et les erreurs. Le fichier journal inclut des détails de priorité inférieure qui précèdent toutes les erreurs afin de fournir un contexte pour les échecs.
  • LowWithConsoleBuffering : Identique à Low, mais inclut le contexte des défaillances dans le fichier journal et la sortie de la console.
  • Le plus bas : Identique à Faible, mais la sortie de la console inclut uniquement les erreurs, les échecs de test et le résumé de l’exécution.

/version

Génère des informations détaillées sur la version.

/wttDeviceString :<value>

Remplace complètement le WttDeviceString utilisé par WexLogger quand il initialise WttLogger.

te.exe test1.dll /wttDeviceString:$Console

/wttDeviceStringSuffix :<value>

Ajoute la valeur spécifiée au WttDeviceString par défaut utilisé par WexLogger lorsqu’il initialise WttLogger. Ignoré si wttDeviceString est également spécifié.

te.exe test1.dll /wttDeviceStringSuffix:$Console

Paramètres de débogage

/breakOnCreate

Saute dans le débogueur avant d’instancier chaque classe de test.

te.exe test1.dll /breakOnCreate

/breakOnError

Saute dans le débogueur si une erreur ou un échec de test est enregistré.

te.exe test1.dll /breakOnError

/breakOnInvoke

Saute dans le débogueur avant d’appeler chaque méthode de test.

te.exe test1.dll /breakOnInvoke

/disableTimeouts

Désactive tous les délais d’attente pendant l’exécution. Cela peut être utile lors du débogage pour empêcher un délai d’expiration lorsque TAEF attend la partie du programme en cours de débogage.

te.exe test1.dll /disableTimeouts

/miniDumpOnError

Prend et enregistre un mini-vidage si une erreur de test ou une défaillance se produit.

te.exe test1.dll /miniDumpOnError

/miniDumpOnCrash

Prend et consigne un mini dump si un incident de test se produit.

te.exe test1.dll /miniDumpOnCrash

/rebootStateFile

Active explicitement l’exécution des tests de redémarrage .

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

/reportLoadingIssue

Affiche une boîte de dialogue de description d’erreur lorsque TAEF ne parvient pas à charger une dll de test. Doit être utilisé uniquement pour l’examen des problèmes de chargement de dll de test natifs.

te.exe test1.dll /reportLoadingIssue

/screenCaptureOnError

Prend et enregistre une capture d’écran si une erreur de test ou une défaillance se produit.

te.exe test1.dll /screenCaptureOnError

/stackFrameCount :<value>

Spécifie le nombre d’images de pile à afficher lors de l’obtention des piles d’appels. La valeur par défaut est 50.

te.exe test1.dll /stackFrameCount:100

/stackTraceOnError

Prend et consigne une trace de pile si une erreur de test ou une défaillance se produit.

te.exe test1.dll /stackTraceOnError

Test Modes

/testmode :Loop

Permet de contrôler l’exécution à l’aide de deux variables Loop et LoopTest.

  • Boucle : contrôle le nombre de fois où l’exécution entière est exécutée. la valeur par défaut est 1.
  • LoopTest : contrôle le nombre de fois où un test individuel est exécuté. Valeur par défaut : 10.

te.exe test1.dll /testmode :Loop

Interprétation : exécutez chaque test dans test1.dll 10 fois (valeur par défaut pour LoopTest). L’exécution entière est exécutée une seule fois (valeur par défaut pour la boucle).

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

Interprétation : exécutez chaque test dans test1.dll et test2.dll une seule fois (déterminé par LoopTest). L’exécution entière (tous les tests combinés dans test1.dll et test2.dll) est exécutée 3 fois, comme déterminé par la boucle.

/testmode :Stress

En mode de test « stress », TAEF exécute les tests indéfiniment, jusqu’à ce que Ctrl+C soit entré ou jusqu’à ce qu’un message WM_CLOSE soit envoyé à la fenêtre masquée de TAEF. /testmode :stress doit être exécuté conjointement avec /inproc.

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

Pour obtenir des informations détaillées et d’autres paramètres pris en charge dans ce mode, consultez Modes de test.