مُصَيِّغ كود سكالا (نُسخة Scalafmt)

مطورنص
إعلان · حذف؟
إعلان · حذف؟

مرشد

مُعدّل كود السكالا (أسلوب Scalafmt)

مُصَيِّغ كود سكالا (نُسخة Scalafmt)

الإدخال المباشر لصيغة سكالا واحصل على نسخة مُصاغة وفقًا لأسلوب Scalafmt — تَمَثّل التَّسْمِيَة بـ مسافتين، توازن الأقواس، توازن المسافات بين المُعاملات، ترتيب التصاريح، وأعمدة متوازية، والنتائج مُحددة، أي أن نفس المدخل يُنتج نفس النتيجة، مما يُسهم في تحسين التغييرات في المراجعة، ويُقلل من التبادل حول المسافات.

كيفية استخدام

  1. أدخل كودك السكالا في مربع الإدخال، أو استخدم المثال لرؤية كيفية عمله.
  2. اختر نمط التسجيل (الافتراضي هو مسافتين)، وحدة العرض الأقصى (80، 100، 120، أو 160).
  3. قم بتفعيل الخيارات التي ترغب في تفعيلها: أعمدة متوازية في القوائم المتعددة الأسطر، ترتيب/تصنيف التصاريح، توازن المسافات بين المُعاملات، الحفاظ على التعليقات، وانسجام الأسطر الفارغة.
  4. انقر شكل. انسخ النتيجة باستخدام زر النسخ أو احفظها كـ .scala ملف.

خصائص

  • نمط الافتراضي لـ Scalafmt – يُعكس المبادئ المستخدمة في أداة scalafmt الرسمية، بما في ذلك التسجيل، معالجة الأقواس، ومسافات المُعاملات الثنائية.
  • مسافات بادئة قابلة للتكوين – اختر مسافتين، أو أربع مسافات، أو مُسافات التبديل لتتماشى مع دليل التصميم الخاص بمشروعك.
  • العرض الأقصى للعمود – اختر 80، 100، 120، أو 160 لتتناسب مع سياسة التسجيل الخاصة بفريقك.
  • التصنيف والترتيب المُسبق للتصاريح – يُرتّب التصاريح حسب الأحرف الأبجدية ويُصنفها إلى مجموعات من البُنية المُعيّنة، المُستخدمة خارج المشروع، والمحلي، مع فواصل فارغة بين المجموعات.
  • المسافات الخلفية – يضيف أعمدة متوازية في القوائم المتعددة الأسطر والقوائم المُدخلة كجزء من تحسين التغييرات في المراجعة.
  • إبقاء التعليقات – يُحتفظ بالتعليقات السطرية، التعليقات المُتسلسلة، والتعليقات المُخصصة في سكالا مع تحسين الكود المحيط.
  • مُستقر للنصوص والتعويضات – لا يُغير محتوى النصوص، أو الأحرف المُحددة، أو النصوص المُتعددة الأسطر، أو s"..." / f"..." التعويضات.
  • مُناسب للسكالا 3 – يُفهم مصطلحات السكالا الحديثة مثل given, using, then, enumو، و derives.
  • يُشغل بالكامل في المتصفح الخاص بك – لا يوجد تحميل، لا يوجد تبادل على الخادم، لا يوجد تحليل. لا يغادر كودك جهازك.

حالات الاستخدام الشائعة

  • تُنظّف مقطعًا بسيطًا من الكود قبل نسخه إلى محادثة سلوك، أو إجابة على سكالا، أو مقال تقني.
  • يُوحّد التنسيق في مشاريع قديمة لا تمتلك بعد تكوينًا لـ scalafmt مُثبتًا.
  • يُعدّ الكود المُولَّد (مخرجات المُكَوّنات، أو كلاسات مُستمدة من نماذج، إلخ) بحيث يُشبه الكود المُكتوب يدويًا.
  • يُوحّد الأسلوب بين الملفات المُعدّة من قبل مُساهمين مختلفين، كل منهم استخدم إعدادات مُختلفة في بيئة تطوير.
  • يُحقق تحققًا أوليًا لتعديل بسيط دون تشغيل sbt أو سلسلة بناء السكالا.

