Microsoft.Testing.Platform (MTP) referência de opções da interface de linha de comando (CLI)

Este artigo fornece um ponto de entrada central para opções de linha de comando MTP.

Opções de plataforma

• @

  Especifica o nome do arquivo de resposta. O nome do arquivo de resposta deve seguir imediatamente o @ caractere sem espaço em branco entre o @ caractere e o nome do arquivo de resposta.

  As opções em um arquivo de resposta são interpretadas como se estivessem presentes naquele lugar na linha de comando. Você não pode usar o caractere de barra invertida \ para concatenar linhas. O uso de um arquivo de resposta ajuda para comandos muito longos que podem exceder os limites de terminal. Você pode combinar um arquivo de resposta com argumentos de linha de comando embutidos. Por exemplo:

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

  em que filter.rsp pode ter o seguinte conteúdo:

  --filter "A very long filter"
  

  Ou um único arquivo rsp pode ser usado para especificar o tempo limite e o filtro da seguinte maneira:

  ./TestExecutable.exe @"arguments.rsp"
  

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

  Observação

  Ao usar dotnet test, o analisador de linha de comando do SDK usa uma abordagem token por linha em que cada linha no arquivo de resposta é tratada como um único token. Nesse caso, cada argumento deve estar em uma linha separada:

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

• --config-file

  Especifica um arquivo testconfig.json.

• --debug

  Pausa a execução do teste na inicialização para que você possa anexar um depurador ao processo de teste. Equivalente a configurar a TESTINGPLATFORM_WAIT_ATTACH_DEBUGGERvariável de ambiente como 1. Não há suporte em plataformas de navegador.

  Observação

  Essa opção está disponível no MTP a partir da versão 1.9.0. Ele substitui a opção anterior --debug-wait-attach (introduzida no MTP 1.6.0); o nome antigo foi removido e não deve mais ser usado.

• --diagnostic

  Habilita o log de diagnóstico. O nível de log padrão é Trace. O arquivo é escrito no diretório de saída com o seguinte formato de nome, log_[MMddHHssfff].diag.

• --diagnostic-synchronous-write

  Força o logger de arquivos embutido a gravar logs de forma síncrona. Útil para cenários em que você não deseja perder nenhuma entrada de log (se o processo falhar). Isso reduz a velocidade da execução do teste.

• --diagnostic-output-directory

  O diretório de saída do log de diagnóstico, se não for especificado, o arquivo será gerado no diretório padrão TestResults.

• --diagnostic-file-prefix

  O prefixo do nome do arquivo de log. Usa "log" como padrão.

• --diagnostic-verbosity

  Define o nível de detalhamento quando a opção --diagnostic é usada. Os valores disponíveis são Trace, Debug, Information, Warning, Errorou Critical.

• --exit-on-process-exit

  Saia do processo de teste quando o processo dependente for encerrado. O PID deve ser fornecido.

• --filter-uid

  Filtra os testes a serem executados pelos seus UIDs de nó de teste. Aceita um ou mais UIDs.

  Observação

  Essa opção está disponível no MTP a partir da versão 1.8.0.

• --help

  Imprime uma descrição de como usar o comando.

• --ignore-exit-code

  Permite que alguns códigos de saída diferentes de zero sejam ignorados e, em vez disso, retornados como 0. Para obter mais informações, consulte Ignorar códigos de saída específicos.

• --info

  Exibe informações avançadas sobre o aplicativo de teste .NET, como:

  • A plataforma.
  • O ambiente.
  • Cada provedor de linha de comando registrado, como name, version, description e options.
  • Cada ferramenta registrada, como command, name, version e description, e todos os provedores de linha de comando.

  Este recurso é usado para entender as extensões que estariam registrando a mesma opção de linha de comando ou as alterações nas opções disponíveis entre várias versões de uma extensão (ou da plataforma).

• --list-tests

  Lista os testes disponíveis sem executá-los. Opcionalmente, usa um argumento que controla o formato de saída: text (padrão, legível por humanos) ou json.

  Observação

  O json formato de saída está disponível no MTP a partir da versão 2.3.0.

• --maximum-failed-tests

  Especifica o número máximo de falhas de testes que, quando atingidas, interromperão a execução do teste. O suporte para essa opção requer que os autores do framework implementem a funcionalidade IGracefulStopTestExecutionCapability. O código de saída ao atingir essa quantidade de falhas de teste é 13. Para obter mais informações, consulte os códigos de saída do MTP.

  Observação

  Esse recurso está disponível no MTP a partir da versão 1.5.

• --minimum-expected-tests

  Especifica o número mínimo de testes que devem ser executados. Por padrão, espera-se que pelo menos um teste seja executado.

• --no-banner

  Desabilita o banner de inicialização, a mensagem de copyright e o banner de telemetria. O mesmo efeito pode ser obtido por meio do TESTINGPLATFORM_NOBANNER ou das DOTNET_NOLOGOvariáveis de ambiente.

• --results-directory

  O diretório em que os resultados de teste serão colocados. Se o diretório especificado não existir, ele será criado. O padrão é TestResults no diretório que contém o aplicativo de teste.

• --timeout

  Um tempo limite global de execução de teste. Usa um argumento como string no formato <value>[h|m|s], em que <value> é flutuante.

• --treenode-filter

  Filtra os testes a serem executados usando uma expressão de filtro de árvore. Os filtros de árvore oferecem correspondências mais avançadas do que --filter para cenários avançados.

Opções de extensão por cenário

Use a tabela a seguir para localizar rapidamente as opções de extensão.

Descobrir opções em seu aplicativo de teste

Execute o executável de teste com --help para listar as opções disponíveis para seu conjunto de extensões atual.

Para diagnóstico avançado de provedores e opções registrados, execute com --info.

Consulte também

• Visão geral do MTP
• Recursos do MTP
• Testando com dotnet test