Caça-Palavras em Rust com Ratatui

Estrutura do Projeto

word_search/
├── Cargo.toml
├── src/
│   ├── main.rs
│   ├── game.rs
│   ├── grid.rs
│   ├── ui.rs
│   └── error.rs
├── tests/
│   └── integration_tests.rs
└── words.txt

run_tests.sh

#!/bin/bash

echo "🧪 Executando testes do Caça-Palavras..."
echo "=================================="

echo "📋 Testes unitários:"
cargo test unit_tests --verbose

echo ""
echo "🔧 Testes de integração:"
cargo test integration_tests --verbose

echo ""
echo "📊 Relatório de cobertura dos testes:"
cargo test --verbose

echo ""
echo "✅ Todos os testes concluídos!"

Verificação de Documentação:

# Testa exemplos na documentação
cargo test --doc

Controles

• Setas (↑↓←→): Mover cursor
• SPACE: Selecionar/deselecionar posição
• ENTER: Confirmar seleção atual
• C: Limpar seleção atual
• Q/ESC: Sair do jogo

Verificações antes do commit

O .githooks/pre-commit roda aqui o que o Woodpecker roda no servidor. Ele é gerado a partir do .woodpecker/pipelines.yml deste repositório, então os comandos não podem divergir do CI. Ative uma vez por clone -- o hook é versionado, a configuração que aponta para ele não é:

git config core.hooksPath .githooks

Roda tudo a cada git commit, do mais barato ao mais caro, e para no primeiro que falhar: lint do pipeline, cargo fmt --check, clippy com -D warnings, build, testes, cobertura (piso 96%), auditoria de dependências e a perna MSRV 1.90.

O teste de mutação só existe aqui. Ele saiu do pipeline: mutação recompila o crate uma vez por mutante, e no runner isso eram dezenas de minutos por push, num passo que ninguém acompanha enquanto espera. O teto continua em .mutants-teto, versionado -- a regra não afrouxou, mudou de lugar. É de longe a etapa mais lenta; para pular só ela:

PRE_COMMIT_SEM_MUTACAO=1 git commit ...

Para pular tudo, git commit --no-verify. Um hook que não se pode pular é um hook que todo mundo desativa.