antlr4

ANTLR v4

ANTLR (ANother Tool for Language Recognition) ist ein leistungsstarker Parser-Generator zum Lesen, Verarbeiten, Ausführen oder Übersetzen von strukturiertem Text oder Binärdateien. Es wird häufig zum Erstellen von Sprachen, Tools und Frameworks verwendet. Aus einer Grammatik generiert ANTLR einen Parser, der Parse-Bäume erstellen kann, und generiert außerdem eine Listener-Schnittstelle (oder einen Besucher), die es einfach macht, auf die Erkennung von interessierenden Phrasen zu reagieren.

Build-Status des Entwicklungszweigs

(Github-Aktionen)

Versionierung

ANTLR 4 unterstützt 10 Zielsprachen (Cpp, CSharp, Dart, Java, JavaScript, PHP, Python3, Swift, TypeScript, Go), und die Sicherstellung der Konsistenz über diese Ziele hinweg ist eine einzigartige und äußerst wertvolle Funktion. Um eine ordnungsgemäße Unterstützung dieser Funktion sicherzustellen, ist jede ANTLR-Version eine vollständige Version des Tools und der 10 Laufzeiten, alle mit derselben Version. Daher folgt die ANTLR-Versionierung nicht strikt der Semver-Semantik:

• Eine Komponente kann mit der neuesten Versionsnummer veröffentlicht werden, obwohl sich an dieser Komponente seit der vorherigen Version nichts geändert hat
• Die Hauptversion wird nur erhöht, wenn ANTLR für eine völlig neue „Generation“ neu geschrieben wird, z. B. ANTLR3 -> ANTLR4 (LL(*) -> ALL(*)-Analyse)
• Kleinere Versionsaktualisierungen können kleinere bahnbrechende Änderungen beinhalten. Die Richtlinie besteht darin, Parser bei jeder Veröffentlichung neu zu generieren (4.11 -> 4.12).
• Die Abwärtskompatibilität ist nur für Patch-Versionssprünge (4.11.1 -> 4.11.2) gewährleistet.

Wenn Sie in Ihrem CI einen Semver-Verifizierer verwenden, möchten Sie wahrscheinlich spezielle Regeln für ANTLR anwenden, z. B. die Behandlung geringfügiger Änderungen als größere Änderungen.

Repo-Zweigstruktur

Der Standardzweig für dieses Repo ist master , die neueste stabile Version mit Tags für die verschiedenen Versionen; Siehe z. B. Release-Tag 4.9.3. Bei Branch dev findet die Entwicklung zwischen Releases statt und alle Pull Requests sollten von diesem Branch abgeleitet werden. Der dev wird wieder mit master zusammengeführt, um ein Release auszuschneiden, und der Release-Status wird markiert (z. B. mit 4.10-rc1 oder 4.10 ). Visuell sieht unser Prozess ungefähr so ​​aus:

Das Go-Ziel verfügt jetzt über ein eigenes dediziertes Repo:

$ go get github.com/antlr4-go/antlr

Hinweis: Das dedizierte Go-Repo dient nur zum go get und import . Die Go-Laufzeitentwicklung wird weiterhin im Haupt antlr/antlr4 Repo durchgeführt.

Autoren und Hauptmitwirkende

• Terence Parr, [email protected] ANTLR-Projektleiter und oberster Diktator auf Lebenszeit, Universität von San Francisco
• Sam Harwell (Mitautor des Tools, Java und ursprüngliches C#-Ziel)
• Eric Vergnaud (Javascript-, TypeScript-, Python2-, Python3-Ziele und Wartung des C#-Ziels)
• Peter Boyer (Ziel erreichen)
• Mike Lischke (C++ abgeschlossenes Ziel)
• Dan McLaughlin (ursprüngliches C++-Ziel)
• David Sisson (C++-Anfangsziel und -Test)
• Janyou (Schnelles Ziel)
• Ewan Mellor, Hanzhou Shi (Schnelle Zielzusammenführung)
• Ben Hamilton (Vollständige Unicode-Unterstützung in serialisiertem ATN und den Laufzeiten aller Sprachen für Codepunkte > U+FFFF)
• Marcos Passos (PHP-Ziel)
• Lingyu Li (Dartziel)
• Ivan Kochurkin hat maßgeblich zur Gesamtqualität, Fehlerbehandlung und Target-Leistung beigetragen.
• Justin King hat eine Menge Arbeit auf mehreren Zielen geleistet, insbesondere aber für C++.
• Ken Domino hat ein Händchen für die Suche nach Fehlern/Problemen und die Analyse; auch ein wichtiger Mitwirkender am Grammars-v4-Repo.
• Jim Idle hat zu früheren Versionen von ANTLR beigetragen und ist kürzlich wieder eingestiegen, um ein großes Problem mit dem Go-Ziel zu lösen.

Nützliche Informationen

• Versionshinweise
• Erste Schritte mit v4
• Offizielle Seite
• Dokumentation
• FAQ
• ANTLR-Codegenerierungsziele
  (Derzeit: Java, C#, Python3, JavaScript, TypeScript, Go, C++, Swift, Dart, PHP)
• Hinweis: Ab Version 4.14 stellen wir die Unterstützung für Python 2 ein. Wir lieben die Python-Community, aber die Unterstützung für Python 2 wurde im Januar 2020 offiziell eingestellt. Vor kurzem hat GiHub auch die Unterstützung für Python 2 eingestellt, was dies für uns unmöglich gemacht hat um ein konsistentes Qualitätsniveau über alle Ziele hinweg aufrechtzuerhalten (wir verwenden GitHub für unser CI). Es lebe Python 3!
• Java-API
• ANTLR v3
• v3 zu v4 Migration, Unterschiede

Die folgenden Seiten könnten auch für Sie nützlich sein, insbesondere wenn Sie sich mit den verschiedenen Zielsprachen herumschlagen möchten.

• So erstellen Sie ANTLR selbst
• Wie wir eine ANTLR-Version erstellen und bereitstellen

Die definitive ANTLR 4-Referenz

Programmierer haben ständig Parsing-Probleme. Ob es sich um ein Datenformat wie JSON, ein Netzwerkprotokoll wie SMTP, eine Serverkonfigurationsdatei für Apache, eine PostScript-/PDF-Datei oder eine einfache Tabellenmakrosprache handelt – ANTLR v4 und dieses Buch werden den Prozess entmystifizieren. ANTLR v4 wurde von Grund auf neu geschrieben, um die Erstellung von Parsern und den darauf aufbauenden Sprachanwendungen einfacher denn je zu machen. Diese komplett neu geschriebene Neuauflage des Bestsellers Definitive ANTLR Reference zeigt Ihnen, wie Sie diese neuen Funktionen nutzen können.

Sie können das Buch The Definitive ANTLR 4 Reference bei Amazon oder eine elektronische Version auf der Website des Verlags kaufen.

Sie werden den Buchquellcode nützlich finden.

Zusätzliche Grammatiken

Dieses Repository ist eine Sammlung von Grammatiken ohne Aktionen, wobei der Name des Stammverzeichnisses der vollständig in Kleinbuchstaben geschriebene Name der von der Grammatik analysierten Sprache ist. Zum Beispiel Java, CPP, Csharp, C usw.