Freemarker Template Formatter

Freemarker Template Formatter traite les sources FTL pour produire une mise en page cohérente et lisible sans modifier la sémantique des templates. Il s’adresse aux développeurs et aux équipes de templating qui gèrent de vastes bases de code avec de nombreux contributeurs. L’outil accepte des templates Freemarker bruts, analyse les éléments structurels tels que les directives, les définitions de macros et les blocs imbriqués, et applique un style uniforme aux espaces, à l’indentation et aux sauts de ligne. En normalisant ces aspects, les diffs deviennent plus faciles à relire et les révisions moins sujettes à erreurs, notamment dans les pipelines CI ou lors de l’intégration de nouveaux membres d’équipe.
Il utilise un parseur Freemarker-aware pour identifier des blocs comme <#if>, <#list> et <#macro>, en préservant leur contenu tout en réorganisant les espaces environnants. Le formatter prend en charge des largeurs d’indentation configurables (2 ou 4 espaces), une longueur maximale de ligne et un enlèvement optionnel des attributs. Il conserve les commentaires, les littéraux de chaîne et les expressions d’interpolation, et évite de modifier les expressions d’exécution. Les utilisateurs avancés peuvent activer ou désactiver l’enroulement des attributs, décider s’il faut conserver les lignes vides et générer un diff côte à côte pour revue.
Les cas d’utilisation incluent le formatage avant commit, les vérifications CI et le nettoyage en masse des templates hérités sur plusieurs services. L’outil est particulièrement précieux pour les applications web Java qui s’appuient sur Freemarker pour le rendu côté serveur, permettant des templates cohérents entre modules et réduisant les conflits de fusion. Sa valeur réside dans un formatage sensible au domaine qui respecte la sémantique Freemarker tout en offrant des valeurs par défaut pragmatiques et des options de personnalisation.