Freemarker Template Formatter

Freemarker Template Formatter bearbetar FTL-källor för att producera en konsekvent, läsbar layout utan att ändra mallarnas semantik. Verktyget riktar sig till utvecklare och templating-team som hanterar stora kodbaser med många bidragsgivare. Verktyget accepterar rå Freemarker-mallar, analyserar strukturella element som direktiv, makrodefinitioner och nästlade block, och tillämpar en enhetlig stil på whitespace, indentering och radbrytningar. Genom att normalisera dessa aspekter blir diffs lättare att granska och revisioner mindre felbenägna, särskilt i CI-pipelines eller vid onboarding av nya teammedlemmar.
Det använder en Freemarker-beroende parser för att identifiera block som <#if>, <#list> och <#macro>, bevarar innehållet samtidigt som omgivande whitespace omstruktureras. Formatteraren stöder konfigurerbara indenteringsbredder (2 eller 4 tecken), en maximal radlängd och frivillig attribut-wrap. Den behåller kommentarer, stränglitteraler och interpolationsuttryck och ändrar inte körtidsuttryck. Avancerade användare kan aktivera eller inaktivera attribut-wrap, avgöra om tomma rader ska behållas och skapa en sida-till-sida diff för granskning.
Användningsfall inkluderar pre-commit-formatering, CI-kontroller och massrensning av äldre mallar över tjänster. Verktyget är särskilt värdefullt för Java-baserade webbapplikationer som använder Freemarker för server-rendering och därmed möjliggör konsekventa mallar över moduler samt minskar merge-konflikter. Dess unika värde ligger i domänkännande formatering som respekterar Freemarker-semantiken samtidigt som pragmatiska standarder och valfria anpassningar erbjuds.