Skip to content

Latest commit

 

History

History
47 lines (37 loc) · 1.51 KB

README.md

File metadata and controls

47 lines (37 loc) · 1.51 KB
Raw

grunsharp

A C#/WPF implementation of grun, the ANTLR grammar test rig.

As it stands, this is a very basic/rough implementation, but it's enough to run the C# parser/lexer files generated by the ANTLR tool, meaning you can write your additional grammar logic in C# from beginning to end without losing out on being able to use the test rig.

Usage

GrunCS.exe <grammar name> <start rule> <input files>... [--gui] [--tokens] [--config=<path>]

Run from the working directory (containing your generated .cs parser/lexer files).

Config

Optionally, a gruncs.json file can be placed in the working directory (or at a path supplied through the --config option).

An example config file:

{
    "References": [
        "System.Core",
        "System.Text.RegularExpressions"
    ],
    "Include": [
        "AdditionalLogic.extra.cs"
    ]
}
  • References: A list of assemblies to reference, in 3 possible formats:
  • Include: Any additional files (relative paths) to be compiled before the parser is run

Feature coverage

Based on: https://github.com/antlr/antlr4/blob/master/tool/src/org/antlr/v4/gui/TestRig.java

Implemented:

  • --gui
  • --tokens

Might work:

  • --tree

Not implemented:

  • --ps
  • --trace
  • --diagnostics
  • --SLL