+0
Daily
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
#1219Grammar that parses in milliseconds in Java runtime, takes many seconds in python95 comments · 2016-06-23#1839[Feature Request] Target for Rust Programming Language71 comments · 2017-04-25#4218Can't import from TypeScript runtime with `"moduleResolution": "nodenext"`49 comments · 2023-04-03#2504Is antlr4's golang visitor pattern in a usable state?48 comments · 2019-03-06#1540Performance tips40 comments · 2016-12-21#2634How can I disable or format the "Generated from" comment in antlr38 comments · 2019-08-25#1756release 4.732 comments · 2017-03-14#1613[Java] Lexer is >10x slower if input is not in Ascii range31 comments · 2017-01-18
Discussions
#4989Ispa parser generator - generator inspired by ANTLR1 comments · 2026-10-27#4956Any plans to address known vulnerability identified in CVE-2026-13500 / BDSA-2026-17031?6 comments · 2026-07-20#4955Is there a concise description of the set of grammars that are accepted by the ANTLR4 tool ?1 comments · 2026-07-19#4945[RUST] Rust crate Antlr0 comments · 2026-06-11#4944action plan for a new target (OCaml)0 comments · 2026-06-10#4931Token ANTLR4 avec apostrophe (') et option caseInsensitive = true2 comments · 2026-03-31#4930How to use variable 'a' when keyword 'a' exists in case-insensitive ANTLR4 grammar?3 comments · 2026-03-19#4923Loop in closure but only when the second parse invocation.5 comments · 2026-03-04
Latest release
4.13.2 4.13.2 2024-08-03Minor 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