mab

mab、錆のロスレスluaパーサー

---

もはや維持されません

MABの後継者、代わりに満月をチェックしてください！

---

これは、Rustで記述されたProgress Lossless Lua 5.1+パーサーです。引用や逃亡など、すべてのコメント、白文学、スタイルの区別を保持します。

多くの将来のプロジェクトにmabを使用したい：

• Luacheckを置き換える静的分析ツール
• GOFMTやRustfmtのようなスタイルチェッカーと改革派（「Stylua」と名付けられたかもしれません）
• タイプスクリプトやフローのような静的タイピング
• rustdocのようなドキュメントパーサー/ジェネレーター、LDOCよりも堅牢です
• GoogleのRustまたはFacebookのCodeModのようなツール

目標

• Puc-rio lua 5.1+、luajit 2.0+サポート
  • オプションで、AST間でキャストすることにより、LUAの特定のバージョンに対して検証します
• 100％のスタイルと空白の保存
  • プロジェクト全体を読んで上書きし、変更がゼロになるはずです
• 静的分析と強力なタイピングの基礎
• 既存のツールを壊すことなく、言語拡張のサポート
  • ASTは、LUAの通常のバージョンにキャストできるはずです
  • プロジェクトは次のとおりです。
    • Rustのタイプシステム（特に非網膜パターン）を活用して、このプロジェクトのフォークを変更して変更をゼロで再コンパイルできることを保証します。
    • または、エンティティコンポーネントシステムに似た手法を使用して、拡張トークンとASTノードを実装します。

貢献

貢献は大歓迎です - やるべきことがたくさんあります！

MABはRust 1.26安定性と新しいものをサポートします。

「例別の例」システムとして実装されているかなり大きなテストスイートがすでにあります。テストファイル入力はparse_examples/sourceにあります。

テストランナー（ cargo test ）は、これらのソースファイルを読み取り、トークン化、解析し、最後に知られている良好な結果フォルダー（ parse_examples/results ）を確認して、以前にしたことと一致するかどうかを確認します。

パーサーのASTを変更する変更を行っている場合は、対応するシリアル化されたトークンリストとAST JSONファイルを削除します。次にテストランナーを実行すると、変更とともに手動でレビューおよび送信する必要があるファイルが生成されます。 GitのDiff Viewerは、変更されたものが意図的であるかどうかを特定するのに役立ちます。

Windowsで開発するときは、ラインエンディングに注意してください。リポジトリには.editorconfigファイルと.gitattributesファイルがあり、すべてのLUAファイルがCRLFとは対照的にLFラインエンディングがあることを保証しようとします。 CRLFラインエンディングを使用して、TOKENリストごとに処理すると、CIが失敗します。

ライセンス

このプロジェクトは、Mozilla Public Licenseの条件であるバージョン2.0で入手できます。詳細はライセンスで利用できます。