مرجع الأوامر

صياغة الأوامر

يرسل Enter مسودة الأمر التي عليها التركيز. الأسماء مطابقة تماماً وحساسة لحالة الأحرف، ولا تُطبَّق عليها تسوية Unicode. يعمل الاسم العربي والإنجليزي في أي لغة للواجهة. تعني الأقواس المربعة في الصيغ أدناه معاملات اختيارية؛ لا تكتب الأقواس. تمثل PATH وDIR وFILE وCOMMAND المعامل الذي تختاره.

يبلغ حد السطر الكامل، بما فيه الاقتباس، 65,536 بايت بترميز UTF-8. تُرفض NUL وCR وLF. لا يفعل السطر المؤلف من مسافات أو علامات تبويب فقط شيئاً. تفصل المسافات وعلامات التبويب بين الرموز خارج الاقتباس. يحتوي الاقتباس المفرد نصاً حرفياً. يسمح الاقتباس المزدوج بتهريب علامة الاقتباس والشرطة المائلة العكسية فقط، بصيغتي \" و\\. خارج الاقتباس، تجعل الشرطة المائلة العكسية المحرف التالي حرفياً. تتحد الأجزاء المقتبسة وغير المقتبسة المتجاورة في رمز واحد.

تُرفض قبل التنفيذ علامات الاقتباس غير المغلقة والتهريب الناقص ورموز الأوامر أو المعاملات الفارغة و| < > ; & غير المقتبسة أو المهرّبة. لا توجد توسعة صدفة: تبقى ~ و$HOME وأحرف المطابقة والاقتباس العكسي و# حرفية. تهريب المسار المعروض للمعلومة فقط، وليس صيغة لإدخال البايتات الأصلية.

تظهر الخيارات مرة واحدة قبل معامل المسار الوحيد. العلمان الوحيدان هما ls -a وmkdir -p. تقبل أوامر المسارات -- قبل اسم يبدأ بشرطة؛ اقتباس الشرطة وحده لا ينهي تحليل الخيارات. تُرفض الخيارات غير المعروفة أو المكررة والمعاملات المطلوبة المفقودة والمعاملات الزائدة. لا توجد أعلام مركبة أو أعلام طويلة للأوامر أو --help لكل أمر. ترفض الأوامر دون معاملات -- أيضاً. استخدم مساعدة COMMAND.

mkdir "My projects"
cd "My projects"
pwd
cat -- -notes.txt
cat "$HOME"

هذه أوامر منفصلة للوحة الأوامر. يسمّي الأمر الأخير ملفاً حرفياً اسمه $HOME، ولا يوسّع اسم مجلدك المنزلي. يُرفض cat -notes.txt بوصفه خياراً غير معروف. يقرأ cat -- -notes.txt الاسم الحرفي إذا كان موجوداً واستوفى حدود القراءة.

تجعل عمليات الملفات الموجه للقراءة فقط أثناء الانتظار أو الإلغاء. يبقى الناتج قابلاً للقراءة والنسخ. بعد خمس ثوانٍ، تظهر رسالة ما زال الانتظار مستمراً، دون إعادة محاولة أو مهلة للإنجاز. يطلب Ctrl+C الإلغاء، ثم يُرسل SIGKILL بعد 1,000 مللي ثانية عند الحاجة. تستمر ملكية العملية حتى اكتمالها أو تأكيد خروج المساعد. قد تسبق نتيجة مكتملة طلب الإلغاء؛ وقد يؤخر انتظار غير قابل للمقاطعة في النواة الخروج إلى أجل غير محدد. يتيح الإغلاق إلغاء الإغلاق أو إلغاء العملية والإغلاق وينتظر اكتمالها. لا يتراجع الإلغاء عن المجلدات المنشأة.

خيارات بدء التطبيق

استخدم هذه الأوامر في طرفية لينكس، وليس في موجه لوحة الأوامر:

aspl-console --help
aspl-console --version
aspl-console --aspl /opt/aspl/bin/aspl -- "My projects/hello.aspl"

صيغة التطبيق هي aspl-console [--aspl PATH] [SOURCE]. يختار --aspl PATH أو --aspl=PATH ملف لبات التنفيذي لهذا التشغيل. يطبع --help أو -h خيارات التطبيق، ويشمل --help-all خيارات Qt. يعرض --version أو -v إصدار لوحة الأوامر المعبّأ، المستقل عن إصدار لبات. تُرفض الخيارات غير المعروفة وقيمة الخيار المفقودة وأكثر من معامل مصدر واحد. ضع -- قبل معامل مصدر يبدأ بشرطة. تختلف خيارات بدء التطبيق عن أعلام أوامر اللوحة أعلاه.

