Package gudusoft.gsqlparser.pp2

Fault-tolerant SQL formatter (pp2) — augments, does not replace, the parse-dependent gudusoft.gsqlparser.pp formatter.

See: Description

Class Summary

Class	Description
FormatDiagnostic	A single diagnostic event produced by the pp2 engine — a recovered parse failure, a tokenizer gap, a guard fall-through, etc.
Pp2FormatOptions	Configuration for the pp2 fault-tolerant SQL formatter.
Pp2FormatResult	Immutable result of a Pp2Formatter.format(...) call.
Pp2FormatResult.Region	Per-region rendering record.
Pp2Formatter	Internal facade for the pp2 fault-tolerant SQL formatter.

Enum Summary

Enum	Description
FormatDiagnostic.Severity	Severity level.
FormatStatus	Overall outcome of a pp2 format call.
Pp2FormatOptions.ErrorRegionStrategy	Strategy for rendering parse-failed, lexical-fallback regions.
RendererId	Identifies which strategy produced a given output region.

Exception Summary

Exception	Description
Pp2ParseException	Thrown by the pp2 engine when Pp2FormatOptions.tolerantMode is false and parsing fails for one or more regions.

Package gudusoft.gsqlparser.pp2 Description

Fault-tolerant SQL formatter (pp2) — augments, does not replace, the parse-dependent gudusoft.gsqlparser.pp formatter.

The pp2 engine is a region-hybrid formatter built on a source-span ledger, an immutable token spine, a guarded AST delegate that wraps the existing FormatterFactory.pp() machinery, a conservative MVP renderer, and (post-Phase-3) a lexical island fallback ported from the Delphi TSQLion algorithm. Together these handle well-formed, partially broken, or completely invalid SQL without throwing, without OOM, and without StackOverflowError.

Design and slice plan: gsp_java_core/doc/formatter/v2/final_granular_plan.md.

Invariants

• The caller's TSourceTokenList is never mutated.
• Every byte of input is owned by exactly one SourceSpan; no byte is lost.
• Every solid input token appears in output, in the same order.
• FormatterFactory.pp() output is byte-identical for legal SQL after pp2 lands.
• All deep-tree traversals (UNION, expression, scope, island) are iterative.

The public entry point is FormatterFactory.pp2(...), added in slice S17 once the MVP is shippable. Prior slices test against the internal Pp2Formatter facade only.

Since:

4.1