Crate sql_dialect_fmt_formatter 

sql-dialect-fmt-formatter — the formatting half of the toolchain.

Two layers:

• doc — a grammar-agnostic pretty-printing engine (a Doc IR + width-aware printer) in the Wadler → Prettier → biome/ruff lineage. Depends on nothing SQL-specific.
• [sql] — the Snowflake SQL rules that lower the parser’s lossless CST into Docs.

[format] ties them together: parse → lower → print. Like the parser, it never panics; input it cannot model structurally is preserved verbatim, so formatting is always content-preserving.

use sql_dialect_fmt_formatter::{format, FormatOptions};
let out = format("select a,b from t", &FormatOptions::default());
assert_eq!(out, "SELECT a, b\nFROM t;\n");

Public API stability

FormatOptions is the configuration entry point and is #[non_exhaustive]: build it from FormatOptions::default and refine it with the with_* methods so adding future knobs stays backwards compatible.

Modules

doc

A small, self-contained pretty-printing engine in the Wadler → Prettier → rome/biome → ruff lineage. The grammar-agnostic core is a Doc intermediate representation plus a width-aware [print]er; SQL-specific rules live in [crate::sql] and only ever build Docs.

Macros

doc_write

Push a comma-bracketed list of Format elements into a DocBuffer, in order.

Structs

FormatOptions

Options controlling formatting. Opinionated and intentionally small.

PrintOptions

Knobs for the printer. Opinionated by design: just a target width and an indent step.

Enums

Dialect

The SQL dialect a lex/parse/format request targets.

Doc

The pretty-printer intermediate representation.

Functions

format

Format Snowflake SQL source text. Never panics; never drops content.

print

Render doc to a string. Trailing whitespace is trimmed from every line and the result ends with exactly one newline (or is empty), so the output is stable under re-formatting.