antlr4

ANLR v4

ANTLR (Otra herramienta para el reconocimiento de idiomas) es un potente generador de analizadores para leer, procesar, ejecutar o traducir texto estructurado o archivos binarios. Se usa ampliamente para crear lenguajes, herramientas y marcos. A partir de una gramática, ANTLR genera un analizador que puede construir árboles de análisis y también genera una interfaz de escucha (o visitante) que facilita la respuesta al reconocimiento de frases de interés.

Estado de compilación de la rama de desarrollo

(acciones de github)

Versionado

ANTLR 4 admite 10 lenguajes de destino (Cpp, CSharp, Dart, Java, JavaScript, PHP, Python3, Swift, TypeScript, Go) y garantizar la coherencia entre estos objetivos es una característica única y muy valiosa. Para garantizar el soporte adecuado de esta función, cada versión de ANTLR es una versión completa de la herramienta y los 10 tiempos de ejecución, todos con la misma versión. Como tal, el control de versiones ANTLR no sigue estrictamente la semántica de semver:

• un componente puede lanzarse con el número de versión más reciente aunque nada haya cambiado dentro de ese componente desde la versión anterior
• La versión principal se elimina sólo cuando ANTLR se reescribe para una "generación" totalmente nueva, como ANTLR3 -> ANTLR4 (LL(*) -> ALL(*) análisis)
• las actualizaciones de versiones menores pueden incluir cambios menores, la política es regenerar analizadores con cada versión (4.11 -> 4.12)
• La compatibilidad con versiones anteriores solo está garantizada para los cambios en la versión del parche (4.11.1 -> 4.11.2)

Si utiliza un verificador semver en su CI, probablemente desee aplicar reglas especiales para ANTLR, como tratar los cambios menores como cambios importantes.

Estructura de la sucursal de repositorio

La rama predeterminada para este repositorio es master , que es la última versión estable y tiene etiquetas para las distintas versiones; por ejemplo, consulte la etiqueta de lanzamiento 4.9.3. La rama de dev es donde se produce el desarrollo entre lanzamientos y todas las solicitudes de extracción deben derivarse de esa rama. La rama dev se fusiona nuevamente con master para cortar una versión y el estado de la versión se etiqueta (por ejemplo, con 4.10-rc1 o 4.10 ). Visualmente, nuestro proceso se ve más o menos así:

El objetivo de Go ahora tiene su propio repositorio dedicado:

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

Nota El repositorio de Go dedicado es solo para go get e import . El desarrollo del tiempo de ejecución de Go todavía se realiza en el repositorio principal antlr/antlr4 .

Autores y contribuyentes principales

• Terence Parr, [email protected] Líder del proyecto ANTLR y dictador supremo vitalicio Universidad de San Francisco
• Sam Harwell (coautor de la herramienta, destino Java y C# original)
• Eric Vergnaud (objetivos Javascript, TypeScript, Python2, Python3 y mantenimiento del objetivo C#)
• Peter Boyer (Ir al objetivo)
• Mike Lischke (objetivo completado en C++)
• Dan McLaughlin (objetivo inicial de C++)
• David Sisson (objetivo inicial y prueba de C++)
• Janyou (objetivo rápido)
• Ewan Mellor, Hanzhou Shi (Fusión de objetivos rápidos)
• Ben Hamilton (Compatibilidad total con Unicode en ATN serializado y tiempos de ejecución de todos los idiomas para puntos de código > U+FFFF)
• Marcos Passos (objetivo PHP)
• Lingyu Li (objetivo de dardo)
• Ivan Kochurkin ha realizado importantes contribuciones a la calidad general, el manejo de errores y el rendimiento de Target.
• Justin King ha realizado una gran cantidad de trabajo en múltiples objetivos, pero especialmente para C++.
• Ken Domino tiene una habilidad especial para encontrar errores/problemas y realizar análisis; También es un colaborador importante en el repositorio Grammars-v4.
• Jim Idle contribuyó a versiones anteriores de ANTLR y recientemente volvió a participar para resolver un problema importante con el objetivo Go.

Información útil

• Notas de la versión
• Comenzando con v4
• Sitio oficial
• Documentación
• Preguntas frecuentes
• Objetivos de generación de código ANTLR
  (Actualmente: Java, C#, Python3, JavaScript, TypeScript, Go, C++, Swift, Dart, PHP)
• Nota: A partir de la versión 4.14, dejaremos de admitir Python 2. Nos encanta la comunidad de Python, pero el soporte de Python 2 se detuvo oficialmente en enero de 2020. Más recientemente, GiHub también dejó de admitir Python 2, lo que nos lo hizo imposible. para mantener un nivel constante de calidad en todos los objetivos (utilizamos GitHub para nuestra CI). ¡Larga vida a Python 3!
• API de Java
• ANLR v3
• Migración v3 a v4, diferencias

También puede que le resulten útiles las siguientes páginas, especialmente si desea experimentar con los distintos idiomas de destino.

• Cómo construir el propio ANTLR
• Cómo creamos e implementamos una versión ANTLR

La referencia definitiva de ANTLR 4

Los programadores se encuentran con problemas de análisis todo el tiempo. Ya sea un formato de datos como JSON, un protocolo de red como SMTP, un archivo de configuración de servidor para Apache, un archivo PostScript/PDF o un lenguaje de macros de hoja de cálculo simple, ANTLR v4 y este libro desmitificarán el proceso. ANTLR v4 se ha reescrito desde cero para que sea más fácil que nunca crear analizadores y aplicaciones de lenguaje integradas. Esta nueva edición completamente reescrita del best seller Definitive ANTLR Reference le muestra cómo aprovechar estas nuevas características.

Puede comprar el libro The Definitive ANTLR 4 Reference en Amazon o una versión electrónica en el sitio del editor.

El código fuente del libro le resultará útil.

Gramáticas adicionales

Este repositorio es una colección de gramáticas sin acciones donde el nombre del directorio raíz es el nombre en minúsculas del idioma analizado por la gramática. Por ejemplo, java, cpp, csharp, c, etc...