antlr4ng-cli

Part of the Next Generation ANTLR Project

Custom ANTLR4 Code Generator

This package contains a custom code generator for ANTLR4 grammars. It is based on the official ANTLR4 code generator, but includes support for the antlr4ng runtime, so the TypeScript output is different. Other than that it is a drop-in replacement for the official generator and can also be used with the official runtimes (C++, Java, etc.).

Installation

To install the package, run the following command:

npm install antlr4ng-cli

Usage

The package needs Java installed on your system, To generate your parser, run the following command:

antlr4ng <options> <grammar-file>

in the root of your project, where you installed the package.

Note: in contrast to antlr4ts you have to specify the target language explicitly, just as if you use the generator jar file directly. A typical case would be:

antlr4ng -Dlanguage=TypeScript -o generated/ -visitor -listener -Xexact-output-dir path/to/YourLexer.g4 path/to/YourParser.g4

Release Notes

1.0.5 - 1.0.6

Code generation changes:

• Local attributes in rule contexts are now made optional, to account for the fact that they are not always set.

1.0.4

Compatible with antlr4ng 2.0.0

Code generation changes:

• More locations where the override keyword is needed in generated classes.
• ParserRuleContext._ctx was renamed to ParserRuleContext.context in the runtime.
• Optional null result for listener/walker methods.
• TokenStream.getText no longer needs a temporary interval as parameter, but can directly work with start and stop values.

1.0.3

• Non-optional token members of a rule context no longer return null, which makes explicit non-null assertions in user code unnecessary.
• Added override keyword for generated copyFrom methods.

1.0.2

Updated the ANTLR4 jar.

1.0.1

• Some changes for renamed class members in the runtime (e.g. _interp -> interpreter).

1.0.0

• Initial release.