Microsoft.Testing.Platform (MTP): referencia de las opciones de la CLI

En este artículo se proporciona un punto de entrada central para las opciones de línea de comandos de MTP.

Opciones de plataforma

• @

  Especifica el nombre del archivo de respuesta. El nombre del archivo de respuesta debe seguir inmediatamente el @ carácter sin espacio en blanco entre el @ carácter y el nombre del archivo de respuesta.

  Las opciones de un archivo de respuesta se interpretan como si estuvieran presentes en ese lugar en la línea de comandos. No puedes usar el carácter de barra inversa \ para concatenar líneas. El uso de un archivo de respuesta ayuda para comandos muy largos que podrían superar los límites de terminal. Puede combinar un archivo de respuesta con argumentos de línea de comandos en línea. Por ejemplo:

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

  donde filter.rsp puede tener el siguiente contenido:

  --filter "A very long filter"
  

  O bien, se puede usar un único archivo rsp para especificar el tiempo de espera y el filtro como se indica a continuación:

  ./TestExecutable.exe @"arguments.rsp"
  

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

  Nota:

  Cuando se usa dotnet test, el analizador de línea de comandos del SDK usa un enfoque de token por línea en el que cada línea del archivo de respuesta se trata como un único token. En ese caso, cada argumento debe estar en una línea independiente:

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

• --config-file

  Especifica un archivo testconfig.json.

• --debug

  Detiene la ejecución de la prueba al iniciarse para que pueda adjuntar un depurador al proceso de prueba. Equivalente a establecer la TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERvariable de entorno en 1. No se admite en plataformas de explorador.

  Nota:

  Esta opción está disponible en MTP a partir de la versión 1.9.0. Reemplaza la opción anterior (introducida en MTP 1.6.0); el nombre anterior --debug-wait-attach se quitó y ya no se debe usar.

• --diagnostic

  Habilita el registro de diagnóstico. El nivel de registro predeterminado es Trace. El archivo se escribe en el directorio de salida con el siguiente formato de nombre: log_[MMddHHssfff].diag.

• --diagnostic-synchronous-write

  Obliga al registrador de archivos integrado a escribir registros de forma sincrónica. Resulta útil para escenarios en los que no desea perder ninguna entrada de registro (si el proceso se bloquea). Esto ralentiza la ejecución de la prueba.

• --diagnostic-output-directory

  Directorio de salida del registro de diagnóstico, si no se especifica que el archivo se genere en el directorio predeterminado TestResults.

• --diagnostic-file-prefix

  Prefijo del nombre del archivo de registro. Tiene como valor predeterminado "log".

• --diagnostic-verbosity

  Define el nivel de detalle cuando se usa el modificador --diagnostic. Los valores disponibles son Trace, Debug, Information, Warning, Erroro Critical.

• --exit-on-process-exit

  Salga del proceso de prueba si el proceso dependiente se cierra. Se debe proporcionar PID.

• --filter-uid

  Filtra las pruebas que se ejecutarán según los UID de sus nodos de prueba. Acepta uno o varios UID.

  Nota:

  Esta opción está disponible en MTP a partir de la versión 1.8.0.

• --help

  Imprime una descripción de cómo usar el comando .

• --ignore-exit-code

  Permite omitir algunos códigos de salida distintos de cero y, en su lugar, devolverlos como 0. Para obtener más información, consulte Omisión de códigos de salida específicos.

• --info

  Muestra información avanzada sobre la aplicación de prueba de .NET, como:

  • La plataforma.
  • El entorno.
  • Cada proveedor de línea de comandos registrado, como name, version, description y options.
  • Cada herramienta registrada, como command, name, version, description, y todos los proveedores de línea de comandos.

  Esta característica se usa para comprender las extensiones que registrarían la misma opción de línea de comandos o los cambios en las opciones disponibles entre varias versiones de una extensión (o la plataforma).

• --list-tests

  Enumera las pruebas disponibles sin ejecutarlas. Opcionalmente, toma un argumento que controla el formato de salida: text (valor predeterminado, legible por el usuario) o json.

  Nota:

  El json formato de salida está disponible en MTP a partir de la versión 2.3.0.

• --maximum-failed-tests

  Especifica el número máximo de errores de pruebas que, cuando se alcanza, detendrá la ejecución de pruebas. La compatibilidad con este modificador requiere que los autores del marco implementen la funcionalidad IGracefulStopTestExecutionCapability. El código de salida al alcanzar esa cantidad de errores de prueba es 13. Para obtener más información, consulte Códigos de salida de MTP.

  Nota:

  Esta característica está disponible en MTP a partir de la versión 1.5.

• --minimum-expected-tests

  Especifica el número mínimo de pruebas que se espera que se ejecuten. De forma predeterminada, se espera que se ejecute al menos una prueba.

• --no-banner

  Deshabilita el banner de inicio, el mensaje de copyright y el banner de telemetría. El mismo efecto se puede lograr a través de las TESTINGPLATFORM_NOBANNERDOTNET_NOLOGO o .

• --results-directory

  El directorio donde se guardarán los resultados de pruebas. Si el directorio especificado no existe, se crea. El valor predeterminado es TestResults en el directorio que contiene la aplicación de prueba.

• --timeout

  Tiempo de espera global de ejecución de pruebas. Toma un argumento como cadena en el formato <value>[h|m|s] donde <value> es float.

• --treenode-filter

  Filtra las pruebas que se van a ejecutar mediante una expresión de filtro de árbol. Los filtros de árbol ofrecen una coincidencia más completa que --filter para escenarios avanzados.

Opciones de extensión por escenario

Use la tabla siguiente para buscar opciones de extensión rápidamente.

Detección de opciones en la aplicación de prueba

Ejecute el archivo ejecutable de prueba con --help para enumerar las opciones disponibles para el conjunto de extensiones actual.

Para obtener diagnósticos avanzados de proveedores y opciones registrados, ejecute con --info.

Consulte también

• Introducción a MTP
• Características de MTP
• Pruebas con dotnet test