Compartir a través de

Opciones de comando de Te.exe

  • Artículo

Uso

<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] [/ pppaware ] [/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>]

Comandos de selección y ejecución

test_binaries

Especifique uno o varios archivos de prueba que se van a ejecutar (separados por espacios). Se admite el uso de caracteres comodín.

te.exe test1.dll

Interpretación: ejecute todas las pruebas en test1.dll.

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

Interpretación: ejecute todas las pruebas en test1.dll, test2.dll y test3.dll.

te.exe *.dll

Interpretación: ejecute todas las pruebas en todos los archivos DLL del directorio actual.

/coloredConsoleOutput:<true/false>

Especifica si TAEF debe generar texto de consola coloreado o no. El valor predeterminado es true. Si se establece en false, TAEF generará todo el texto con el color de consola predeterminado.

te.exe test1.dll /coloredConsoleOutput:false

/console:<optionName>=<value>

Proporciona opciones para configurar el uso de TE de la consola. Están disponibles las opciones siguientes:

/console:flushWrites

Hace que la salida de la consola se vacíe después de escribir cada línea: resulta útil cuando se ha redirigido la salida de TE.exe.

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

Establece la posición (en píxeles) de la ventana de consola en relación con la esquina del monitor principal. Use un valor actual para especificar que la posición de la consola actual debe almacenarse y usarse al reanudar desde el reinicio.

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

Establece el tamaño de la ventana de consola (en dimensiones de caracteres). El tamaño del búfer de pantalla se aumentará para que coincida con el tamaño de la ventana si es necesario. Use un valor actual para especificar que el tamaño de la consola actual debe almacenarse y usarse al reanudar desde el reinicio.

/console:topmost

Mantiene la consola en ejecución te.exe "topmost" en el orden z del escritorio durante la ejecución.

/pppaware

Ejecuta pruebas en un proceso marcado como compatible con PPP, consulte Valores altos de PPP. Esto también se puede establecer a través de metadatos ("DpiAware").

/inproc

Ejecute todas las pruebas dentro del propio proceso de TE.exe en lugar de dentro de TE. ProcessHost.exe.

te.exe test1.dll /inproc

Nota:

TE solo admite la ejecución de un archivo DLL de prueba a la vez cuando se usa la configuración /inproc .

/isolationLevel:<Level>

Especifica el nivel mínimo de aislamiento que se va a usar al ejecutar pruebas DE TAEF. Si este valor entra en conflicto con isolationLevel especificado como metadatos, el valor se convierte en el nivel de aislamiento con el ámbito más estricto. Consulte Aislamiento de prueba para obtener más detalles.

te.exe test1.dll /isolationLevel:Class

/labMode

Ejecuta pruebas y quita la interfaz de usuario de bloqueo potencial (por ejemplo, Informe de errores de Windows diálogos en pruebas de bloqueo).

/list

Enumera los nombres de todos los test_binaries y las clases y métodos dentro de ellos. Si se especifican criterios de selección, solo se enumeran los nombres de los que cumplen los criterios.

 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

Enumera los nombres y propiedades de todos los test_binaries y las clases y métodos en ellos junto con los nombres de función Setup y Teardown, si están disponibles. Si se especifican criterios de selección, solo se enumeran los nombres de los que cumplen los criterios.

 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 selección basada en nombres de prueba es una alternativa sencilla a "/select:@Name='<testname>'". El <nombre de prueba> todavía puede contener caracteres comodín ("*" y "?"), pero no debe incluirse entre comillas simples. Si se especifican /select y /name en el símbolo del sistema, /select query tiene prioridad y /name se omite.

te.exe test1.dll /name:*TestToLower

Interpretación: ejecute todas las pruebas en test1.dll donde los nombres de método terminan con "TestToLower". Lo mismo se puede representar mediante criterios de selección como /select:@Name='*TestToLower'.

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

Interpretación: ejecute todas las pruebas en test1.dll que contengan la frase "StringTest" en su espacio de nombres, clase o nombre de método.

/outputFolder:<folderName>

Especifica una carpeta para colocar todos los archivos generados. El valor predeterminado es el directorio actual. Puede usar variables de entorno, por ejemplo:

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

/p:<ParamName>=<ParamValue>

Define un parámetro en tiempo de ejecución con parameter name=ParamName y parameter value=ParamValue. Estos parámetros son accesibles desde un método de prueba o métodos de instalación o limpieza.

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

Puede obtener x como uno de varios tipos admitidos en el código de prueba. Por ejemplo, aquí puede ver que lo recuperamos como int y WEX::Common::String:

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

Para obtener más información, visite el TAEF. Página de ayuda parámetros en tiempo de ejecución.

