منسّق Python (Ruff)

ما هو منسّق Python؟

يشغّل منسّق Python منسّق Ruff – منسّق Python سريع ومتوافق مع Black – مباشرة في متصفحك عبر WebAssembly. يوحّد المسافات البادئة والتباعد وعلامات الاقتباس والأسطر الفارغة والتفاف الأسطر عند 88 حرفًا.

كيفية استخدام منسّق Python

1. الصق كود Python في مربع الإدخال أو اضغط تحميل مثال.
2. اختر المسافة البادئة ونمط علامات الاقتباس.
3. اضغط التنسيق. يُنزَّل محرك Ruff (WebAssembly، بضعة ميغابايت) عند التشغيل الأول؛ وتكون التشغيلات التالية فورية.
4. انسخ الكود المنسّق أو نزّله.

مثال

def f(a,b):
  return {'x':a}

def f(a, b):
    return {"x": a}

متى تستخدم منسّق Python

استخدمه لترتيب السكربتات والمقاطع، أو تنسيق الكود للإجابات والتعليم، أو التأكد من أن الكود قابل للتحليل. يقتصر على التنسيق – لا يطبّق إصلاحات lint مثل حذف الاستيرادات غير المستخدمة أو ترتيبها. وفي المشاريع شغّل ruff format أو Black محليًا بإعداداتك.

كيف يعمل منسّق Python

تُحمَّل عند الطلب النسخة الرسمية @astral-sh/ruff-wasm-web من Ruff. تُنشأ مساحة عمل Ruff بقيمة line-length = 88 وقيم indent-width / indent-style وquote-style المختارة، ثم تُستدعى دالة format. يحلّل Ruff الكود إلى شجرة صياغة ويطبعه بأسلوب Black (مثلًا سطران فارغان بين التعريفات في المستوى الأعلى والفواصل الأخيرة السحرية). وإذا تعذّر تحليل الكود يُعرض خطأ Ruff مع السطر والعمود.

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

• ✓ تنسيق كود Jupyter أو السكربتات قبل مشاركتها
• ✓ جعل كود الدروس متوافقًا مع PEP 8
• ✓ فحص صياغة Python دون تثبيت أي شيء
• ✓ تحويل المسافة البادئة من 2 إلى 4

الأسئلة الشائعة

استكشف المزيد من الفئات