يملأ معامل المصدر مسودة run -- مقتبسة بأمان بمسار مطلق، دون تنفيذ. اضغط Enter للتحقق وبدء التشغيل. يبقى الملف المفقود القابل للتمثيل مسودة حتى Enter. تترك بايتات الاسم غير القابلة للتمثيل وNUL/CR/LF وعدم توفر أساس المسار النسبي الأصلي أو تجاوز الاقتباس حد الأمر موجهاً فارغاً صالحاً للاستخدام مع تفسير مهرّب.

يفحص كل تشغيل اختيار بدء التطبيق ثم الملف التنفيذي المحفوظ ثم PATH الموروث، بهذا الترتيب. يفشل الاختيار الصريح أو المحفوظ غير الصالح دون بديل. تُحل الخيارات النسبية ومدخلات PATH النسبية أو الفارغة مقابل مجلد بدء التطبيق الفيزيائي الأصلي، بصرف النظر عن أوامر cd اللاحقة. يمنع عدم توفر المجلد الأصلي البحث النسبي، بينما تبقى مدخلات PATH المطلقة صالحة للاستخدام. تعرض الإعدادات اختيار بدء التطبيق النشط؛ ويتطلب تغييره بدء التطبيق مجدداً. يجب تثبيت لبات منفصلة. تم التحقق من أرشيف اللوحة 0.8.0 مع أداة لبات 0.7.0 المثبتة منفصلة. تحقق من حقائق الإصدار المختار ومتطلبات المضيف قبل التثبيت.

help / مساعدة

الصيغة: help [COMMAND] أو مساعدة [COMMAND].

يطبع دون معامل جميع أسماء الأوامر وصيغها وحدودها وإجراءات لوحة المفاتيح في سجل العرض. يختار الاسم العربي أو الإنجليزي المطابق تفاصيل أمر واحد. يحافظ على المجلد الحالي وسجل الأوامر. تُرفض موضوعات المساعدة غير المعروفة وأكثر من معامل واحد. ليس help --help موضوع مساعدة.

help
مساعدة run
help اقرأ

للمفاتيح حسب السياق، اقرأ مفاتيح لوحة الأوامر.

clear / مسح

الصيغة: clear أو مسح، دون معاملات.

يحذف سجل العرض المحتفظ به كله، بما فيه سطر الأمر نفسه. يحافظ على سجل الأوامر والمجلد الحالي. تُرفض المعاملات الزائدة، بما فيها --. لا ينهي مسح العرض برنامجاً جارياً؛ أثناء التشغيل، تكون كتابة clear مدخلاً للبرنامج وليست أمراً للوحة الأوامر.

مسح

للنص المنطقي والنسخ والبحث والاقتطاع والاستدعاء المنفصل، اقرأ الخرج وسجل الأوامر.

settings / إعدادات

الصيغة: settings أو إعدادات، دون معاملات.

يفتح الإعدادات للغة الواجهة ومسار الإدخال وتفضيل لوحة المفاتيح والخطوط وملف لبات التنفيذي المحفوظ. يتحقق تطبيق من الملف التنفيذي قبل تغيير الاختيارات. تترك الاختيارات غير الصالحة الإعدادات السابقة سليمة. يبقى اختيار بدء التطبيق النشط أسبق من الملف التنفيذي المحفوظ. تُرفض المعاملات الزائدة، بما فيها --. يفتح Ctrl+, الإعدادات بلوحة المفاتيح دون إرسال مسودة.

لكل الحقول والحفظ وفشله، استخدم مرجع الإعدادات. لتوقف التحرير، اتبع إعادة محاولة مسار الإدخال الصريحة.

settings

exit / إنهاء

الصيغة: exit أو إنهاء، دون معاملات.

يغلق النافذة عندما تكون جاهزة للأوامر. تُرفض المعاملات الزائدة، بما فيها --. أثناء التشغيل، يكون exit مدخلاً للبرنامج ولا يغلق اللوحة. استخدم إجراء إغلاق النافذة وتأكيد التشغيل أو العملية عند وجود عمل نشط. الإيقاف والإلغاء طلبان، وليسا إنهاءً فورياً أو تراجعاً عن الآثار.

إنهاء

ls / اعرض

الصيغة: ls [-a] [--] [PATH] أو اعرض [-a] [--] [PATH].

يعرض المدخلات المباشرة لمجلد واحد، والمجلد الحالي هو الافتراضي. يشمل -a الأسماء المخفية؛ ويُحذف . و.. دائماً. تظهر المدخلات بترتيب البايتات الأصلية، اسم معروض واحد في كل سطر. تلحق / بالمجلدات و@ بالروابط الرمزية، بما فيها الروابط المعطلة والروابط إلى مجلدات. يحافظ تهريب العرض على بايتات المسار الأصلية؛ وتحصل الأسماء التي لا يمكن إدخالها بأمر على علامة مترجمة.

