antlr /antlr4

ANTLR (ANother Tool for Language Recognition) is a powerful parser generator for reading, processing, executing, or translating structured text or binary files.

★ 19,044⑂ 3,472👁 364⑃ 2,212● 2,426▤ 31
JavaBSD-3-ClauseCreated 2010-02-04antlr.org
下载:4.13.24.13.2 ↓4.13.22024-08-03
+0
日增长
19,044
stars
3,472
forks
364
watchers
2,212
prs
2,426
issues
31
releases

README

ANTLR v4




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

 (github actions)




 Versioning

ANTLR 4 supports 10 target languages
(Cpp, CSharp, Dart, Java, JavaScript, PHP, Python3, Swift, TypeScript, Go),
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:

 a component may be released with the latest version number even though nothing has changed within that component since the previous release
 major version is bumped only when ANTLR is rewritten for a totally new "generation", such as ANTLR3 - ANTLR4 (LL(\) - ALL(\) parsing)
 minor version updates may include minor breaking changes, the policy is to regenerate parsers with every release (4.11 - 4.12)
 backwards compatibility is only guaranteed for patch version bumps (4.11.1 - 4.11.2)

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.

 Repo branch structure

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-rc1 or 4.10.) Visually our process looks roughly like this:



The Go target now has its own dedicated repo:

bash
$ 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 antlr/antlr4 repo. 

 Authors and major contributors

 Terence Parr, [email protected]
ANTLR project lead and supreme dictator for life
University of San Francisco
 Sam Harwell (Tool co-author, Java and original C target)
 Eric Vergnaud (Javascript, TypeScript, Python2, Python3 targets and maintenance of C target)
 Peter Boyer (Go target)
 Mike Lischke (C++ completed target)
 Dan McLaughlin (C++ initial target)
 David Sisson (C++ initial target and test)
 Janyou (Swift target)
 Ewan Mellor, Hanzhou Shi (Swift target merging)
 Ben Hamilton (Full Unicode support in serialized ATN and all languages' runtimes for code points  U+FFFF)
 Marcos Passos (PHP target)
 Lingyu Li (Dart target)
 Ivan Kochurkin has made major contributions to overall quality, error handling, and Target performance.
 Justi

Top issues

Discussions

Latest release

4.13.2 4.13.2 2024-08-03
Minor updates release.

 Pull requests grouped by target

 cpp target
 [[Cpp] Use target_include_dirs for cmake targets](https://github.com/antlr/antlr4/pull/4661) (target:cpp)
 Update C++ documentation to state that C++17 is required (comp:doc, target:cpp)

 go target
 fix go-target.md, remove duplicate 'get' (comp:doc, target:go)

 javascript target
 fix(javascript): fix types not being recognized for NodeNext module resolution (target:javascript)
 [[Javascript] Fix broken package entrypoints](https://github.com/antlr/antlr4/pull/4411) (target:javascript, type:cleanup)

 pytho

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON