zig fmt: formate seu código

O Zig inclui um formatador integrado para que todos os projetos tenham a mesma aparência. O comando zig fmt reescreve seu código no estilo canônico do Zig.

Aponte zig fmt para um arquivo e ele o reformata diretamente no disco, corrigindo a indentação, os espaços e as quebras de linha para você.

Forneça um diretório e o zig fmt percorrerá tudo recursivamente, organizando cada arquivo .zig encontrado. Um comando formata um projeto inteiro.

Não há opções de estilo para discutir. O Zig fmt tem um único estilo fixo, o que encerra os debates sobre formatação em todas as equipes e bases de código.

A opção --check informa quais arquivos não estão formatados e termina com um erro, mas nunca edita nada. Perfeito para verificações.

Como --check retorna um código de saída indicando falha, você pode integrá-lo à integração contínua para rejeitar automaticamente qualquer código não formatado.

Use --stdin e o zig fmt formatará o texto canalizado para ele e imprimirá o resultado. Os editores usam isso para formatar ao salvar.

A maioria dos editores executa o zig fmt automaticamente quando você salva. Seu código se organiza instantaneamente, para que você não precise mais pensar na disposição.

Lembre-se do escopo: o zig fmt corrige apenas a disposição. Ele não renomeia elementos nem detecta erros de lógica; essa é a função do compilador.

O zig fmt geralmente deixa intactas as suas quebras de linha em literais e comentários, limpando a estrutura sem apagar uma disposição intencional.

Execute o formatador antes de cada commit. Diferenças limpas e consistentes tornam as revisões mais rápidas e mantêm todo o histórico legível para todos.

Na CI, você quer fazer a compilação falhar quando o código não estiver formatado, sem modificar nenhum arquivo. Qual comando funciona?

Você conheceu o zig fmt: um estilo canônico, formatação de arquivos ou pastas, --check para CI e formatação ao salvar no editor para manter o código limpo sem esforço. 🧹