mab

Mab, um analisador Lua sem perdas em ferrugem

---

Não é mais mantido

Confira a lua cheia, em vez disso, o sucessor de Mab!

---

Este é um obra em progresso Lua 5.1+ analisador escrito em ferrugem. Ele preservará todos os comentários, espaço em branco e distinções de estilo, como citações e fuga.

Quero usar o MAB para vários projetos futuros:

• Ferramenta de análise estática para substituir Luacheck
• Verificador de estilo e reforma como gofmt ou rustfmt (talvez chamado "stylua")
• Digitação estática como datilografado ou fluxo
• Analisador de documentação/gerador como Rustdoc, mais robusto que o LDOC
• Uma ferramenta como o Rerast for Rust para Rust ou Codemod do Facebook

Metas

• PUC-RIO Lua 5.1+, Luajit 2.0+ Suporte
  • Opcionalmente validar contra versões específicas da Lua, lançando entre ASTS
• 100% estilo e preservação de espaço em branco
  • Você deve poder ler e substituir todo o seu projeto e ter zero alterações
• Base para análise estática e dívida forte
• Suporte para extensões de idiomas sem quebrar as ferramentas existentes
  • O AST deve ser capaz de lançar para qualquer versão normal da lua
  • O projeto deve:
    • Aproveite o sistema de tipo de ferrugem (principalmente padrões não exaustivos) para garantir que as ferramentas possam ser recompiladas com garfos deste projeto com zero alterações.
    • Ou use uma técnica semelhante a um sistema de componentes de entidade para implementar tokens estendidos e nós AST.

Contribuindo

As contribuições são bem -vindas - há muito trabalho a ser feito!

O MAB suporta Rust 1.26 estável e mais recente.

Já existe um conjunto de testes bastante considerável implementado como um sistema "análise por exemplo". As entradas do arquivo de teste estão localizadas em parse_examples/source .

O teste de teste ( cargo test ) lerá, tokenizará e analisará esses arquivos de origem e verificará a última pasta de resultados bons conhecidos ( parse_examples/results ) para ver se eles correspondem ao que fizeram antes.

Se você estiver fazendo alterações que modificam o AST do analisador, exclua a lista de token serializada correspondente e os arquivos JSON AST. Quando você executa o Test Runner em seguida, ele gera arquivos que devem ser revisados ​​e enviados manualmente ao lado de sua alteração. O espectador DIF do Git pode ajudar a identificar se o que foi alterado foi intencional.

Tenha cuidado com as terminações de linha ao desenvolver no Windows. O repositório possui um arquivo .editorconfig , bem como um arquivo .gitattributes para tentar garantir que todos os arquivos Lua têm terminações de linha LF em oposição ao CRLF . Verificando em uma lista de análise por exemplo, com as terminações da linha CRLF assadas nela, fará com que o IC falhe.

Licença

Este projeto está disponível nos termos da licença pública de Mozilla, versão 2.0. Os detalhes estão disponíveis na licença.