##Note about this version This version is a port of ANTLR v4 (4.8) runtime library for GWT. The final idea is to define a grammar in ANTLR4, generate the parser with your desktop machine and run/parse/interpret... in your browser. The creation process is the following:
- create your GWT project and reference this library as maven dependency (see below),
- add the Antlr4 module as inherited module in your app.gwt.xml
<inherits name="org.antlr.v4.antlr4-runtime" />
- define your grammar in ANTLR4 (desktop),
- generate the parser/visitor/listener... code in your GWT project with ANTLR4, version 4.8 (desktop),
- use the generated parser/visitor/listener in your GWT application,
- compile it, that's all.
This version only migrates the parser/lexer part and do not deal with the tooling/ui part (which are annotated with @GwtIncompatible
).
WARNING: In this version, the use of lexer predicates reduces the global parser/lexer performances!
Add this repository to your pom.xml
<repositories>
...
<repository>
<id>Antlr4-GWT</id>
<url>https://raw.github.com/aranega/antlr4-gwt/mvn-repo/</url>
<snapshots>
<enabled>true</enabled>
<updatePolicy>always</updatePolicy>
</snapshots>
</repository>
...
</repositories>
And this dependency:
<dependencies>
...
<dependency>
<groupId>org.antlr</groupId>
<artifactId>antlr4gwt-runtime</artifactId>
<version>4.4.1</version>
</dependency>
<dependency>
<groupId>org.antlr</groupId>
<artifactId>antlr4gwt-annotations</artifactId>
<version>4.4.2</version>
</dependency>
...
</dependencies>
Add this to your app.gwt.xml
<module>
...
<inherits name="org.antlr.v4.antlr4-runtime" />
...
</module>
You can find an integration demonstration in the demo
folder README
ANTLR (ANother Tool for Language Recognition) is a powerful parser generator for reading, processing, executing, or translating structured text or binary files. It's widely used to build languages, tools, and frameworks. From a grammar, ANTLR generates a parser that can build parse trees and also generates a listener interface (or visitor) that makes it easy to respond to the recognition of phrases of interest.
For installation and other getting started information, see Getting started with v4.
You can buy a book The Definitive ANTLR 4 Reference
Programmers run into parsing problems all the time. Whether it’s a data format like JSON, a network protocol like SMTP, a server configuration file for Apache, a PostScript/PDF file, or a simple spreadsheet macro language—ANTLR v4 and this book will demystify the process. ANTLR v4 has been rewritten from scratch to make it easier than ever to build parsers and the language applications built on top. This completely rewritten new edition of the bestselling Definitive ANTLR Reference shows you how to take advantage of these new features.
This repository is a collection of grammars without actions where the root directory name is the all-lowercase name of the language parsed by the grammar. For example, java, cpp, csharp, c, etc...
Terence Parr, parrt@cs.usfca.edu ANTLR project lead and supreme dictator for life University of San Francisco
Eric Vergnaud (Python2, Python3 targets)