Referencia de las opciones de la CLI de Microsoft.Testing.Platform

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

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.

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

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

  Enumerar las pruebas disponibles. Las pruebas no se ejecutarán.

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

  Nota:

  Esta característica está disponible en Microsoft.Testing.Platform 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.

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

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 Microsoft.Testing.Platform
• Características de Microsoft.Testing.Platform
• Pruebas con dotnet test