antlr4

АНТЛР v4

ANTLR (Другой инструмент для распознавания языка) — мощный генератор синтаксического анализатора для чтения, обработки, выполнения или перевода структурированного текста или двоичных файлов. Он широко используется для создания языков, инструментов и фреймворков. Из грамматики ANTLR генерирует синтаксический анализатор, который может строить деревья синтаксического анализа, а также генерирует интерфейс слушателя (или посетителя), который позволяет легко реагировать на распознавание интересующих фраз.

Статус сборки ветки разработки

(действия github)

Управление версиями

ANTLR 4 поддерживает 10 целевых языков (Cpp, CSharp, Dart, Java, JavaScript, PHP, Python3, Swift, TypeScript, Go), и обеспечение согласованности между этими целевыми объектами является уникальной и очень ценной функцией. Чтобы обеспечить правильную поддержку этой функции, каждый выпуск ANTLR представляет собой полную версию инструмента и 10 сред выполнения одной и той же версии. Таким образом, управление версиями ANTLR не строго следует семантике semver:

• компонент может быть выпущен с последней версией, даже если в этом компоненте ничего не изменилось с момента предыдущего выпуска.
• основная версия изменяется только тогда, когда ANTLR переписан для совершенно нового «поколения», например ANTLR3 -> ANTLR4 (анализ LL(*) -> ALL(*))
• обновления минорных версий могут включать незначительные критические изменения, политика заключается в том, чтобы перегенерировать парсеры с каждым выпуском (4.11 -> 4.12).
• обратная совместимость гарантируется только для обновлений версии патча (4.11.1 -> 4.11.2)

Если вы используете верификатор semver в своем CI, вы, вероятно, захотите применить специальные правила для ANTLR, например рассматривать незначительные изменения как серьезные изменения.

Структура филиала РЕПО

Веткой по умолчанию для этого репозитория является master , которая является последней стабильной версией и имеет теги для различных выпусков; например, см. тег выпуска 4.9.3. Разработка dev — это место, где разработка происходит между выпусками, и все запросы на включение должны быть получены из этой ветки. Ветка dev объединяется обратно в master для вырезания релиза, а состояние релиза помечается тегом (например, 4.10-rc1 или 4.10 ). Визуально наш процесс выглядит примерно так:

Цель Go теперь имеет собственный специальный репозиторий:

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

Примечание. Специальный репозиторий Go предназначен только для go get и import . Разработка среды выполнения Go по-прежнему выполняется в основном репозитории antlr/antlr4 .

Авторы и основные участники

• Теренс Парр, [email protected] Руководитель проекта ANTLR и верховный диктатор жизни Университет Сан-Франциско
• Сэм Харвелл (соавтор инструмента, Java и исходная цель C#)
• Эрик Вергно (цели Javascript, TypeScript, Python2, Python3 и поддержка цели C#)
• Питер Бойер (Go target)
• Майк Лишке (цель на C++ выполнена)
• Дэн Маклафлин (первоначальная цель C++)
• Дэвид Сиссон (начальная цель и тест C++)
• Джанью (Быстрая цель)
• Юэн Меллор, Ханьчжоу Ши (Быстрое слияние целей)
• Бен Гамильтон (полная поддержка Unicode в сериализованной ATN и средах выполнения всех языков для кодовых точек > U+FFFF)
• Маркос Пассос (цель PHP)
• Линъюй Ли (мишень для дротиков)
• Иван Кочуркин внес большой вклад в общее качество, обработку ошибок и целевую производительность.
• Джастин Кинг проделал огромную работу для разных целей, но особенно для C++.
• Кен Домино умеет находить ошибки/проблемы и проводить анализ; также внес основной вклад в репозиторий grammars-v4.
• Джим Айдл внес свой вклад в предыдущие версии ANTLR и недавно вернулся к решению серьезной проблемы с целью Go.

Полезная информация

• Примечания к выпуску
• Начало работы с версией 4
• Официальный сайт
• Документация
• Часто задаваемые вопросы
• Цели генерации кода ANTLR
  (На данный момент: Java, C#, Python3, JavaScript, TypeScript, Go, C++, Swift, Dart, PHP)
• Примечание. Начиная с версии 4.14, мы прекращаем поддержку Python 2. Мы любим сообщество Python, но поддержка Python 2 была официально прекращена в январе 2020 года. Совсем недавно GiHub также прекратил поддержку Python 2, что сделало это невозможным для нас. для поддержания постоянного уровня качества для всех целей (мы используем GitHub для нашей CI). Да здравствует Python 3!
• Java API
• АНТЛР v3
• Миграция с v3 на v4, различия

Следующие страницы также могут оказаться вам полезными, особенно если вы хотите разобраться с различными целевыми языками.

• Как собрать сам ANTLR
• Как мы создаем и развертываем выпуск ANTLR

Полный справочник по ANTLR 4

Программисты постоянно сталкиваются с проблемами синтаксического анализа. Будь то формат данных, такой как JSON, сетевой протокол, такой как SMTP, файл конфигурации сервера для Apache, файл PostScript/PDF или простой язык макросов электронных таблиц — ANTLR v4 и эта книга прояснят этот процесс. ANTLR v4 был переписан с нуля, чтобы упростить создание парсеров и языковых приложений, созданных на его основе. В этом полностью переписанном новом издании бестселлера «Полный справочник по ANTLR» показано, как воспользоваться преимуществами этих новых функций.

Вы можете купить книгу The Definitive ANTLR 4 Reference на Amazon или электронную версию на сайте издателя.

Вы найдете исходный код книги полезным.

Дополнительные грамматики

Этот репозиторий представляет собой коллекцию грамматик без действий, где имя корневого каталога представляет собой имя языка, написанное строчными буквами, анализируемого грамматикой. Например, java, cpp, csharp, c и т. д.