Téléchargement de mab - Téléchargement du code source mab

mab

Autres catégories

1.0.0

Télécharger

Mab, un analyser Lua sans perte à Rust

Plus maintenu

Découvrez la pleine lune à la place, le successeur de MAB!

Ceci est un travail en cours de l'analyseur LUA 5.1+ à perte de perte écrite en rouille. Il préservera tous les commentaires, les espaces blancs et les distinctions de style comme les citations et l'évasion.

Je veux utiliser MAB pour un certain nombre de projets futurs:

Outil d'analyse statique pour remplacer Luacheck
Vérificateur de style et réformatrice comme GoFMT ou RustFMT (peut-être nommé "Stylua")
Typage statique comme dactylographié ou flux
Parser / générateur de documentation comme RustDoc, plus robuste que LDOC
Un outil comme Rerrast de Google pour Rust ou Codemod de Facebook

Objectifs

PUC-RIO LUA 5.1+, support Luajit 2.0+
- Valider éventuellement contre les versions spécifiques de Lua en jetant entre les AST
Préservation 100% Style et Whitespace
- Vous devriez être en mesure de lire et d'écraser votre projet entier et d'avoir aucun changement
Fondation pour une analyse statique et un frappeur fort
Prise en charge des extensions de langue sans casser les outils existants
- L'AST devrait pouvoir lancer dans n'importe quelle version normale de Lua
- Le projet doit soit:
  - Tirez parti du système de type Rust (modèles non exhaustifs, en particulier) pour garantir que les outils peuvent être recompilés avec des fourches de ce projet sans aucun changement.
  - Ou, utilisez une technique similaire à un système de composants d'entité pour implémenter des jetons étendus et des nœuds AST.

Contributif

Les contributions sont les bienvenues - il y a beaucoup de travail à faire!

MAB prend en charge Rust 1.26 stable et plus récent.

Il y a déjà une suite de tests assez importante implémentée en tant que système "analyse par exemple". Les entrées de fichiers de test sont situées dans parse_examples/source .

Le runner de test ( cargo test ) lira, tokenize et analysera ces fichiers source et vérifiera le dernier dossier de résultats connu ( parse_examples/results ) pour voir s'ils correspondent à ce qu'ils ont fait auparavant.

Si vous apportez des modifications qui modifient l'AST de l'analyseur, supprimez la liste de jetons sérialisée correspondante et les fichiers AST JSON. Lorsque vous exécutez le Runner Test ensuite, il générera des fichiers qui devraient être examinés manuellement et soumis parallèlement à votre modification. Le spectateur DIFF de Git peut aider à identifier si ce qui a été modifié était intentionnel.

Soyez prudent avec les fins de ligne lors du développement sous Windows. Le référentiel a un fichier .editorconfig ainsi qu'un fichier .gitattributes pour essayer de garantir que tous les fichiers LUA ont des terminaisons de ligne LF par opposition à CRLF . Enregistrant une analyse par exemple de la liste de jetons avec des terminaisons de ligne CRLF qui y sont cueillies entraîneront l'échec de CI.