PartiQL Rust CLI

PoC for a CLI & REPL. It should be considered experimental, subject to change, etc.

In its current state, it largely exists to test parser interface & types from the perspective of an external application. Probably the the mietter::Diagnostic stuff should be refactored and moved to the main parser crate.

CLI Commands

• help : print the CLI's help message and supported commands
• repl : launches the REPL
• ast -T<format> "<query>": outputs a rendered version of the parsed AST (see Visualization):
  • <format>:
  • json : pretty-print to stdout in a json dump
  • dot : pretty-print to stdout in Graphviz dot format
  • svg : print to stdout a Graphviz rendered svg xml document
  • png : print to stdout a Graphviz rendered png bitmap
  • display : display a Graphviz rendered png bitmap directly in supported terminals
  • query : the PartiQL query text

REPL

The REPL currently assumes most of the input line is a PartiQL query, which it will attempt to parse. - For an invalid query, errors are pretty printed to the output. - For a valid query, - with no prefix, Parse OK! is printed to the output - if prefixed by \ast, a rendered AST tree image is printed to the output (see Visualization)

Features: - Syntax highlighting of query input - User-friendly error reporting - Readling/editing - CTRL-D/CTRL-C to quit.

Visualizations

In order to use any of the Graphviz-based visualizations, you will need the graphviz libraries installed on your machine (e.g. brew install graphviz or similar).

TODO

See REPL-tagged issues

• Use central location for syntax files rather than embedded in this crate
• Better interaction model
  • commands
  • more robust editing
  • etc.