Bug fix and repo reorganization release

We fixed number of important bugs but also combined the various target repositories, such as antlr/antlr4-python2, into the main antlr/antlr4 repository.

For the Java target only, there is also a new feature: a parser interpreter that tracks which alternative or label was match for a particular parse tree node, which is often useful during debugging. It is used in the 1.7 release of the ANTLR Intellij Plugin.

Summary of Major Changes

• Maven build was added back in, thanks to new contributor Jason van Zyl; you can just open the topmost pom.xml in your favorite IDE
• We completely overhauled runtime test generation
• We merged all existing target repositories such as antlr4-python2 into the main antlr4 repo so that everything is now included in a single spot.

You can view all Issues fixed in 4.5.1, all pull requests merged and all commits for this release.

Features

• Add goto to reserved words for java
• Create functionality to get all possible parse trees for ambiguous input.
• Makes TestRig's dialog to save and restore its state
• Parser.setProfile() should keep settings like prediction mode
• Make Grammar-object-aware ParserInterpreter (This interpreter will have parse tree nodes that know which alternative or label was matched for a particular parse tree subtree root.)
• Check for nonconforming left-recursive rules.

Bug Fixes

• Null pointer in named alternative with attributes
• NullPointerException in bad recursion
• Parser.setProfile() should keep settings like prediction mode
• Allow parsing decision override for (decision, input index) in parsers
• Random ArrayIndexOutOfBounds exceptions coming from ParserATNSimulator
• Empty rule matched first gives invalid source interval
• EOF leaf not included in parent tree source interval
• Rule parameter in left recursive rules disallowed
• wrong location on import error message reference to undefined rule
• NotNull import is not deleted in Java.stg

Download Binaries

Download the ANTLR tool and all target runtimes at the antlr.org site.

The Java jars are OSGi compatible so you should be able to use them within Eclipse.

Runtime Libraries for Language Targets

• Java is embedded with the tool, but is also available from maven-central
• C# (zipped .dll) is a download from antlr.org. Might be in NuGet too in the future.
• JavaScript is a download from antlr.org. Might also be registered as a npm package for node.js
• Python2 and Python 3 are in PyPi
• Sam Harwell's alternative C# target is available through NuGet. Note that this alternative target is distributed with a standalone copy of the ANTLR Tool, and only works with code generated by that standalone copy.

Documentation

• Java runtime API (4.5.1)
• Java Tool API (4.5.1)
• ANTLR 4 Maven plugin (4.5.1)

Language Targets Info

As of 4.5, the standard distribution of ANTLR can generate code in the following languages:

• Java
• Python2
• Python3
• JavaScript
• C#

In addition, the following languages are supported by standalone release(s) of the tool.

• C# (Sam Harwell's)