Partilhar via

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

Este artigo apresenta um ponto de entrada central para as opções de linha de comandos do Microsoft.Testing.Platform.

Opções da plataforma

  • @

    Especifica o nome do arquivo de resposta. O nome do ficheiro de resposta deve seguir imediatamente o @ carácter, sem espaço em branco entre o @ carácter e o nome do ficheiro de resposta.

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

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

    onde filter.rsp pode conter 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 parser de linha de comandos do SDK utiliza uma abordagem token por linha, onde cada linha no ficheiro de resposta é tratada como um único token. Nesse caso, cada argumento deve estar numa linha separada:

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

  • --config-file

    Especifica um arquivo testconfig.json.

  • --diagnostic

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

  • --diagnostic-synchronous-write

    Força o registrador de arquivos interno 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). Isto atrasa a 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 é gerado no diretório TestResults padrão.

  • --diagnostic-file-prefix

    O prefixo do nome do ficheiro de log. O padrão é "log".

  • --diagnostic-verbosity

    Defina 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 se o processo associado for encerrado. PID deverá 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

    Apresenta informações avançadas sobre a Aplicação de Teste .NET, tais como:

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

    Esse 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

    Listar testes disponíveis. Os testes não serão realizados.

  • --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 da estrutura implementem o recurso 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 Microsoft.Testing.Platform.

    Observação

    Esse recurso está disponível em 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 onde os resultados do 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

    Tempo limite global para a execução de testes. Usa um argumento como cadeia de caracteres no formato <value>[h|m|s] onde <value> é flutuante.

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

Use a tabela seguinte para encontrar rapidamente opções de extensão.

Scenario Documentação de funcionalidades
Coletar cobertura de código Cobertura do código
Colecionar despejos de crash e hang Despejos de colisão e suspensão
Gerar relatórios de teste (por exemplo, TRX) Relatórios de testes
Personalizar a saída do terminal Saída terminal
Aplicar controlos ao nível do host Hot Reload
Repetir testes que falharam Repetir
Executar testes que utilizem Microsoft Fakes Microsoft Fakes
Emitir rastros e métricas OpenTelemetry OpenTelemetria

Descobrir opções na sua aplicação de teste

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

Para executar diagnósticos avançados dos prestadores e das opções registados, utilize o comando --info.

Consulte também

  • Last updated on