ANTLR v4

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

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

(github actions)

Версионирование

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

• основная версия увеличивается только при переписывании ANTLR для совершенно нового "поколения", например, ANTLR3 -> ANTLR4 (LL() -> LL() разбор).
• обновления младшей версии могут включать небольшие разрывы, политика состоит в том, чтобы перегенерировать парсеры с каждым выпуском (4.11 -> 4.12).
• обратная совместимость гарантирована только для разрывов версий патчей (4.11.1 -> 4.11.2). Если вы используете верификатор semver в вашем CI, вы, вероятно, захотите применить специальные правила для ANTLR, такие как учет изменений в основной версии как изменений в младшей версии.## Структура веток репозитория

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

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

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

Примечание Отдельный репозиторий Go предназначен только для go get и import. Разработка Go-таймайзеров по-прежнему осуществляется в основном репозитории antlr/antlr4.## Авторы и крупные вкладчики* Теренс Парр, parrt@cs.usfca.edu ANTLR проект, руководитель и верховный диктатор на всю жизнь Университет Сан-Франциско

• Сэм Харвелл (Автор инструмента, Java и оригинальная цель C#)
• Эрик Вергнауд (JavaScript, TypeScript, Python 2, Python 3 цели и поддержка C# цели)
• Питер Бойер (Цель Go)
• Майк Лишк (Завершенная цель C++)
• Дэн МакЛауллин (Изначальная цель C++)
• Дэвид Сизон (Изначальная цель C++ и тестирование)
• Жанью (Цель Swift)
• Эван Меллор, Ханжоу Ши (Объединение целей Swift)
• Бен Хэмилтон (Полная поддержка Юникода в сериализованном ATN и во всех языках выполнения для кодовых точек > U+FFFF)
• Маркос Пассос (Цель PHP)
• Линью Ли (Цель Dart)
• Иван Коучуркин сделал значительный вклад в общее качество, обработку ошибок и производительность целей.
• Джастин Кинг сделал огромное количество работы по нескольким целям, но особенно для C++.
• Кен Домино обладает способностью находить ошибки/проблемы и анализировать; также является значительным вкладчиком в репозитории grammars-v4.## Полезная информация* Примечания к выпуску
• Начало работы с v4
• Официальный сайт
• Документация
• Часто задаваемые вопросы (FAQ)
• Целевые языки генерации кода ANTLR
  (Текущие: Java, C#, Python3, JavaScript, TypeScript, Go, C++, Swift, Dart, PHP)
• Примечание: С версии 4.14 мы прекращаем поддержку Python 2. Мы любим сообщество Python, но поддержка Python 2 официально была прекращена в январе 2020 года. Более недавно, GitHub также прекратил поддержку Python 2, что сделало невозможным для нас поддерживать согласованный уровень качества по всем целевым языкам (мы используем GitHub для нашего CI). Да здравствует Python 3!
• Java API
• ANTLR v3
• Переход с v3 на v4, различия

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

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

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

Вы найдете Исходный код книги полезным.## Дополнительные грамматики Этот репозиторий представляет собой коллекцию грамматик без действий, где имя корневой директории является нижним регистром названия языка, который парсится с помощью грамматики. Например, java, cpp, csharp, c и т.д.