Parsing System (v0.8)
Goldie Home (v0.8) -> Goldie's Tools -> Parse

Parse

Parses any source according to any CGT file, and saves the resulting tokens and parse tree to JSON files. These JSON files can be inspected with the enhanced version of JsonViewer bundled with Goldie.

Example:

If the file extension of your source is the same as the name of a CGT file in Goldie's lang/ directory:

>goldie-parse lang/valid_sample2.calc

To use a specific CGT file:

>goldie-parse -lang:/home/me/myLanguages/calc.cgt lang/valid_sample2.calc

The above examples will create the following files in the same directory as valid_sample2.calc:

valid_sample2.calc.tk.json valid_sample2.calc.pt.json

The .tk.json file contains the tokenization of valid_sample2.calc. Ie, the result of the Lexing phase.

The .pt.json file contains the parse tree of valid_sample2.calc. Ie, the result of the Parsing phase.

Either of the .json files can be opened in JsonViewer and will be browsable using JsonViewer's Parse Tree Mode.

Note: Keep in mind, especially when using Parse with JsonViewer, that parse trees tend to get very large, very fast.

Command-line parameters:

Sample Usage: goldie-parse lang/valid_sample2.calc goldie-parse lang/valid_sample2.calc -lang:lang/calc.cgt Switches: (Prefixes can be '/', '-' or '--') ('[]' means multiple switches are accepted) Basic: -help Displays a help summary and exits -detail Displays a detailed help message and exits <text> (Required) Source filename -lang:<text> CGT file of language (default: "{goldie}/lang/{src ext}.cgt") Advanced: -ptn Don't save parse tree -tkn Don't save tokens -ptp Pretty format parse tree file -tkp Pretty format token file -ptt:<text> Parse tree file type ("json" or "xml") (default: "json") -tkt:<text> Token file type ("json" or "xml") (default: "json") -pto:<text> Parse tree output filename -tko:<text> Token output filename -debug Display debug information