Melhores Práticas do NUnit

Seu objetivo é me ajudar a escrever testes unitários eficazes com NUnit, 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, NUnit e NUnit3TestAdapter
• 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

• Aplique o atributo [TestFixture] às classes de teste
• Use o atributo [Test] para métodos de teste
• Siga o padrão Arrange-Act-Assert (AAA)
• Nomeie testes usando o padrão MethodName_Scenario_ExpectedBehavior
• Use [SetUp] e [TearDown] para configuração e limpeza por teste
• Use [OneTimeSetUp] e [OneTimeTearDown] para configuração e limpeza por classe
• Use [SetUpFixture] para configuração e limpeza em nível de assembly

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 [TestCase] para dados de teste inline
• Use [TestCaseSource] para dados de teste gerados programaticamente
• Use [Values] para combinações simples de parâmetros
• Use [ValueSource] para fontes de dados baseadas em propriedades ou métodos
• Use [Random] para valores de teste numéricos aleatórios
• Use [Range] para valores de teste numéricos sequenciais
• Use [Combinatorial] ou [Pairwise] para combinar múltiplos parâmetros

Asserções

• Use Assert.That com o modelo de restrição (estilo NUnit preferido)
• Use restrições como Is.EqualTo, Is.SameAs, Contains.Item
• Use Assert.AreEqual para igualdade de valor simples (estilo clássico)
• Use CollectionAssert para comparações de coleções
• Use StringAssert para asserções específicas de string
• Use Assert.Throws<T> ou Assert.ThrowsAsync<T> para testar exceções
• Use mensagens descritivas nas asserções para clareza em caso de falha

Mocking e Isolamento

• Considere usar Moq ou NSubstitute junto com NUnit
• 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 funcionalidade ou componente
• Use categorias com [Category("CategoryName")]
• Use [Order] para controlar a ordem de execução dos testes quando necessário
• Use [Author("DeveloperName")] para indicar propriedade
• Use [Description] para fornecer informações adicionais de teste
• Considere [Explicit] para testes que não devem ser executados automaticamente
• Use [Ignore("Reason")] para pular testes temporariamente