Groovy Script Formatter

Scopo e ambito. Questo strumento formatta gli script Groovy secondo uno stile coerente che rispecchia le convenzioni Groovy e Java ispirate. È rivolto a sviluppatori, revisori di codice e pipeline di automazione che richiedono una formattazione ripetibile senza modificare la semantica. Il formatter opera sul testo sorgente, producendo un output ben strutturato senza alterare il comportamento di esecuzione. Supporta costrutti Groovy standard, closures, mappe e stringhe multilinea, nonché chiamate a metodi in catena. Concettualmente normalizza gli spazi, regola la profondità di indentazione, tronca righe lunghe e preserva commenti e stringhe letterali. Il valore principale è ridurre le dispute di formattazione, migliorare la leggibilità e abilitare modifiche diff-friendly tra team. Casi d’uso tipici includono preparare il codice per pull request, documentare esempi e imporre standard di formattazione nel CI. Funzionalità chiave includono indent_size configurabile, max_line_length e profili che riflettono le convenzioni Groovy; regole avanzate offrono controllo su parentesi, formattazione delle closures e allineamento di mappe/collezioni. L’approccio algoritmico è linguaggio-consapevole, utilizza flussi di token per rilevare blocchi e confini sintattici, preservando commenti e stringhe letterali. Supporta formattazione incrementale di file grandi, output deterministico e anteprima prima dell’applicazione. Estensioni includono controlli di compatibilità con linters Groovy comuni e riutilizzo tramite file di configurazione a livello di progetto. Lo strumento non altera comportamento runtime o semantica e si concentra solamente sulla presentazione.