Informations de référence sur les options de l’interface CLI Microsoft.Testing.Platform

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

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.

• --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.

• --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épertoriez les tests disponibles. Les tests ne seront pas exécutés.

• --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 Codes de sortie Microsoft.Testing.Platform.

  Note

  Cette fonctionnalité est disponible dans Microsoft.Testing.Platform à 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.

• --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.

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 Microsoft.Testing.Platform
• Fonctionnalités de Microsoft.Testing.Platform
• Test avec dotnet test