/paralelo

Ejecuta pruebas en paralelo en varios procesadores. Las pruebas deben participar en la ejecución en paralelo marcandose con los metadatos "Parallel".

te.exe test1.dll /parallel

Para obtener más información, visite la página de ayuda de Parallel .

/persistPictResults

Almacena en caché los resultados generados por PICT.exe para las pruebas que usan PICT DataSource en la ejecución actual. La ejecución de pruebas posterior intentará utilizar los resultados almacenados en caché como en la ejecución de PICT.exe en el mismo modelo y archivos de inicialización.

/pict:<OptionName>=<OptionValue>

Proporciona opciones para controlar PICT.exe cuando se llama a las pruebas mediante un dataSource PICT. Al establecer una de estas opciones, actualmente se invalidan todos los metadatos asociados en el código. Están disponibles las opciones siguientes:

/Pict:Order=3
Establece el orden de las combinaciones pasando el valor a través de la opción de comando /o para PICT.exe.

/Pict:ValueSeparator=;
Establece el separador de valores pasando el valor a través de la opción de comando /d para PICT.exe.

/Pict:AliasSeparator=+
Establece el separador de alias pasando el valor a través de la opción de comando /a para PICT.exe.

Pict:NegativeValuePrefix=!
Establece el prefijo de valor negativo pasando el valor a través de la opción de comando /n para PICT.exe.

/Pict:SeedingFile=test.seed
Establece la ruta de acceso al archivo de propagación pasando el valor a través de la opción de comando /e para PICT.exe.

/Pict:Random=true
Activa o desactiva la aleatoriedad en los resultados de PICT y hace que el origen de datos PICT registre la inicialización aleatoria que se usó.

/Pict:RandomSeed=33
Establece la inicialización aleatoria pasando el valor a través de la opción de comando /r para PICT.exe. Si establece esta opción, se activará Pict:Random a menos que Pict:Random esté establecido explícitamente en false.

/Pict:CaseSensitive=true
Cuando se establece en true, activa la distinción entre mayúsculas y minúsculas pasando la opción de comando /c a PICT.exe.

/Pict:Timeout=00:01:30
Establece el tiempo de espera para que PICT.exe finalice antes de matar su proceso. El valor tiene el formato [Day.] Hour[:Minute[:Second[. FractionalSeconds]]].

/runas:<RunAsType>

Ejecuta pruebas en el entorno especificado. Consulte la documentación de RunAs para obtener información detallada sobre el uso.

te.exe *.dll /runas:System

Interpretación: ejecute todas las pruebas como Sistema.

te.exe *.dll /runas:Elevated

Interpretación: ejecute todas las pruebas como un usuario con privilegios elevados.

te.exe *.dll /runas:Restricted

Interpretación: ejecute todas las pruebas como un usuario sin privilegios elevados.

te.exe *.dll /runas:LowIL

Interpretación: ejecute todas las pruebas en un proceso de integridad baja.

/runIgnoredTests

Ejecuta o enumera (si está junto con /list o /listProperties) todas las pruebas, incluidas las clases de prueba y los métodos de prueba con metadatos "Ignore" establecidos en "true". De forma predeterminada, las clases de prueba y los métodos de prueba con metadatos "Ignore" establecidos en "true" se omiten durante la ejecución y durante la lista.

/runon:<MachineName>

Ejecuta pruebas de forma remota en el equipo especificado. TAEF autentica, autoriza e implementa los archivos binarios necesarios para ejecutar las pruebas y registra toda la información en la consola de origen. Consulte la documentación de ejecución de pruebas entre máquinas para obtener información detallada sobre el uso.

te.exe *.dll /runon:TestMachine1

Interpretación: ejecute todas las pruebas de forma remota en "TestMachine1".

/select:<query>

Criterios de selección que se usarán al seleccionar pruebas de cada binario de prueba. Los criterios de selección se componen de uno o varios de los siguientes:

@[nombre de propiedad] = [valor como cadena]

@[nombre de propiedad] >= [value as float or integer]

@[nombre de propiedad] > [value as float or integer]

@[nombre de propiedad] <= [value as float or integer]

@[nombre de propiedad] < [value as float or integer]

  • Los valores de propiedad como cadenas deben estar entre comillas simples.
  • Puede especificar un criterio de selección compuesto mediante "and", "or" y "not" (sin distinción entre mayúsculas y minúsculas).
  • Los valores de cadena de propiedad admiten caracteres comodín a través de caracteres "*" y "?".
  • En el caso de los valores float e enteros, el carácter "*" también se puede usar como "exists", pero no se puede usar para la coincidencia parcial. Por ejemplo: /select:"@Priority=*" es válido, pero /select:"@Priority=4*" no.

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

