antlr4

ANTLR v4

ANTLR (ANother Tool for Language Recognition) é um poderoso gerador de analisador para leitura, processamento, execução ou tradução de texto estruturado ou arquivos binários. É amplamente utilizado para construir linguagens, ferramentas e estruturas. A partir de uma gramática, o ANTLR gera um analisador que pode construir árvores de análise e também gera uma interface ouvinte (ou visitante) que facilita a resposta ao reconhecimento de frases de interesse.

Status de compilação do branch de desenvolvimento

(ações do github)

Versionamento

O ANTLR 4 oferece suporte a 10 linguagens de destino (Cpp, CSharp, Dart, Java, JavaScript, PHP, Python3, Swift, TypeScript, Go) e garantir a consistência entre esses destinos é um recurso exclusivo e altamente valioso. Para garantir o suporte adequado deste recurso, cada versão do ANTLR é uma versão completa da ferramenta e dos 10 tempos de execução, todos com a mesma versão. Como tal, o versionamento ANTLR não segue estritamente a semântica semver:

• um componente pode ser lançado com o número de versão mais recente, mesmo que nada tenha mudado nesse componente desde a versão anterior
• a versão principal é alterada apenas quando o ANTLR é reescrito para uma "geração" totalmente nova, como ANTLR3 -> ANTLR4 (análise LL(*) -> ALL(*))
• atualizações de versões secundárias podem incluir pequenas alterações importantes, a política é regenerar analisadores a cada lançamento (4.11 -> 4.12)
• a compatibilidade com versões anteriores só é garantida para versões de patch (4.11.1 -> 4.11.2)

Se você usar um verificador semver em seu IC, provavelmente desejará aplicar regras especiais para ANTLR, como tratar alterações menores como alterações importantes.

Estrutura da filial do repositório

O branch padrão para este repositório é master , que é a versão estável mais recente e possui tags para os vários lançamentos; por exemplo, consulte a tag de lançamento 4.9.3. Branch dev é onde o desenvolvimento ocorre entre os lançamentos e todas as solicitações pull devem ser derivadas desse branch. O branch dev é mesclado novamente no master para cortar um release e o estado do release é marcado (por exemplo, com 4.10-rc1 ou 4.10 .) Visualmente, nosso processo se parece mais ou menos com isto:

O destino Go agora tem seu próprio repositório dedicado:

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

Nota O repositório Go dedicado é apenas para go get e import . O desenvolvimento do tempo de execução Go ainda é executado no repositório antlr/antlr4 principal.

Autores e principais contribuidores

• Terence Parr, [email protected] Líder do projeto ANTLR e ditador supremo vitalício Universidade de São Francisco
• Sam Harwell (coautor da ferramenta, Java e destino C# original)
• Eric Vergnaud (alvos Javascript, TypeScript, Python2, Python3 e manutenção de alvo C#)
• Peter Boyer (ir alvo)
• Mike Lischke (alvo concluído em C++)
• Dan McLaughlin (alvo inicial C++)
• David Sisson (alvo inicial e teste de C++)
• Janyou (alvo rápido)
• Ewan Mellor, Hanzhou Shi (fusão rápida de alvos)
• Ben Hamilton (suporte completo a Unicode em ATN serializado e tempos de execução de todas as linguagens para pontos de código > U+FFFF)
• Marcos Passos (alvo PHP)
• Lingyu Li (alvo de dardo)
• Ivan Kochurkin fez contribuições importantes para a qualidade geral, tratamento de erros e desempenho do Target.
• Justin King fez um grande trabalho em vários alvos, mas especialmente para C++.
• Ken Domino tem um talento especial para encontrar bugs/problemas e análises; também um contribuidor importante no repositório Grammatics-v4.
• Jim Idle contribuiu para versões anteriores do ANTLR e recentemente voltou para resolver um grande problema com o alvo Go.

Informações úteis

• Notas de lançamento
• Introdução à v4
• Site oficial
• Documentação
• Perguntas frequentes
• Alvos de geração de código ANTLR
  (Atualmente: Java, C#, Python3, JavaScript, TypeScript, Go, C++, Swift, Dart, PHP)
• Observação: a partir da versão 4.14, estamos eliminando o suporte para Python 2. Amamos a comunidade Python, mas o suporte para Python 2 foi oficialmente interrompido em janeiro de 2020. Mais recentemente, o GiHub também abandonou o suporte para Python 2, o que tornou isso impossível para nós. para manter um nível consistente de qualidade entre os alvos (usamos GitHub para nosso CI). Viva o Python 3!
• API Java
• ANTLR v3
• Migração v3 para v4, diferenças

Você também pode achar as páginas a seguir úteis, especialmente se quiser mexer nos vários idiomas de destino.

• Como construir o próprio ANTLR
• Como criamos e implantamos uma versão ANTLR

A referência definitiva do ANTLR 4

Os programadores enfrentam problemas de análise o tempo todo. Seja um formato de dados como JSON, um protocolo de rede como SMTP, um arquivo de configuração de servidor para Apache, um arquivo PostScript/PDF ou uma simples linguagem de macro de planilha — o ANTLR v4 e este livro desmistificarão o processo. O ANTLR v4 foi reescrito do zero para tornar mais fácil do que nunca a construção de analisadores e aplicativos de linguagem construídos sobre eles. Esta nova edição completamente reescrita do best-seller Definitive ANTLR Reference mostra como aproveitar esses novos recursos.

Você pode comprar o livro The Definitive ANTLR 4 Reference na amazon ou uma versão eletrônica no site da editora.

Você achará o código-fonte do livro útil.

Gramáticas adicionais

Este repositório é uma coleção de gramáticas sem ações onde o nome do diretório raiz é o nome em letras minúsculas do idioma analisado pela gramática. Por exemplo, java, cpp, csharp, c, etc...