mab

Mab, un analizador de lua sin pérdidas en óxido

---

Ya no mantenido

¡Mira la luna llena en su lugar, el sucesor de MAB!

---

Este es un análisis de trabajo sin pérdidas Lua 5.1+ escrito en óxido. Preservará todos los comentarios, espacios en blanco y distinciones de estilo, como citas y escapadas.

Quiero usar MAB para varios proyectos futuros:

• Herramienta de análisis estático para reemplazar a Luacheck
• Valor de estilo y reforma como gofmt o rustfmt (tal vez llamado "stylua")
• Tipeo estático como mecanografiado o flujo
• Parser/generador de documentación como Rustdoc, más robusto que LDOC
• Una herramienta como Rerast de Google para Rust o CodeMod de Facebook

Objetivos

• PUC-RIO Lua 5.1+, Luajit 2.0+ Soporte
  • Opcionalmente, valide contra versiones específicas de Lua mediante el lanzamiento entre ASTS
• 100% de preservación de estilo y espacio en blanco
  • Debería poder leer y sobrescribir todo su proyecto y tener cero cambios
• Fundación para el análisis estático y la tipificación fuerte
• Soporte para extensiones de idiomas sin romper las herramientas existentes
  • El AST debería poder lanzar a cualquier versión normal de Lua
  • El proyecto debería:
    • Aproveche el sistema de tipo de Rust (patrones no exhaustivos, especialmente) para garantizar que las herramientas se puedan recompilar con horquillas de este proyecto con cero cambios.
    • O use una técnica similar a un sistema de componentes de entidad para implementar tokens extendidos y nodos AST.

Que contribuye

Las contribuciones son bienvenidas: ¡hay mucho trabajo por hacer!

MAB admite Rust 1.26 estable y más nuevo.

Ya existe un conjunto de pruebas bastante considerable implementado como un sistema de "análisis por ejemplo". Las entradas del archivo de prueba se encuentran en parse_examples/source .

El corredor de prueba ( cargo test ) leerá, tokenizará y analizará estos archivos de origen y verificará la última carpeta de buenos resultados conocida ( parse_examples/results ) para ver si coinciden con lo que hicieron antes.

Si está realizando cambios que modifican el AST del analizador, elimine la lista de token serializada correspondiente y los archivos AST JSON. Cuando ejecute el corredor de prueba a continuación, generará archivos que deben revisarse y enviar manualmente junto con su cambio. El espectador de Diff de Git puede ayudar a identificar si lo que se cambió fue intencional.

Tenga cuidado con las terminaciones de línea cuando se desarrolle en Windows. El repositorio tiene un archivo .editorconfig , así como un archivo .gitattributes para tratar de garantizar que todos los archivos LUA tengan terminaciones de línea LF en lugar de CRLF . Verificar en una lista de tokens de análisis con ejemplo con terminaciones de línea CRLF horneadas en ella hará que CI falle.

Licencia

Este proyecto está disponible bajo los términos de la Licencia Pública de Mozilla, versión 2.0. Los detalles están disponibles en la licencia.