Interpretación: ejecute todas las pruebas en test1.dll donde los nombres de método terminan con "TestToLower" o donde el propietario es "C2" y donde Priority no es menor que 3.

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

Interpretación: ejecute todas las pruebas en test1.dll y test2.dll donde se haya especificado la prioridad en sus metadatos de prueba.

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

Interpretación: ejecute todas las pruebas en test1.dll que contengan la frase "StringTest" en su espacio de nombres, clase o nombre de método.

/sessionTimeout:<value>

Establece un tiempo de espera de sesión para toda la ejecución de Te.exe. Si expira el tiempo de espera, la sesión de prueba se anulará correctamente y el código de salida del proceso significará que se ha producido un tiempo de espera.

Nota:

El valor de tiempo de espera debe especificarse en el formato siguiente:

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

Nota:

Si se ejecuta en WTT, este valor se puede usar para asegurarse de que el archivo de registro de Wtt permanece intacto incluso si la sesión de TAEF agota el tiempo de espera.

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

La sesión de prueba completa agotará el tiempo de espera después de 5 segundos.

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

La sesión de prueba completa agotará el tiempo de espera después de 45 segundos.

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

La sesión de prueba completa agotará el tiempo de espera después de 20 minutos.

te.exe test1.dll /sessionTimeout:5

La sesión de prueba completa agotará el tiempo de espera después de 5 horas.

te.exe test1.dll /sessionTimeout:1.2

La sesión de prueba completa agotará el tiempo de espera después de 1 día y 2 horas.

/terminateOnFirstFailure

Finaliza la ejecución de la prueba la primera vez que se produce un error de prueba. Todas las operaciones de desmontaje para esa prueba se invocan, pero todas las pruebas posteriores se marcan como ignoradas. Debido a un problema conocido, es posible que las pruebas continúen ejecutándose al usar un modo de prueba.

te.exe test1.dll /terminateOnFirstFailure

/testDependencies:<files>

Especifica dependencias de prueba adicionales que se implementarán al usar la ejecución de pruebas entre máquinas. A menos que se proporcione una ruta de acceso completa, TAEF buscará en relación con el directorio actual, no con el directorio de prueba.

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

Interpretación: ejecute todas las pruebas de forma remota en "TestMachine1" y copie "test*.jpg" y "file1.doc" en la máquina remota antes de ejecutar las pruebas. Cada especificación de archivo puede contener caracteres comodín (test.txt; test*.dll; etc.) para que coincidan con uno o varios archivos.

/testTimeout:<value>

Establece un tiempo de espera de prueba global para toda la ejecución de Te.exe. Este valor invalida los metadatos de tiempo de espera de prueba que se pueden haber establecido para una prueba determinada que se está ejecutando.

Nota:

El valor de tiempo de espera debe especificarse en el formato siguiente:

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

Nota:

Se omitirá cuando se use junto con /inproc.

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

Cada método de prueba y configuración y limpieza agotará el tiempo de espera después de .5 segundos.

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

Cada método de prueba y configuración o limpieza agotará el tiempo de espera después de 45 segundos.

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

Cada método de prueba y configuración o limpieza agotará el tiempo de espera después de 20 minutos.

te.exe test1.dll /testTimeout:5

Cada método de prueba y configuración o limpieza agotará el tiempo de espera después de 5 horas.

te.exe test1.dll /testTimeout:1.2

Cada método de prueba y configuración/limpieza agotará el tiempo de espera después de 1 día y 2 horas.

/unicodeOutput:<true/false>

Cuando TE se canaliza a un archivo de texto, genera unicode de forma predeterminada. La única excepción a esto es si ha solicitado anexar a un archivo ANSII existente (a través de ">>").

Para invalidar este comportamiento, puede especificar /unicodeOutput:false. Esto obligará a TE a enviar siempre ANSII al archivo.

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

Configuración del registrador

/appendWttLogging

Cuando se habilita el registro de WTT, se anexa al archivo de registro en lugar de sobrescribirlo. Debe usarse junto con /enableWttLogging.

te.exe test1.dll /enableWttLogging /appendWttLogging

Creará o anexará a un archivo de registro denominado TE.wtl tras la finalización de la ejecución de la prueba.

/enableWttLogging

Habilita el registro WTT; Wttlog.dll debe estar disponible en la ruta de acceso.

te.exe test1.dll /enableWttLogging

Generará un archivo de registro denominado TE.wtl tras la finalización de la ejecución de la prueba.

/defaultAppDomain

Ejecuta pruebas administradas en el dominio de aplicación predeterminado.

