Freemarker Template Formatter

Freemarker Template Formatter verarbeitet FTL-Quellen, um ein konsistentes, lesbares Layout zu erzeugen, ohne die Semantik der Vorlagen zu verändern. Es richtet sich an Entwickler und Template-Teams, die an großen Codebasen mit vielen Mitwirkenden arbeiten. Das Tool akzeptiert rohe Freemarker-Vorlagen, analysiert Strukturelemente wie Direktiven, Makrodefinitionen und verschachtelte Blöcke, und wendet einen einheitlichen Stil auf Leerzeichen, Einrückung und Zeilenumbrüche an. Durch die Normalisierung dieser Aspekte werden Diffs leichter zu überprüfen und Revisionsanforderungen weniger fehleranfällig, insbesondere in CI-Pipelines oder beim Onboarding neuer Teammitglieder.
Es verwendet einen Freemarker-geeigneten Parser, um Blöcke wie <#if>, <#list> und <#macro> zu identifizieren, deren Inhalt beizubehalten und gleichzeitig angrenzende Leerzeichen neu zu formatieren. Der Formatter unterstützt konfigurierbare Einrückungsbreiten (2 oder 4 Leerzeichen), eine maximale Zeilenlänge und optionale Attributumbrüche. Kommentare, Zeichenketten und Interpolationsausdrücke bleiben unverändert, und Laufzeit-Ausdrücke werden nicht verändert. Fortgeschrittene Benutzer können Attributumbrüche ein- oder ausschalten, entscheiden, ob leere Zeilen beibehalten werden sollen, und einen Seiten-zu-Seite-Diff zur Überprüfung generieren.
Anwendungsfälle umfassen Pre-Commit-Formatierung, CI-Prüfungen und Massenbereinigung alter Vorlagen über Dienste hinweg. Das Tool ist besonders wertvoll für Java-Web-Apps, die Freemarker für serverseitiges Rendering verwenden, da es konsistente Vorlagen über Module hinweg ermöglicht und Merge-Konflikte reduziert. Sein einzigartiger Wert liegt in einer domänenbewussten Formatierung, die Freemarker-Semantik respektiert und pragmatische Standardwerte sowie optionale Anpassungen bietet.