يقبل حتى 10,000 مدخل مختار و1,048,576 بايت من بيانات UTF-8 المعروضة، بما فيها فواصل LF واللواحق والعلامات. ينجح بلوغ أي حد تماماً. تظهر القائمة المتحققة كاملة دفعة واحدة. تنتج أخطاء نظام الملفات أو تجاوز الحدود خطأً بالأمر والمسار المهرّب والسبب، دون قائمة جزئية. لا يضيف المجلد الفارغ بيانات. تُرفض الخيارات غير المعروفة أو المكررة والمعاملات الزائدة. دون مجلد حالي صالح، تفشل القائمة النسبية؛ استعد باستخدام انتقل بمسار مطلق.

ls
اعرض -a -- "My projects"

cd / انتقل

الصيغة: cd [--] [DIR] أو انتقل [--] [DIR].

يغيّر المجلد الحالي للوحة الأوامر بالتنقل الحقيقي في نظام الملفات، بما فيه الروابط الرمزية وlink/... يعني حذف DIR المجلد المنزلي. ينجح بصمت؛ ويحافظ الفشل على المجلد السابق. لا يوسّع ~ أو $HOME. تُرفض الخيارات غير المعروفة والمعاملات الزائدة.

يستخدم بدء التطبيق مجلده الفيزيائي الصالح، وإلا يفسر الرجوع إلى المنزل. إذا لم يصلح أي منهما، تبقى الأوامر متاحة دون مجلد حالي. تفشل العمليات النسبية ومسار حتى الاستعادة بأمر cd مطلق أو منزل صالح. ينتج عن مجلد أصبح غير متاح أو أُعيدت تسميته خارجياً خطأ دون انتقال تلقائي. لا تستطيع البرامج الابنة تغيير تنقل اللوحة.

انتقل "My projects"
cd
cd -- /tmp

pwd / مسار

الصيغة: pwd أو مسار، دون معاملات.

يطبع المسار الفيزيائي المطلق للمجلد الحالي متبوعاً بـ LF. يُعزل المسار من اليسار إلى اليمين؛ ولا يضيف تهريب العرض محارف اتجاه إلى النص المنسوخ، وليس ترميزاً للإدخال. ينتج عن مجلد حالي غير متاح خطأ. استعد باستخدام انتقل بمسار مطلق أو منزل صالح. تُرفض المعاملات الزائدة، بما فيها --.

مسار

mkdir / أنشئ

الصيغة: mkdir [-p] [--] DIR أو أنشئ [-p] [--] DIR.

ينشئ مجلداً حقيقياً بصلاحيات حسابك وumask. يفشل mkdir العادي على مسار موجود أو عند فقدان المجلد الأب. ينشئ -p الآباء المفقودين ويقبل مجلداً موجوداً أو رابطاً إليه. يحافظ الشكلان على التنقل الفيزيائي عبر الروابط والآباء، وينجحان بصمت دون تغيير المجلد الحالي. تُرفض المعاملات المفقودة والخيارات غير المعروفة أو المكررة والمعاملات الزائدة.

تحدد الأخطاء الأمر والمعامل المهرّب والسبب الفعلي من نظام التشغيل. يذكر تقرير المساعد المكتمل عدد المجلدات المنشأة قبل الفشل وأنها قد تبقى. إذا منع الإلغاء أو موت المساعد تقريراً مكتملاً، تبلغ اللوحة عن مجلدات قد تبقى وآثار غير مؤكدة. لا تتراجع عن الإنشاء ولا تعيد المحاولة تلقائياً. تنطبق قواعد الإلغاء المشتركة.

mkdir "My projects"
أنشئ -p -- "My projects/demo/data"

cat / اقرأ

الصيغة: cat [--] FILE أو اقرأ [--] FILE.

يقرأ ملفاً عادياً واحداً كاملاً بترميز UTF-8 دون NUL، ويسمح بالروابط الرمزية إلى ملفات عادية قابلة للقراءة. تُرفض المجلدات والأجهزة وFIFO والمقابس والأهداف الخاصة الأخرى قبل قراءة المحتوى. لكل من حجم الملف وبيانات UTF-8 المعروضة حد 1,048,576 بايت؛ وينجح بلوغ أي حد تماماً. ينتج عن UTF-8 غير صالح أو NUL أو أخطاء الملفات أو الحجم الزائد خطأ بالأمر والمسار المهرّب والسبب، دون بيانات سابقة من الملف. تُرفض المعاملات المفقودة والخيارات غير المعروفة والمعاملات الزائدة.