te.exe managed.test1.dll /defaultAppDomain

/disableConsoleLogging

Deshabilita la salida del registro de consola; debe usarse junto con /enableWttLogging.

te.exe test1.dll /disableConsoleLogging /enableWttLogging

/logFile:<name>

Especifique un nombre que se usará como archivo de registro wtt; debe usarse junto con /enableWttLogging.

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

Generará un archivo de registro denominado myCustomeLogFile.xml tras la finalización de la ejecución de pruebas.

/logOutput:<mode>

Establece el nivel de salida del registrador. Los valores válidos son:

  • Alto: habilita algunas salidas de consola adicionales, como imprimir una marca de tiempo junto a cada seguimiento.
  • Bajo: emite solo eventos principales (inicio, grupo final, etc.) y errores. El archivo de registro incluye detalles de prioridad inferior que precede los errores para proporcionar contexto para los errores.
  • LowWithConsoleBuffering: igual que Low, pero incluye el contexto de errores tanto en el archivo de registro como en la salida de la consola.
  • Más bajo: igual que baja, pero la salida de la consola solo incluye errores, errores de prueba y el resumen de la ejecución.

/version

Genera información de versión detallada.

/wttDeviceString:<value>

Invalida completamente el WttDeviceString usado por WexLogger cuando inicializa WttLogger.

te.exe test1.dll /wttDeviceString:$Console

/wttDeviceStringSuffix:<value>

Anexa el valor especificado al WttDeviceString predeterminado usado por WexLogger cuando inicializa WttLogger. Se omite si también se especifica wttDeviceString .

te.exe test1.dll /wttDeviceStringSuffix:$Console

Configuración de depuración

/breakOnCreate

Se divide en el depurador antes de crear instancias de cada clase de prueba.

te.exe test1.dll /breakOnCreate

/breakOnError

Se divide en el depurador si se registra un error o un error de prueba.

te.exe test1.dll /breakOnError

/breakOnInvoke

Divide en el depurador antes de invocar cada método de prueba.

te.exe test1.dll /breakOnInvoke

/disableTimeouts

Deshabilita todos los tiempos de espera durante la ejecución. Esto puede ser útil durante la depuración para evitar un tiempo de espera cuando TAEF está esperando en la parte del programa que se está depurando.

te.exe test1.dll /disableTimeouts

/miniDumpOnError

Toma y registra un mini volcado si se produce un error o error de prueba.

te.exe test1.dll /miniDumpOnError

/miniDumpOnCrash

Toma y registra un mini volcado de memoria si se produce un bloqueo de prueba.

te.exe test1.dll /miniDumpOnCrash

/rebootStateFile

Habilita explícitamente la ejecución de pruebas de reinicio .

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

/reportLoadingIssue

Muestra un cuadro de diálogo de descripción de error cuando TAEF no puede cargar un archivo DLL de prueba. Solo se debe usar para investigar problemas de carga de archivos DLL de prueba nativos.

te.exe test1.dll /reportLoadingIssue

/screenCaptureOnError

Toma y registra una captura de pantalla si se produce un error o error de prueba.

te.exe test1.dll /screenCaptureOnError

/stackFrameCount:<value>

Especifica el número de marcos de pila que se van a mostrar al obtener pilas de llamadas. El valor predeterminado es 50.

te.exe test1.dll /stackFrameCount:100

/stackTraceOnError

Toma y registra un seguimiento de la pila si se produce un error de prueba o error.

te.exe test1.dll /stackTraceOnError

Modos de prueba

/testmode:Loop

Permite controlar la ejecución mediante dos variables Loop y LoopTest.

  • Bucle: controla cuántas veces se ejecuta toda la ejecución. Predeterminado en 1.
  • LoopTest: controla cuántas veces se ejecuta una prueba individual. El valor predeterminado es 10.

te.exe test1.dll /testmode:Loop

Interpretación: ejecute cada prueba en test1.dll 10 veces (valor predeterminado para LoopTest). La ejecución completa se ejecuta una vez (valor predeterminado para bucle).

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

Interpretación: ejecute todas las pruebas en test1.dll y test2.dll una vez (determinada por LoopTest). Toda la ejecución (todas las pruebas combinadas en test1.dll y test2.dll) se ejecutan 3 veces, según lo determinado por Loop.

/testmode:Stress

En el modo de prueba 'stress', TAEF ejecutará pruebas indefinidamente, hasta que se escriba Ctrl+C o hasta que se envíe un mensaje de WM_CLOSE a la ventana oculta de TAEF. /testmode:stress debe ejecutarse junto con /inproc.

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

Para obtener información detallada y otros parámetros admitidos en este modo, vea Modos de prueba.