التعليمات

  1. ما هو Scalafmt وما أهمية التنسيق المتسق للسكالا؟

    Scalafmt هو الأداة المُعتمدة في نظام السكالا. فهو يُفرض نمطًا موحدًا ودقيقًا في كل مشاريع الكود، مما يُقلل من مناقشات التنسيق في مراجعات الكود، ويقلل من التغييرات المُزعجة الناتجة عن المسافات، ويُسهم في دمج المُساهمين الجدد مع باقي المشروع. كما أن التنسيق المتسق يُسهل رؤية الكود غير المألوف لأن التسجيل والمسافات تُحمل دائمًا نفس المعنى.

  2. لماذا يُعتمد Scalafmt على حد أقصى لعرض العمود 80؟

    تعود تقليد 80 عمود إلى الأجهزة المبكرة والبطاقات المُثبّتة، لكنه يُحتفظ به حتى اليوم لأن الأسطر الضيقة أسهل في القراءة في مقارنات الأسطر، أدوات المراجعة، أو شاشات المُقسّم. يُشجع الحد الأقصى لـ 80 على استخدام أسماء أقصر، تقليل التعبيرات المتداخلة، وزيادة استخلاص المُساعدات. يُسمح لعديد الفرق بزيادة الحد إلى 100 أو 120 عمود، وهو السبب الذي يجعل الأدوات الحديثة تسمح لك بتعديل هذا الحد.

  3. ما هي الأعمدة المتوازية وما أهميتها؟

    العمود المتوازي هو علامة فاصلة بعد العنصر الأخير في قائمة متعددة الأسطر، أو قائمة المُدخلات، أو قائمة المُدخلات. أصبحت شائعة في الأدوات لأنها تُبقي التغييرات في الأسطر أكثر نظافة: إضافة عنصر جديد يُضيف سطرًا واحدًا بدلًا من تغيير السطر السابق لإضافة علامة فاصلة. كما أن الأعمدة المتوازية تُسهل إعادة ترتيب الأسطر، لأن كل عنصر ينتهي بنفس الطريقة. دعم السكالا للعمود المتوازي في قائمة المُدخلات والمتغيرات بدأ من إصدار 2.12.2.

  4. لماذا يتم تجميع التصاريح عادةً إلى مجموعات من البُنية المُعيّنة، المُستخدمة خارج المشروع، والمحلي؟

    تُعتبر مُتَّسِقَة التصاريح حسب الأصل مُتَّسِقَة منذ زمن بعيد، وتم اقتباسها من لغات مثل Go وPython (مع isort). تُظهر الاعتماد على المُستودعات بسرعة: تأتي التصاريح المُعيّنة أولاً، ثم المُستخدمة خارج المشروع، ثم الكود من نفس المشروع. تُستخدم الفواصل الفارغة بين المجموعات كأعمدة بصرية تُساعدهم على رؤية سريعة عند إدخال تغيير يُشير إلى اعتماد خارجي جديد، وهو علامة غالبًا ما تُناقش.

  5. ما الفرق بين التنسيق السَّيَّمي والمنطقي للكود؟

    يُعيد التنسيق السَّيَّمي ترتيب المسافات، الأسطر، والمسافات المُتَّسِقة بناءً فقط على النص المُدخل — لا يحتاج إلى فهم الأنواع، أو تحليل الأسماء، أو تشغيل المُجمّع. أما التنسيق المنطقي، فيمكنه إعادة تسمية المُدخلات، ترتيب الطرق بناءً على الاستخدام، أو إزالة التصاريح غير المستخدمة لأنه يمتلك رؤية المُجمّع للبرنامج. يُعتبر Scalafmt بشكل أساسي سَيَّمي، مما يجعله سريعًا وآمنًا عند تشغيله على كود غير مكتمل أو غير مُجمّع.

هل تريد حذف الإعلانات؟ تخلص من الإعلانات اليوم

تثبيت ملحقاتنا

أضف أدوات IO إلى متصفحك المفضل للوصول الفوري والبحث بشكل أسرع

أضف لـ إضافة كروم أضف لـ امتداد الحافة أضف لـ إضافة فايرفوكس أضف لـ ملحق الأوبرا

وصلت لوحة النتائج!

لوحة النتائج هي طريقة ممتعة لتتبع ألعابك، يتم تخزين جميع البيانات في متصفحك. المزيد من الميزات قريبا!

إعلان · حذف؟
إعلان · حذف؟
إعلان · حذف؟

ركن الأخبار مع أبرز التقنيات

شارك

ساعدنا على الاستمرار في تقديم أدوات مجانية قيمة

اشتري لي قهوة
إعلان · حذف؟