‏zig fmt: تنسيق الشيفرة

توفّر Zig منسّقًا مضمّنًا، بحيث يبدو كل مشروع بالطريقة نفسها. يعيد الأمر zig fmt كتابة الشيفرة وفق النمط المعتمد في Zig.

مرّر ملفًا إلى zig fmt، وسيعيد تنسيق الملف مباشرةً على القرص، مع إصلاح المسافات البادئة والتباعد وفواصل الأسطر نيابةً عنك.

مرّر إليه directory، وسيستعرضه zig fmt بشكل تكراري وينظّف كل ملف ‎.zig يعثر عليه. وبأمر واحد، يمكنك تنسيق مشروع كامل.

لا توجد style options للتجادل بشأنها. إذ يستخدم Zig fmt نمطًا واحدًا ثابتًا، وينهي بذلك نقاشات التنسيق في كل فريق وكل قاعدة شيفرة.

يبلّغ الخيار --check عن الملفات غير المنسّقة وينهي التنفيذ بخطأ، لكنه لا يعدّل أي شيء مطلقًا. وهذا مثالي للتحقق.

بما أن --check يعيد exit code يدل على الفشل، يمكنك ربطه بالتكامل المستمر لرفض أي شيفرة غير منسّقة تلقائيًا.

مرّر الخيار --stdin، وسيُنسّق zig fmt النص المُمرَّر عبر الأنابيب ثم يطبع النتيجة. تستخدم المحررات ذلك للتنسيق عند الحفظ.

يشغّل معظم المحررات zig fmt تلقائيًا عند save. فتنتظم شيفرتك فورًا، ولن تضطر إلى التفكير في التخطيط مجددًا.

تذكّر نطاق عمله: يصلح zig fmt layout فقط. ولن يعيد تسمية العناصر أو يكتشف أخطاء المنطق؛ فهذه مهمة المصرّف.

يترك zig fmt غالبًا line breaks في القيم الحرفية والتعليقات كما هي، فينظّف البنية دون محو التخطيط المقصود.

شغّل المنسّق before كل عملية commit. فالفروقات النظيفة والمتسقة تسرّع المراجعات وتحافظ على سهولة قراءة السجل كاملًا للجميع.

في التكامل المستمر، تريد فشل عملية البناء عندما لا تكون الشيفرة منسّقة، من دون تعديل أي ملفات. ما الأمر الذي يحقق ذلك؟

تعرّفت إلى zig fmt: نمط واحد معتمد، وتنسيق للملفات أو المجلدات، و--check للتكامل المستمر، والتنسيق عند الحفظ في المحرر للحفاظ على نظافة الشيفرة بسهولة. 🧹