No description
  • Rust 90.3%
  • Shell 9.7%
Find a file
Jonatas Oliveira 238fc62088
All checks were successful
ci/woodpecker/push/pipelines Pipeline was successful
fix(hooks): consertar onde o teste de mutação grava e onde ele compila
Duas correções no `mutacao()`, ambas descobertas rodando o hook nos quinze
repositórios.

`--output .`: o cargo-mutants grava o `mutants.out` na raiz do WORKSPACE,
não no diretório de onde foi chamado. Nos repositórios que também são
membros de um workspace maior o relatório ia parar um nível acima, fora do
repositório, e a checagem do teto não achava o arquivo -- reprovando um
crate que não tinha deixado nenhum mutante escapar (o battleship-common
foi reprovado assim, com 65 mutantes e 0 sobreviventes).

TMPDIR no disco: o cargo-mutants copia a árvore e compila a cópia no
TMPDIR, que aqui é /tmp em tmpfs -- memória. Uma árvore de build do `iced`
dentro dele esgotou a RAM da máquina. O scratch passa a ficar em
~/.cache/cargo-mutants, com CARGO_MUTANTS_TMPDIR para quem quiser outro
lugar.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PhdPjHUuVhXaitwT4mG53t
2026-09-05 12:56:40 +02:00
.cargo refactor: hold only this crate, and stand on its own 2026-09-03 13:28:26 +02:00
.githooks fix(hooks): consertar onde o teste de mutação grava e onde ele compila 2026-09-05 12:56:40 +02:00
.woodpecker ci: tirar a mutação do pipeline e rodar o CI inteiro no pre-commit 2026-09-05 07:36:34 +02:00
src ci: tirar a mutação do pipeline e rodar o CI inteiro no pre-commit 2026-09-05 07:36:34 +02:00
tests refactor: hold only this crate, and stand on its own 2026-09-03 13:28:26 +02:00
.gitignore refactor: hold only this crate, and stand on its own 2026-09-03 13:28:26 +02:00
.mutants-teto refactor: hold only this crate, and stand on its own 2026-09-03 13:28:26 +02:00
Cargo.toml refactor: hold only this crate, and stand on its own 2026-09-03 13:28:26 +02:00
LICENSE docs: add a README and the GPLv3 licence text 2026-09-01 22:20:42 +02:00
README.md ci: tirar a mutação do pipeline e rodar o CI inteiro no pre-commit 2026-09-05 07:36:34 +02:00

battleship-common

Tipos, regras e protocolo do Batalha Naval. É a biblioteca compartilhada: o servidor e o cliente dependem dela para concordar sobre o que aconteceu no tabuleiro, e nenhum dos dois reimplementa regra nenhuma.

Vale saber por que ela existe assim. Havia três cópias destes tipos — uma no servidor, outra em src/common.rs do cliente, e esta, com testes, que ninguém usava. As cópias divergiram (Empty de um lado, Water do outro; envelopes de mensagem incompatíveis; eixos trocados) e o jogo parou de funcionar ponta a ponta, com as duas suítes passando. Este crate é a resposta a isso.

cargo test
cargo mutants        # teto de sobreviventes em .mutants-teto

Onde ele se encaixa

Este repositório contém só a biblioteca e é compilável sozinho. Ele também entra como submódulo no repositório battleship, que junta os três crates num workspace — é lá que se roda o jogo inteiro.

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 90%) e auditoria de dependências.

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.

Licença

GPL-3.0-or-later. Veja LICENSE.