Groovy Script Formatter

Purpose and scope. This tool formats Groovy scripts to a consistent style that aligns with common Groovy and Java-inspired conventions. It is intended for developers, code reviewers, and automation pipelines that require repeatable formatting without altering semantics. The formatter operates on source code text, producing a well-structured output without changing runtime behavior. It supports standard Groovy constructs, closures, maps, and multi-line strings, as well as chained method calls. Conceptually, it normalizes whitespace, fixes indentation depth, wraps long lines, and preserves comments and string literals. Core value lies in reducing formatting disputes, improving readability, and enabling diff-friendly changes across teams. Typical use cases include preparing code for pull requests, documenting examples, and enforcing team formatting standards in CI pipelines. Core features include configurable indent_size, max_line_length, and profiles that reflect Groovy conventions, while advanced rules expose control over parentheses, closure formatting, and map/collection alignment. Algorithmic approach is language-aware, using token streams to detect blocks, closures, and syntactic boundaries, while preserving comments and string literals. It supports incremental formatting for large files, with deterministic output and an option to preview changes before applying. Extensions include compatibility checks against common Groovy linters and easy reuse through project-wide configuration files. The tool avoids changing runtime behavior or semantics and focuses strictly on presentation.