Referência de opções da CLI do Microsoft.Testing.Platform

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

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.

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

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

  Liste os testes disponíveis. Os testes não serão executados.

• --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 Códigos de saída de Microsoft.Testing.Platform.

  Observação

  Esse recurso está disponível no Microsoft.Testing.Platform 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.

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

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

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

Scenario	Documentação da funcionalidade
Coletar cobertura de código	Cobertura de código
Coletar dumps de crash ou travamento	Despejos de travamento e congelamento
Gerar relatórios de teste (por exemplo, TRX)	Relatórios de teste
Personalizar a saída do terminal	Saída do terminal
Aplicar controles de nível de hospedagem	Hot Reload
Repetir testes com falha	Tentar novamente
Executar testes que usam os Microsoft Fakes	Microsoft Fakes
Emitir rastreamentos e métricas do OpenTelemetry	OpenTelemetry

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 de Microsoft.Testing.Platform
• Recursos do Microsoft.Testing.Platform
• Testando com dotnet test