No description
  • Rust 85.6%
  • Shell 14.4%
Find a file
Jonatas Oliveira de9208abb3
All checks were successful
ci/woodpecker/push/pipelines Pipeline was successful
fix(hooks): reprovar quando o teste de mutação não gera mutante nenhum
Um teto sobre zero mutantes aprova sem medir. Foi o que aconteceu no
battleship-client: as exclusões do .cargo/mutants.toml cobriam o crate
inteiro, o cargo-mutants dizia "Found 0 mutants" e a checagem imprimia
`sobreviventes=0 teto=0` -- que se lê como perfeição e significa silêncio.
O hook levava 2 segundos e não verificava nada.

Agora, se a soma de caught, missed, unviable e timeout for zero, a etapa
falha e diz o que fazer: encolher as exclusões ou remover o
.mutants-teto. Um portão que aprova sem medir é pior do que portão
nenhum, porque dá a impressão de cobertura que não existe.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PhdPjHUuVhXaitwT4mG53t
2026-09-08 07:08:37 +02:00
.cargo ci: give this crate a pipeline of its own 2026-09-03 13:28:26 +02:00
.githooks fix(hooks): reprovar quando o teste de mutação não gera mutante nenhum 2026-09-08 07:08:37 +02:00
.woodpecker ci: tirar a mutação do pipeline e rodar o CI inteiro no pre-commit 2026-09-05 08:01:24 +02:00
src build(deps): upgrade to Rust 1.98, edition 2024 and latest crates 2026-09-01 21:12:43 +02:00
tests ci: tirar a mutação do pipeline e rodar o CI inteiro no pre-commit 2026-09-05 08:01:24 +02:00
.gitignore ci: give this crate a pipeline of its own 2026-09-03 13:28:26 +02:00
.mutants-teto test: add property-based and mutation-guard suites 2026-09-01 21:12:43 +02:00
Cargo.toml ci: give this crate a pipeline of its own 2026-09-03 13:28:26 +02:00
LICENSE build: inherit package metadata from the workspace 2026-09-01 22:20:49 +02:00
README.md ci: tirar a mutação do pipeline e rodar o CI inteiro no pre-commit 2026-09-05 08:01:24 +02:00

server

Servidor do RPG ASCII Tático: API HTTP + WebSocket em axum, partidas guardadas em memória.

cargo run     # sobe em :3000
cargo test

As regras não moram aqui. Elas vêm de tatic_lib, declarada como dependência git — é o que permite compilar este repositório sozinho, sem o diretório irmão por perto.

tests/mutantes sobe o servidor de verdade numa porta efêmera e conecta um cliente real: todo o caminho do WebSocket não era aberto por teste nenhum até o cargo mutants mostrar isso.

Onde ele se encaixa

Este repositório contém só o servidor. Ele também entra como submódulo no repositório tactic, que junta os três crates num workspace; lá o [patch] da raiz redireciona tatic_lib para a cópia local, e a compilação integrada usa o código do diretório ao lado em vez da ponta de main.

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 95%) 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.