Freemarker Template Formatter

Freemarker Template Formatter processa fontes FTL para produzir um layout consistente e legível sem alterar a semântica dos modelos. Destina-se a desenvolvedores e equipes de templating que mantêm grandes bases de código com muitos colaboradores. A ferramenta aceita modelos Freemarker brutos, analisa elementos estruturais como diretivas, definições de macro e blocos aninhados, e aplica um estilo uniforme a espaços em branco, indentação e quebras de linha. Ao normalizar esses aspectos, diffs tornam-se mais fáceis de revisar e revisões menos propensas a erros, especialmente em pipelines CI ou ao incorporar novos membros da equipe.
Ela utiliza um parser Freemarker-aware para identificar blocos como <#if>, <#list> e <#macro>, preservando seu conteúdo enquanto reordena os espaços ao redor. O formatter suporta larguras de indentação configuráveis (2 ou 4 espaços), um comprimento máximo de linha e quebra opcional de atributos. Mantém comentários, literais de string e expressões de interpolação, e não altera expressões em tempo de execução. Usuários avançados podem ativar ou desativar a quebra de atributos, decidir se devem manter linhas em branco e gerar um diff lado a lado para revisão.
Casos de uso incluem formatação pré-commit, verificações CI e limpeza em massa de modelos legados entre serviços. A ferramenta é especialmente útil para aplicações web Java que utilizam Freemarker para renderização no servidor, permitindo modelos consistentes entre módulos e reduzindo conflitos de merge. Seu valor único vem de uma formatação orientada ao domínio que respeita a semântica Freemarker, oferecendo padrões pragmáticos e opções de personalização.