mab

Mab, ein verlustloser Lua -Parser in Rost

---

Nicht mehr gepflegt

Schauen Sie sich stattdessen Full Moon an, Mabs Nachfolger!

---

Dies ist eine laufende Arbeit, verlustfreier Lua 5.1+ Parser in Rost geschrieben. Es wird alle Kommentare, Whitespace und Stilunterschiede wie Zitate und Flucht erhalten.

Ich möchte MAB für eine Reihe von zukünftigen Projekten verwenden:

• Statische Analyse -Tool zum Ersetzen von Luacheck
• Style Checker und Reformatier wie GOFMT oder Rustfmt (vielleicht "Stylua" genannt)
• Statische Typisierung wie Typenkript oder Fluss
• Dokumentation Parser/Generator wie Rustdoc, robuster als LDOC
• Ein Tool wie Googles Rerast für Rust oder Facebooks Codemod

Ziele

• Puc-rio Lua 5.1+, Luajit 2.0+ Unterstützung
  • Optional validieren Sie gegen bestimmte Versionen von Lua, indem Sie zwischen ASTS gegossen
• 100% Stil und Weißwahrerhaltung
  • Sie sollten in der Lage sein, Ihr gesamtes Projekt zu lesen und zu überschreiben und keine Änderungen vorzunehmen
• Grundlage für statische Analysen und starke Typisierung
• Unterstützung für Sprachverlängerungen ohne Brechen vorhandener Tools
  • Der AST sollte in der Lage sein, auf eine normale Version von Lua zu werfen
  • Das Projekt sollte entweder:
    • Nutzen Sie das Typ-System von Rust (insbesondere nicht exexhustive Muster), um sicherzustellen, dass Tools mit Nullwechsel mit Gabeln dieses Projekts neu kompiliert werden können.
    • Oder verwenden Sie eine Technik, die einem Entitätskomponentensystem ähnelt, um erweiterte Token und AST -Knoten zu implementieren.

Beitragen

Beiträge sind willkommen - es gibt viel zu tun!

MAb unterstützt Rost 1,26 stabil und neuer.

Es gibt bereits eine ziemlich beträchtliche Testsuite, die als "Analyse mit Beispiel" -System implementiert wird. Die Testdateieingaben finden Sie in parse_examples/source .

Der Testläufer ( cargo test ) wird diese Quelldateien lesen, tokenisieren und analysiert und den zuletzt bekannten Ordner für gute Ergebnisse ( parse_examples/results ) überprüft, um zu sehen, ob sie mit dem übereinstimmen, was sie zuvor getan haben.

Wenn Sie Änderungen vornehmen, die den AST des Parsers ändern, löschen Sie die entsprechende serialisierte Token -Liste und die AST -JSON -Dateien. Wenn Sie den Testläufer als nächstes ausführen, werden Dateien generiert, die neben Ihrer Änderung manuell überprüft und eingereicht werden sollten. Der Diff -Viewer von Git kann helfen, festzustellen, ob das geänderte Veränderung beabsichtigt war.

Seien Sie vorsichtig mit den Linienenden, wenn Sie sich unter Windows entwickeln. Das Repository verfügt über eine .editorconfig -Datei sowie eine .gitattributes -Datei, um zu garantieren, dass alle LUA -Dateien im Gegensatz zu CRLF LF -Zeilenenden haben. Wenn Sie mit einer Beispiel -Token -Liste mit CRLF -Linien -Enden einchecken, wird CI fehlgeschlagen.

Lizenz

Dieses Projekt ist unter den Bestimmungen der Mozilla Public Lizenz, Version 2.0, verfügbar. Details sind in Lizenz verfügbar.