gorgeous

Grammar-driven pretty-printers for structured languages. Each language is defined by a BBNF grammar file — #[derive(Parser)] generates the parser, @pretty directives control formatting, and pprint renders the final output.

Usage

use gorgeous::{prettify_json, prettify_css, PrinterConfig};

let config = PrinterConfig { max_width: 80, indent: 2, use_tabs: false };

let formatted_json = prettify_json(input, &config);
let formatted_css = prettify_css(input, &config);

Partial formatting via source range:

use gorgeous::{prettify_json_range, PrinterConfig};

let config = PrinterConfig { max_width: 80, indent: 2, use_tabs: false };
let formatted = prettify_json_range(input, 100..200, &config);

Languages

All 31 tests pass. Idempotency verified: prettify(prettify(x)) == prettify(x).

CLI

Built-in languages auto-detect by extension; arbitrary languages JIT-compile from any .bbnf grammar.

gorg input.json                        # built-in, auto-detect by extension
gorg --lang css input.css              # built-in, explicit language
gorg --grammar my.bbnf input.txt       # JIT: any grammar, instant prettifier
gorg --grammar my.bbnf -r expr in.txt  # JIT with explicit entry rule
echo '{}' | gorg --lang json           # stdin
gorg input.css -o output.css           # write to file
gorg -w 120 -i 2 input.json            # custom width + indent
gorg --clear-cache                     # purge JIT cache

The JIT pipeline parses the .bbnf, generates a Cargo project with #[derive(Parser, prettify)], compiles it once, and caches the binary by content hash in ~/.cache/gorgeous/. Second run is instant.

Architecture

Grammar (.bbnf)
  → #[derive(Parser)]     proc-macro codegen (bbnf-derive)
    → AST (enum)           typed parse tree
      → to_doc()           @pretty-directed Doc emission
        → Doc tree         pprint intermediate representation
          → pprint()       Wadler-Lindig pretty-printer
            → String       formatted output

The @pretty directives annotate grammar rules with formatting hints:

range_to_doc() enables partial formatting: nodes outside the target range emit verbatim source text, nodes inside emit formatted Doc trees.

Performance

Phase-split CSS throughput (app.css):

End-to-end cached throughput:

Dependencies

All from crates.io:

• parse_that — parser combinators
• bbnf_derive — #[derive(Parser)] proc-macro
• bbnf — grammar analysis
• pprint — Wadler-Lindig pretty-printer

Dev: bencher for [[bench]] harness.

Build

cargo test --lib                # 31 tests
cargo bench --bench gorgeous    # 12 benchmarks (JSON 6 + CSS 6)
cargo clippy -- -D warnings

Requires Rust nightly (#![feature(cold_path)]).