يطبق StyLua نمط كود Lua وحيد وحتمي عبر المشاريع
يقوم بتنسيق مصدر Lua إلى نمط حتمي من شجرة تحليل مجزأة، مما ينتج نفس المخرجات بغض النظر عن المسافات الأصلية أو فواصل الأسطر. تم إنشاؤه بواسطة JohnnyMorganz لتطوير سطح المكتب، يستهدف الأداة مشاريع Lua و Luau و LuaJIT وتتكامل على مستوى المحرر أو CI. يوفر تكامل LSP، وواجهة سطر الأوامر مع أوضاع الفحص والاختلاف، وتكوين TOML لكل مشروع، مما يجعله مناسبًا للمطورين ومنشئي Roblox الذين يحتاجون إلى تنسيق متوقع وآلي.
ما الذي يفعله ومن يستفيد
ستايLua يعيد كتابة كود Lua من تمثيل مُحلل، بحيث تتبع الملفات نمطًا واحدًا ومحددًا بعد التنسيق. إنه يدعم عدة لهجات من Lua بما في ذلك Luau و LuaJIT، ويعرض واجهة سطر الأوامر بالإضافة إلى دعم بروتوكول خادم اللغة لتكامل المحرر. يمكن للفرق التي ترغب في نمط مفروض واحد إضافة ملف TOML على مستوى المشروع أو .editorconfig لتعريف التباعد، وعرض الأعمدة، وتفضيلات الاقتباس.
كيف يتفاعل مع أنظمة التطوير
الأداة مصممة لتشغيلات سريعة وقابلة للتكرار في سير العمل المحلي والأوتوماتيكي. إن تنفيذها بلغة Rust ينتج تنسيقًا منخفض الكمون مناسبًا لإجراءات المحرر عند الحفظ أو الوظائف على مستوى المستودع. إنها توفر أوضاع التحقق والفرق للتكامل المستمر، وتدعم .styluaignore لاستبعاد المسارات. يحدد تنسيق النطاق التعديلات على مناطق الكود المحددة، مما يقلل من التغييرات في الملفات الكبيرة أثناء التعديلات التدريجية.
السلامة، التكوين، وسهولة الاستخدام
ستايLua يعمل بشكل حتمي ويقدم روابط محرر لتقليل الخطوات اليدوية. خيار LSP يوفر تنسيقًا في الوقت الحقيقي داخل المحررات المدعومة، بينما تتيح لك علامات CLI التحقق من النمط دون تغيير الملفات. يحافظ التكوين عبر stylua.toml على القواعد في جذر المشروع، وتمنع ملفات التجاهل إعادة الكتابة غير المقصودة. يمكن للمستخدمين ذوي الخبرة القليلة في Lua الاعتماد على الإعدادات الافتراضية؛ بينما يمكن للمستخدمين المتقدمين ضبط القواعد من خلال مخطط TOML.
موصى به للفرق التي تحتاج إلى تنسيق Lua تلقائي وقابل للتكرار
StyLua يناسب المطورين ومبدعي Roblox الذين يحتاجون إلى تنسيق متسق عبر قاعدة الشيفرة وأدوات سريعة لعمليات التحرير أو سير العمل CI. توقع جهد تكوين لمرة واحدة ليتناسب مع أسلوبك المفضل، ثم قم بأتمتة التنسيق كخطوة قبل الالتزام أو خطوة CI لفرضه. موصى به.
