Microsoft Testing.Platform (MTP) - Référence des options CLI

Cet article fournit un point d’entrée central pour les options de ligne de commande MTP.

Options de plateforme

• @

  Spécifie le nom du fichier de réponse. Le nom du fichier de réponse doit immédiatement suivre le @ caractère sans espace blanc entre le @ caractère et le nom du fichier de réponse.

  Les options d'un fichier de réponse sont interprétées comme si elles étaient présentes à cet endroit de la ligne de commande. Vous ne pouvez pas utiliser le caractère antislash \ pour concaténer des lignes. L'utilisation d'un fichier de réponse est utile pour les commandes très longues qui pourraient dépasser les limites du terminal. Vous pouvez combiner un fichier de réponse avec des arguments de ligne de commande en ligne. Par exemple:

  ./TestExecutable.exe @"filter.rsp" --timeout 10s
  

  Par exemple, le fichier filter.rsp peut contenir les éléments suivants :

  --filter "A very long filter"
  

  Vous pouvez également utiliser un seul fichier rsp pour spécifier à la fois le délai d'attente et le filtre comme suit :

  ./TestExecutable.exe @"arguments.rsp"
  

  --filter "A very long filter" --timeout 10s
  

  Note

  Lors de l’utilisation dotnet test, l’analyseur de ligne de commande SDK utilise une approche par jeton par ligne où chaque ligne du fichier réponse est traitée comme un seul jeton. Dans ce cas, chaque argument doit se trouver sur une ligne distincte :

  --filter
  A very long filter
  --timeout
  10s
  

• --config-file

  Spécifie un fichier testconfig.json.

• --debug

  Interrompt l’exécution du test au démarrage afin de pouvoir attacher un débogueur au processus de test. Équivaut à définir la TESTINGPLATFORM_WAIT_ATTACH_DEBUGGER sur 1. Non pris en charge sur les plateformes de navigateur.

  Note

  Cette option est disponible dans MTP à partir de la version 1.9.0. Il remplace l’option précédente --debug-wait-attach (introduite dans MTP 1.6.0) ; l’ancien nom a été supprimé et ne doit plus être utilisé.

• --diagnostic

  Active la journalisation des diagnostics. Le niveau de journalisation par défaut est Trace. Le fichier est écrit dans le répertoire de sortie au format de nom suivant. log_[MMddHHssfff].diag

• --diagnostic-synchronous-write

  Permet d'imposer au journalisateur de fichiers intégré d'écrire les logs synchronement. Utile pour les scénarios où vous ne souhaitez perdre aucune entrée de journal (si le processus se bloque). Cela ralentit l’exécution du test.

• --diagnostic-output-directory

  Le répertoire de sortie de la journalisation des diagnostics, s’il n’est pas spécifié, le fichier est généré dans le répertoire TestResults par défaut.

• --diagnostic-file-prefix

  Préfixe du nom de fichier journal. La valeur par défaut est "log".

• --diagnostic-verbosity

  Permet de définir le niveau de verbosité lorsque le commutateur --diagnostic est utilisé. Les valeurs disponibles sont Trace, Debug, Information, Warning, Error ou Critical.

• --exit-on-process-exit

  Quittez le processus de test si le processus dépendant se termine. Le PID doit être fourni.

• --filter-uid

  Filtre les tests à exécuter à partir de l’UID de leurs nœuds de test. Accepte un ou plusieurs UID.

  Note

  Cette option est disponible dans MTP à partir de la version 1.8.0.

• --help

  Imprime une description de l’utilisation de la commande.

• --ignore-exit-code

  Permet à certains codes de sortie non nuls d’être ignorés et d’être retournés en tant que 0 à la place. Pour plus d’informations, consultez Ignorer des codes de sortie spécifiques.

• --info

  Affiche des informations avancées sur l’application de test .NET, telles que :

  • La plateforme.
  • L’environnement.
  • Chaque fournisseur de ligne de commande inscrit, tel que ses name, version, description et options.
  • Chaque outil inscrit, tel que ses command, name, version, description et tous les fournisseurs de ligne de commande.

  Cette fonctionnalité est utilisée pour comprendre les extensions qui effectuent l’inscription de la même option de ligne de commande ou les modifications apportées aux options disponibles entre plusieurs versions d’une extension (ou la plateforme).

• --list-tests

  Répertorie les tests disponibles sans les exécuter. Prend éventuellement un argument qui contrôle le format de sortie : text (valeur par défaut, lisible par l’homme) ou json.

  Note

  Le json format de sortie est disponible dans MTP à partir de la version 2.3.0.

• --maximum-failed-tests

  Spécifie le nombre maximum d'échecs de tests qui, lorsqu'il est atteint, arrête l'exécution du test. La prise en charge de ce commutateur nécessite que les auteurs de framework implémentent la capacité IGracefulStopTestExecutionCapability. Le code de sortie lorsque ce nombre d'échecs est atteint est 13. Pour plus d’informations, consultez les codes de sortie MTP.

  Note

  Cette fonctionnalité est disponible dans MTP à partir de la version 1.5.

• --minimum-expected-tests

  Spécifie le nombre minimal de tests censés s’exécuter. Par défaut, au moins un test est censé s’exécuter.

• --no-banner

  Désactive la bannière de démarrage, le message de copyright et la bannière de télémétrie. Le même effet peut être obtenu grâce à TESTINGPLATFORM_NOBANNER ou DOTNET_NOLOGOdes variables d’environnement.

• --results-directory

  Répertoire où les résultats de test doivent être placés. Si le répertoire spécifié n’existe pas, il est créé. La valeur par défaut est TestResults dans le répertoire qui contient l’application test.

• --timeout

  Un délai d'expiration global pour l'exécution de tests. Prend un argument comme chaîne au format <value>[h|m|s] où <value> est flottant.

• --treenode-filter

  Filtre les tests à exécuter à l’aide d’une expression de filtre d’arborescence. Les filtres d’arborescence offrent une correspondance plus riche que --filter pour les scénarios avancés.

Options d’extension par scénario

Utilisez le tableau suivant pour rechercher rapidement les options d’extension.

Découvrir les options dans votre application de test

Exécutez votre exécutable de test avec --help pour lister les options disponibles pour votre jeu d’extensions actuel.

Pour les diagnostics avancés des fournisseurs et options inscrits, exécutez la commande --info.

Voir aussi

• Vue d’ensemble de MTP
• Fonctionnalités MTP
• Test avec dotnet test