Melhores Práticas do XUnit

Seu objetivo é me ajudar a escrever testes unitários eficazes com XUnit, cobrindo abordagens de teste padrão e baseadas em dados.

Configuração do Projeto

• Use um projeto de teste separado com a convenção de nomenclatura [ProjectName].Tests
• Referencie os pacotes Microsoft.NET.Test.Sdk, xunit e xunit.runner.visualstudio
• Crie classes de teste que correspondam às classes que estão sendo testadas (por exemplo, CalculatorTests para Calculator)
• Use comandos de teste do SDK do .NET: dotnet test para executar testes

Estrutura de Teste

• Nenhum atributo de classe de teste é necessário (ao contrário de MSTest/NUnit)
• Use testes baseados em fatos com o atributo [Fact] para testes simples
• Siga o padrão Arrange-Act-Assert (AAA)
• Nomeie testes usando o padrão MethodName_Scenario_ExpectedBehavior
• Use o construtor para configuração e IDisposable.Dispose() para desmontagem
• Use IClassFixture<T> para contexto compartilhado entre testes em uma classe
• Use ICollectionFixture<T> para contexto compartilhado entre várias classes de teste

Testes Padrão

• Mantenha os testes focados em um único comportamento
• Evite testar vários comportamentos em um único método de teste
• Use asserções claras que expressem a intenção
• Inclua apenas as asserções necessárias para verificar o caso de teste
• Torne os testes independentes e idempotentes (podem ser executados em qualquer ordem)
• Evite interdependências de teste

Testes Baseados em Dados

• Use [Theory] combinado com atributos de fonte de dados
• Use [InlineData] para dados de teste inline
• Use [MemberData] para dados de teste baseados em métodos
• Use [ClassData] para dados de teste baseados em classes
• Crie atributos de dados personalizados implementando DataAttribute
• Use nomes de parâmetros significativos em testes baseados em dados

Asserções

• Use Assert.Equal para igualdade de valor
• Use Assert.Same para igualdade de referência
• Use Assert.True/Assert.False para condições booleanas
• Use Assert.Contains/Assert.DoesNotContain para coleções
• Use Assert.Matches/Assert.DoesNotMatch para correspondência de padrões regex
• Use Assert.Throws<T> ou await Assert.ThrowsAsync<T> para testar exceções
• Use a biblioteca de asserções fluentes para asserções mais legíveis

Mocking e Isolamento

• Considere usar Moq ou NSubstitute junto com XUnit
• Faça mock de dependências para isolar unidades sob teste
• Use interfaces para facilitar o mocking
• Considere usar um contêiner de DI para configurações de teste complexas

Organização de Testes

• Agrupe testes por recurso ou componente
• Use [Trait("Category", "CategoryName")] para categorização
• Use "collection fixtures" para agrupar testes com dependências compartilhadas
• Considere usar "output helpers" (ITestOutputHelper) para diagnósticos de teste
• Pule testes condicionalmente com Skip = "reason" nos atributos fact/theory