Groovy Script Formatter

Zweck und Einsatzbereich. Dieses Tool formatiert Groovy-Skripte nach einem konsistenten Stil, der gängige Groovy- und Java-inspirierte Konventionen widerspiegelt. Es richtet sich an Entwickler, Code-Reviewer und Automatisierungs-Pipelines, die wiederholbare Formatierung ohne Änderung der Semantik benötigen. Der Formatter arbeitet am Quellcode-Text und erzeugt eine gut strukturierte Ausgabe, ohne Laufzeitverhalten zu verändern. Er unterstützt Standard-Groovy-Konstrukte, Closures, Maps und mehrzeilige Strings sowie verkettete Methodenaufrufe.
Konzeptionell normalisiert es Leerzeichen, passt die Einrückungstiefe an, bricht lange Zeilen um und bewahrt Kommentare und String-Literale. Der Kernvorteil besteht darin, Formatisierungsstreitigkeiten zu reduzieren, die Lesbarkeit zu verbessern und diff-freundliche Änderungen in Teams zu ermöglichen. Typische Anwendungsfälle umfassen das Vorbereiten von Code für Pull Requests, die Dokumentation von Beispielen und die Durchsetzung von Team-Formatstandards in CI-Pipelines. Kernfunktionen umfassen konfigurierbare indent_size, max_line_length und Profile, die Groovy-Konventionen widerspiegeln; fortgeschrittene Regeln ermöglichen Kontrolle über Klammern, Closure-Formatierung und Ausrichtung von Maps/Collections. Der Algorithmus ist sprachbewusst und verwendet Tokenströme, um Blöcke, Closures und syntaktische Grenzen zu erkennen, während Kommentare und String-Literale erhalten bleiben. Es unterstützt inkrementelles Formatieren größerer Dateien, mit deterministischem Output und einer Vorschaufunktion, bevor Änderungen angewendet werden. Erweiterungen umfassen Kompatibilitätsprüfungen gegen gängige Groovy-Linter und einfache Wiederverwendung über projektweite Konfigurationsdateien. Das Tool verändert weder Laufzeitverhalten noch Semantik und konzentriert sich rein auf Darstellung.