|author||Terence Parr <firstname.lastname@example.org>||Sun May 21 17:26:56 2023|
|committer||Terence Parr <email@example.com>||Sun May 21 17:26:56 2023|
[maven-release-plugin] prepare release 4.13.0
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.
Dev branch build status
ANTLR 4 supports 10 target languages, and ensuring consistency across these targets is a unique and highly valuable feature. To ensure proper support of this feature, each release of ANTLR is a complete release of the tool and the 10 runtimes, all with the same version. As such, ANTLR versioning does not strictly follow semver semantics:
If you use a semver verifier in your CI, you probably want to apply special rules for ANTLR, such as treating minor change as a major change.
The default branch for this repo is
master, which is the latest stable release and has tags for the various releases; e.g., see release tag 4.9.3. Branch
dev is where development occurs between releases and all pull requests should be derived from that branch. The
dev branch is merged back into
master to cut a release and the release state is tagged (e.g., with
4.10.) Visually our process looks roughly like this:
The Go target now has its own dedicated repo:
$ go get github.com/antlr4-go/antlr
Note The dedicated Go repo is for
go get and
import only. Go runtime development is still performed in the main
You might also find the following pages useful, particularly if you want to mess around with the various target languages.
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.
You will find the Book source code useful.
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...