qrcode-testing

name	qrcode-testing
description	What: Guia para testes unitários do QRCoder.Core usando xUnit, Shouldly e coverlet. When: Ao escrever testes, aumentar cobertura, debugar falhas de teste, ou configurar test runners. Do NOT: Não usar para desenvolvimento de features (ver qrcode-development) ou CI/CD.

Contexto

QRCoder.Core usa xUnit como framework de testes, Shouldly para assertions legíveis, e coverlet para cobertura de código. Os testes estão em QRCoder.Core.Tests/.

Atuação

Estrutura de Testes

QRCoder.Core.Tests/
├── Generators/         # Testes do QRCodeGenerator
├── Renderers/          # Testes por renderizador
├── Extensions/         # Testes de extensões
├── Models/             # Testes de modelos
├── Exceptions/         # Testes de exceções
├── Helpers/            # Utilitários de teste
└── assets/             # Arquivos de referência (imagens, SVGs)

Padrões

• BDD em português: Dado/Quando/Então
• Uma assertion por teste quando possível
• Testes de renderização: comparar output com referência em assets/
• Testar todos os níveis ECC: L, M, Q, H

Comandos

# Todos os testes
dotnet test QRCoder.Core.sln --configuration Release

# Com cobertura
dotnet test QRCoder.Core.sln --collect:"XPlat Code Coverage"

# Apenas net10.0 (Linux)
dotnet test QRCoder.Core.Tests/ -f net10.0

# Teste específico
dotnet test --filter "FullyQualifiedName~QRCodeGeneratorTests"

Restrições

• Não modificar testes existentes para forçar passagem
• Testes net48 não rodam em Linux (sem Windows Desktop)
• Cobertura não pode diminuir (baseline: 78%)
• Não commitar arquivos de TestResults

Exemplos

[Fact]
public void Dado_TextoValido_Quando_GerarQRCode_Entao_DeveRetornarDadosValidos()
{
    var generator = new QRCodeGenerator();
    var data = generator.CreateQrCode("Test", QRCodeGenerator.ECCLevel.M);
    data.ShouldNotBeNull();
    data.ModuleMatrix.ShouldNotBeEmpty();
}