يحافظ النص على LF وعلامات التبويب، ويعامل CRLF كفاصل واحد، ويهرّب CR المنفرد ومحارف التحكم الأخرى ومحارف تنسيق الاتجاه الثنائي. لا تنفذ تسلسلات ANSI أو محتويات الملفات أوامر. لا تضيف اللوحة سطراً جديداً أخيراً؛ ولا يضيف الملف الفارغ بيانات. تدخل النتيجة الكاملة سجل العرض المنطقي المحتفظ به، مع حذف الأقدم عند الحاجة. تنطبق قواعد الإلغاء المشتركة.

اقرأ -- "My projects/hello.aspl"
cat -- -notes.txt

run / تشغيل

الصيغة: run [--] FILE أو تشغيل [--] FILE.

يشغّل مصدراً صريحاً واحداً عبر ملف لبات التنفيذي المختار. يلتقط كل تشغيل مجلداً حالياً صالحاً للوحة، حتى عند استخدام مصدر مطلق. يتطلب فحص المصدر هدفاً عادياً قابلاً للقراءة ويسمح بالروابط. لا تقرأ اللوحة المصدر أو تخزنه ولا ترشح امتداده؛ تحدد أداة لبات المختارة الامتدادات المدعومة. يفشل المصدر المفقود أو غير المقروء والمجلد أو الملف التنفيذي غير الصالح والمعاملات المفقودة والخيارات غير المعروفة والمعاملات الزائدة دون بدء برنامج. لا يُصفّ تشغيل آخر أثناء وجود تشغيل نشط.

تمرر اللوحة معاملات حرفية مكافئة لـ --diagnostic-language=ar|en --color=never run -- ABSOLUTE_SOURCE، مع قنوات stdin/stdout/stderr أصلية منفصلة وبيئة موروثة ودون صدفة أو خيارات إضافية للمترجم أو البرنامج. تبقى لغة التشخيص ثابتة لذلك التشغيل. تتبع الاستيرادات المصدر الفيزيائي لدى الأداة المختارة؛ وتستخدم مسارات بيانات التشغيل وTLS مجلد اللوحة الملتقط.

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

احفظ أحد ملفي المصدر المورّدين ثم أدخل مساره في موجه الأوامر. تستخدم الأمثلة مفرداتها المسمّاة في أي لغة للصفحة، وتطلب سطراً واحداً قبل الترحيب به.

دالة ابدأ_الرئيسية() -> ص64 {
    اطبع("ما اسمك؟\س").
    دع اسم: نص = اقرأ_سطر().
    اطبع("مرحباً، " + اسم + "\س").
    أرجع 0.
}

fn start_main() -> i64 {
    print("Your name?\n");
    let name: string = read_line();
    print("Hello, " + name + "\n");
    return 0;
}

run -- hello-en.aspl
تشغيل -- hello-ar.aspl

هذان أمران بديلان، يبدأ كل منهما تشغيلاً واحداً. أدخل التالي فقط عندما يكون ذلك التشغيل جاهزاً للإدخال:

Samira

يرسل Enter نص UTF-8 ملتزماً مع LF، بحد 65,536 بايت للحمولة وسطر معلّق واحد. النص الفارغ والمسافات وNUL مدخلات حرفية؛ وتُرفض CR/LF والبايتات الزائدة دفعة واحدة. يبقى الموجه للقراءة فقط حتى تسليم السطر إلى القناة، وهو لا يثبت استهلاك البرنامج له. يُحتفظ بالتسليم المتوقف أو الفاشل بوصفه غير مؤكد ولا يُعاد إرساله.

أثناء التشغيل، تصبح حتى help أو exit أو run مدخلاً للبرنامج. يغلق Ctrl+D إدخال stdin بعد الإدخال المعلّق دون إرسال المسودة. تُحفظ المسودة غير الفارغة منفصلة. يطلب Ctrl+C أو زر الإيقاف إيقاف التشغيل، بإرسال SIGTERM ثم SIGKILL بعد 1,000 مللي ثانية. لا توجد مهلة للخروج أو إعادة محاولة تلقائية. يبقى الإدخال غير المرسل والتركيب غير المكتمل مع ذلك التشغيل ولا يدخلان موجه الأوامر التالي أو سجل الأوامر. تعلّم اللغة عبر دروس لبات؛ ليست لوحة الأوامر محرر مصدر أو REPL.

اقرأ الملفات والمسارات لمسار عمليات الملفات، وتشغيل البرامج والإدخال التفاعلي لتفاصيل EOF والإيقاف واستعادة التسليم.