أوامر Linux ومراحلها

صياغة أوامر Linux

تصف هذه الأشكال أداة لبات 0.7.0 الأصلية المنشورة. اتبع صفحة التثبيت للتحقق وإعداد PATH.

aspl [COMMON_OPTIONS] check [--] SOURCE
aspl [COMMON_OPTIONS] run [--] SOURCE
aspl [COMMON_OPTIONS] build [-o OUTPUT | --output=OUTPUT] [--] SOURCE

الخياران المشتركان هما --diagnostic-language=ar|en و--color=auto|always|never. يسبقان الأمر ولا يجوز تكرار أي منهما. القيم حساسة لحالة الأحرف وتستخدم =. تسبق خيارات خرج البناء المصدر. يسمح -- بمسار مصدر يبدأ بشرطة. تنتهي مسارات المصدر بـ.aspl أو .لبات؛ يأخذ الأمر مصدرا جذريا واحدا ويحمل استيراداته الصريحة لوحدات المصدر. لا تقبل الأوامر المصدر من stdin أو جذورا متعددة أو خرج بايت كود عامّا أو معاملات للبرنامج.

استخدم aspl --version أو aspl --help أو aspl build --help للمعلومات. الإصدار سطر مستقل عن اللغة هو aspl 0.7.0. تستخدم المساعدة والتشخيصات العربية افتراضيا بغض النظر عن مفردات المصدر أو لغة العملية. للإنجليزية، استخدم aspl --diagnostic-language=en --help.

مراحل الترجمة والتنفيذ

تقرأ الأوامر الثلاثة المصدر وتحل وحداته الصريحة وتترجم بايت الكود الخاص وتتحقق منه. يتخلص check بعد ذلك من النتيجة. يجهز run الاعتمادات الأصلية وينفذ في العملية نفسها. يغلف build ملف ELF ويتحقق منه ويكتب ملفا مؤقتا في مجلد الوجهة ثم ينشره بإعادة تسمية ذرية. لا يستدعي مترجما خارجيا أو رابطا. لا ينفذ الفحص والبناء البرنامج ولا يحملان مكتباته الخارجية.

دون خيار خرج، يزيل البناء لاحقة المصدر الأخيرة. تستخدم مسارات الخرج الصريحة كما قدمت. لا تنشأ المجلدات الأب المفقودة. يرفض الخرج الذي يطابق المصدر. يحتفظ الفشل قبل النشر بالخرج السابق، ويستبدله النشر الناجح. لا تضمن الرؤية الذرية المتانة عند انقطاع الطاقة.

الحالات وقنوات الخرج

يعيد الفحص أو البناء الناجح صفرا ويكون صامتا ما لم توجد تحذيرات. يعيد run والبرنامج المبني نتيجة دالة البداية الصحيحة العادية من 0 إلى 255. تؤدي النتيجة خارج المجال إلى فخ. قد تتداخل النتائج العادية غير الصفرية مع حالات الفشل؛ افحص stderr للتشخيصات. لا تغير التحذيرات حالة النجاح.

يستخدم خرج البرنامج stdout وتستخدم التشخيصات والفخاخ stderr. لا يضيف run رسالة نجاح إلى خرج البرنامج. استخدم --color=never لتشخيصات بلا ألوان في السكربتات. ترث الأداة دليل العمل والبيئة والقنوات القياسية. للكود الخارجي صلاحية العملية الأصلية وقد يفشل خارج ضمانات وقت تشغيل لبات.

خيارات البرنامج المبني

لا يقبل البرنامج المبني إلا --aspl-diagnostic-language=ar|en و--aspl-color=auto|always|never، كل منهما مرة واحدة باستخدام =. دون خيارات، تكون التشخيصات عربية والألوان تلقائية. لا يقبل معاملات عادية أو -- أو --help أو --version. مثلا، يشغل ./hello --aspl-diagnostic-language=en --aspl-color=never البرنامج. انظر الإدخال الأصلي والتنفيذ المستقل.