mab

Mab, parser lua lossless di karat

---

Tidak lagi dipertahankan

Lihat Bulan Purnama sebagai gantinya, penerus MAB!

---

Ini adalah pekerjaan yang sedang berlangsung Lua 5.1+ Parser yang ditulis dalam karat. Ini akan mempertahankan semua komentar, spasi putih, dan perbedaan gaya seperti kutipan dan melarikan diri.

Saya ingin menggunakan mAb untuk sejumlah proyek masa depan:

• Alat Analisis Statis Untuk Mengganti Luacheck
• Pemeriksa gaya dan reformatter seperti gofmt atau rustfmt (mungkin bernama "stylua")
• Pengetikan statis seperti naskah atau aliran
• Dokumentasi Parser/Generator Seperti RustDoc, lebih kuat dari LDOC
• Alat seperti Rerast Google untuk Codemod Rust atau Facebook

Sasaran

• PUC-RIO LUA 5.1+, LUAJIT 2.0+ Dukungan
  • Secara opsional validasi terhadap versi spesifik LUA dengan casting antara AST
• 100% gaya dan pelestarian whitespace
  • Anda harus dapat membaca dan menimpa seluruh proyek Anda dan tidak memiliki perubahan
• Fondasi untuk analisis statis dan pengetikan yang kuat
• Dukungan untuk ekstensi bahasa tanpa melanggar alat yang ada
  • AST harus dapat melemparkan ke versi normal Lua
  • Proyek harus:
    • Leverage Sistem Jenis Rust (pola tidak lengkap, terutama) untuk menjamin bahwa alat dapat dikompilasi ulang dengan garpu proyek ini dengan perubahan nol.
    • Atau, gunakan teknik yang mirip dengan sistem komponen entitas untuk mengimplementasikan token yang diperluas dan node AST.

Berkontribusi

Kontribusi dipersilakan - ada banyak pekerjaan yang harus dilakukan!

MAB mendukung karat 1.26 stabil dan lebih baru.

Sudah ada suite uji yang cukup besar yang diimplementasikan sebagai sistem "parse dengan contoh". Input file uji terletak di parse_examples/source .

Test Runner ( cargo test ) akan membaca, tokenize, dan menguraikan file-file sumber ini dan memeriksa folder hasil baik yang diketahui terakhir ( parse_examples/results ) untuk melihat apakah mereka cocok dengan apa yang mereka lakukan sebelumnya.

Jika Anda membuat perubahan yang memodifikasi AST parser, hapus daftar token serial yang sesuai dan file ast json. Saat Anda menjalankan Test Runner berikutnya, itu akan menghasilkan file yang harus ditinjau secara manual dan diserahkan di samping perubahan Anda. Penampil diff Git dapat membantu mengidentifikasi apakah apa yang diubah itu disengaja.

Hati -hati dengan ujung garis saat berkembang di windows. Repositori memiliki file .editorconfig serta file .gitattributes untuk mencoba menjamin bahwa semua file LUA memiliki ujung garis LF yang bertentangan dengan CRLF . Memeriksa parse dengan contoh daftar token dengan ujung garis CRLF yang dipanggang ke dalamnya akan menyebabkan CI gagal.

Lisensi

Proyek ini tersedia di bawah ketentuan Lisensi Publik Mozilla, versi 2.0. Detail tersedia dalam lisensi.