Groovy Script Formatter

Propósito e alcance. Esta ferramenta formata scripts Groovy seguindo um estilo consistente que reflete convenções Groovy e Java inspiradas. Destina-se a desenvolvedores, revisores de código e pipelines de automação que exigem formatação repetível sem alterar a semântica. O formatter atua sobre o texto-fonte e produz uma saída bem estruturada sem alterar o comportamento de tempo de execução. Suporta construções Groovy padrão, closures, maps e strings multilinha, bem como chamadas encadeadas de métodos. Conceitualmente, ele normaliza espaços, ajusta a profundidade de indentação, quebra linhas longas e preserva comentários e literais de string. O valor central é reduzir disputas de formatação, melhorar a legibilidade e possibilitar alterações diff-friendly entre equipes. Casos de uso típicos incluem preparar código para pull requests, documentar exemplos e impor padrões de formatação da equipe em CI. Funções-chave incluem indent_size configurável, max_line_length e perfis que refletem convenções Groovy; regras avançadas permitem controle sobre parênteses, formatação de closures e alinhamento de maps/collections. A abordagem algorítmica é sensível à linguagem e usa fluxos de token para detectar blocos, closures e fronteiras sintáticas, preservando comentários e literais. Suporta formatação incremental de grandes arquivos, com saída determinística e uma pré-visualização antes da aplicação. Extensões incluem verificações de compatibilidade com linters Groovy comuns e reutilização fácil via arquivos de configuração do projeto. A ferramenta não altera o comportamento de runtime nem a semântica e foca apenas na apresentação.