هذا هو الأمر lit-3.7 الذي يمكن تشغيله في مزود الاستضافة المجانية OnWorks باستخدام إحدى محطات العمل المجانية المتعددة على الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
مضاءة - جهاز اختبار متكامل LLVM
موجز
قاع [الخيارات] [اختبارات]
الوصف
قاع هي أداة محمولة لتنفيذ مجموعات اختبار نمط LLVM و Clang ، وتلخيص ملفات
النتائج ، وتقديم إشارة إلى حالات الفشل. قاع تم تصميمه ليكون خفيف الوزن
أداة اختبار بواجهة مستخدم بسيطة قدر الإمكان.
قاع يجب تشغيله بواحد أو أكثر اختبارات للتشغيل المحدد في سطر الأوامر. يمكن الاختبارات
تكون إما ملفات اختبار فردية أو أدلة للبحث عن الاختبارات (انظر الاختبار DISCOVERY).
سيتم تنفيذ كل اختبار محدد (من المحتمل أن يكون على التوازي) وبمجرد الانتهاء من جميع الاختبارات
تم تشغيله قاع سيطبع معلومات موجزة عن عدد الاختبارات التي نجحت أو فشلت
(انظر الاختبار الوضع النتائج). ال قاع سيتم تنفيذ البرنامج برمز إنهاء غير صفري إن وجد
الاختبارات تفشل.
افتراضيا قاع سيستخدم عرض تقدم موجز وسيطبع الملخص فقط
معلومات عن فشل الاختبار. يرى OUTPUT OPTIONS للحصول على خيارات التحكم في قاع
عرض التقدم والإخراج.
قاع يتضمن أيضًا عددًا من الخيارات للتحكم في كيفية تنفيذ الاختبارات (محددة
قد تعتمد الميزات على تنسيق الاختبار المعين). يرى إعدام OPTIONS لمزيد من
معلومات.
وأخيرا، قاع يدعم أيضًا خيارات إضافية لتشغيل مجموعة فرعية فقط من الخيارات
المحدد في سطر الأوامر ، انظر اختيار OPTIONS للمزيد من المعلومات.
المستخدمون المهتمون بـ قاع العمارة أو تصميم أ قاع يجب تنفيذ الاختبار
انظر تعريف أشعل البنية التحتية.
يمكنك تحويل أي لحظة سعيدة إلى ذكرى ثمينة وخالدة – احتفظ بها على شكل صورة أو مقطع فيديو باستخدام الكاميرا الخلفية المضمنة. ومن خلال اتصال Bluetooth، يمكنك مشاركة الملفات ذات المحتوى العزيز على قلبك مع أجهزة المقربين منك. OPTIONS
-ح ، --مساعدة
اظهار قاع رسالة المساعدة.
-j N, - الخيوط = N
يجري N الاختبارات بالتوازي. بشكل افتراضي ، يتم اختيار هذا تلقائيًا لمطابقة ملف
عدد وحدات المعالجة المركزية المتاحة المكتشفة.
--config-prefix = NAME
البحث عن اسم.cfg و اسم.site.cfg متى البحث For تجربه بالعربي أجنحة بدلًا من ذلك of
مضاءة و مضاءة .site.cfg.
-D اسم، -D NAME = VALUE ، - معلمة اسم، - معلمة الاسم = القيمة
أضف معلمة يحددها المستخدم اسم مع المعطى VALUE (أو السلسلة الفارغة إذا لم تكن كذلك
منح). يعتمد معنى واستخدام هذه المعلمات على مجموعة الاختبار.
OUTPUT OPTIONS
-q ، --هادئ
قم بإيقاف أي إخراج باستثناء حالات فشل الاختبار.
-س، --الإيجاز
أظهر مخرجات أقل ، على سبيل المثال لا تعرض معلومات عن الاختبارات التي نجحت.
-الخامس، - الإسراف
اعرض مزيدًا من المعلومات حول إخفاقات الاختبار ، على سبيل المثال ناتج الاختبار بالكامل بدلاً من ذلك
من مجرد نتيجة الاختبار.
--لا شريط التقدم
لا تستخدم شريط التقدم القائم على الشتائم.
- عرض غير مدعوم
اعرض أسماء الاختبارات غير المدعومة.
--إظهار xfail
اعرض أسماء الاختبارات التي كان من المتوقع أن تفشل.
إعدام OPTIONS
- المسار = المسار
حدد ملفًا إضافيًا PATH لاستخدامها عند البحث عن الملفات التنفيذية في الاختبارات.
--vg قم بتشغيل الاختبارات الفردية باستخدام valgrind (باستخدام أداة memcheck). ال
--رمز خروج الخطأ يتم استخدام حجة valgrind بحيث يتسبب فشل valgrind في حدوث ذلك
البرنامج للخروج بحالة غير صفرية.
عندما يتم تمكين هذا الخيار ، قاع سيوفر أيضًا تلقائيًا "فالغريند"
الميزة التي يمكن استخدامها للتعطيل المشروط (أو توقع الفشل في) بعض
الاختبارات.
--vg-arg = ARG
متى --vg مستخدم ، حدد وسيطة إضافية لتمريرها فالغريند نفسها.
--vg- تسرب
متى --vg ، قم بتمكين عمليات فحص تسرب الذاكرة. عندما يتم تمكين هذا الخيار ، قاع
سيوفر أيضًا تلقائيًا "vg_leak"الميزة التي يمكن استخدامها
تعطيل (أو توقع الفشل في) بعض الاختبارات بشكل مشروط.
- اختبارات الوقت
تتبع الوقت الذي تستغرقه الاختبارات الفردية للتنفيذ ويتضمن النتائج
إخراج الملخص. هذا مفيد لتحديد الاختبارات في مجموعة الاختبار
يستغرق معظم الوقت للتنفيذ. لاحظ أن هذا الخيار يكون مفيدًا للغاية مع -j 1.
اختيار OPTIONS
--الاختبارات القصوى = N
تشغيل على الأكثر N الاختبارات ثم إنهاء.
- أقصى وقت = N
أنفق على الأكثر N ثوانٍ (تقريبًا) قيد الاختبارات ثم تنتهي.
--خلط
قم بإجراء الاختبارات بترتيب عشوائي.
ADDITIONAL OPTIONS
--Debug
يجري قاع في وضع التصحيح لتصحيح أخطاء التكوين و قاع نفسها.
- أجنحة العرض
قائمة مجموعات الاختبار المكتشفة والخروج.
- عرض الاختبارات
ضع قائمة بجميع الاختبارات المكتشفة واخرج.
EXIT الوضع
قاع سيتم الخروج برمز الخروج 1 إذا كانت هناك أي نتائج FAIL أو XPASS. خلاف ذلك،
سيتم الخروج بالحالة 0. يتم استخدام رموز الخروج الأخرى للإخفاقات غير المتعلقة بالاختبار
(على سبيل المثال خطأ مستخدم أو خطأ داخلي في البرنامج).
الاختبار DISCOVERY
تم تمرير المدخلات إلى قاع يمكن أن تكون إما اختبارات فردية أو أدلة كاملة أو
التسلسلات الهرمية للاختبارات للتشغيل. متى قاع يبدأ ، أول شيء يفعله هو تحويل ملف
المدخلات في قائمة كاملة من الاختبارات للتشغيل كجزء منها تجربه بالعربي اكتشاف.
في مجلة قاع نموذج ، يجب أن يوجد كل اختبار داخل البعض تجربه بالعربي جناح. قاع يحل المدخلات
المحدد في سطر الأوامر لاختبار المجموعات من خلال البحث لأعلى من مسار الإدخال
حتى يجد ملف مضاءة or مضاءة .site.cfg ملف. تعمل هذه الملفات كعلامة اختبار
الأجنحة وملفات التكوين التي قاع الأحمال من أجل فهم كيفية العثور على و
قم بإجراء الاختبارات داخل مجموعة الاختبار.
مرة قاع قام بتعيين المدخلات في مجموعات الاختبار التي تجتاز قائمة المدخلات المضافة
اختبارات للملفات الفردية والبحث بشكل متكرر عن الاختبارات في الدلائل.
يسهّل هذا السلوك تحديد مجموعة فرعية من الاختبارات للتشغيل ، مع استمرار السماح بامتداد
اختبار مجموعة التكوين للتحكم بالضبط في كيفية تفسير الاختبارات. فضلاً عن ذلك، قاع
يحدد دائمًا الاختبارات من خلال مجموعة الاختبار التي يتواجدون فيها ، والمسار النسبي داخل
حزمة اختبار. بالنسبة للمشاريع التي تم تكوينها بشكل مناسب ، فهذا يسمح قاع لتوفير الراحة
ودعم مرن للتركيبات خارج الشجرة.
الاختبار الوضع النتائج
ينتج عن كل اختبار في النهاية إحدى النتائج الست التالية:
مرر
نجح الاختبار.
XFAIL
فشل الاختبار ، لكن هذا متوقع. يستخدم هذا لأشكال الاختبار التي تسمح
تحديد أن الاختبار لا يعمل حاليًا ، ولكنك ترغب في تركه في مجموعة الاختبار.
XPASS
نجح الاختبار ، لكن كان من المتوقع أن يفشل. يستخدم هذا للاختبارات التي كانت
المحدد كما هو متوقع أن يفشل ، لكنه ينجح الآن (بشكل عام لأن الميزة
تم كسر الاختبار وتم إصلاحه).
يفشلون
فشل الاختبار.
لم تحل
لا يمكن تحديد نتيجة الاختبار. على سبيل المثال ، يحدث هذا عندما يكون الاختبار ممكنًا
لا يتم تشغيله أو الاختبار نفسه غير صالح أو تمت مقاطعة الاختبار.
غير معتمد
الاختبار غير مدعوم في هذه البيئة. يتم استخدام هذا من خلال صيغ الاختبار التي يمكن
الإبلاغ عن الاختبارات غير المدعومة.
اعتمادًا على تنسيق الاختبار ، قد تنتج الاختبارات معلومات إضافية حول حالتها
(بشكل عام للفشل فقط). انظر OUTPUT OPTIONS قسم لمزيد من المعلومات.
أشعل البنية التحتية
يصف هذا القسم قاع اختبار البنية للمستخدمين المهتمين بإنشاء ملف
قاع اختبار التنفيذ ، أو تمديد تطبيق موجود.
قاع السليم هو في الأساس بنية تحتية لاكتشاف وتشغيل الاختبارات التعسفية ، و
لعرض واجهة واحدة ملائمة لهذه الاختبارات. قاع نفسها لا تعرف كيف تجري
الاختبارات ، بل يتم تعريف هذا المنطق بواسطة تجربه بالعربي الأجنحة.
الاختبار SUITES
كما هو موضح في الاختبار DISCOVERY، الاختبارات موجودة دائمًا داخل أ تجربه بالعربي جناح. أجنحة الاختبار
تعمل على تحديد شكل الاختبارات التي تحتويها ، ومنطق البحث عن تلك الاختبارات ،
وأي معلومات إضافية لإجراء الاختبارات.
قاع يحدد مجموعات الاختبار كأدلة تحتوي على مضاءة or مضاءة .site.cfg الملفات (انظر
أيضا --config-prefix). تم اكتشاف مجموعات الاختبار في البداية من خلال البحث المتكرر
التسلسل الهرمي للدليل لجميع ملفات الإدخال التي تم تمريرها في سطر الأوامر. يمكنك استخدام
- أجنحة العرض لعرض مجموعات الاختبار المكتشفة عند بدء التشغيل.
بمجرد اكتشاف مجموعة اختبار ، يتم تحميل ملف التكوين الخاص بها. ملفات التكوين نفسها
وحدات بايثون التي سيتم تنفيذها. عند تنفيذ ملف التكوين ، هناك عنصران مهمان
المتغيرات العالمية محددة مسبقًا:
Lit_config
العالمي قاع كائن التكوين (أ التكوين المضاء مثال) ، الذي يعرّف المضمّن
تنسيقات الاختبار ومعلمات التكوين العامة وإجراءات المساعدة الأخرى لـ
تنفيذ تكوينات الاختبار.
التكوين
هذا هو كائن التكوين (a الاختبار على سبيل المثال) لمجموعة الاختبار ، والتي يكون ملف
من المتوقع أن يتم ملء ملف التكوين. المتغيرات التالية متوفرة أيضًا على
التكوين الكائن ، بعضها يجب تعيينه بواسطة التكوين والبعض الآخر اختياري أو
محدد مسبقا:
الاسم [مطلوب] اسم مجموعة الاختبار لاستخدامها في التقارير والتشخيصات.
test_format [مطلوب] كائن تنسيق الاختبار الذي سيتم استخدامه للاكتشاف والتشغيل
الاختبارات في مجموعة الاختبار. بشكل عام ، سيكون هذا تنسيق اختبار مدمج متاحًا من
ال مضاءة تنسيقات وحدة.
test_source_root مسار نظام الملفات إلى جذر مجموعة الاختبار. للبناء خارج دير
هذا هو الدليل الذي سيتم فحصه للاختبارات.
test_exec_root بالنسبة للبنيات خارج الدليل ، المسار إلى جذر مجموعة الاختبار داخل الكائن
الدليل. هذا هو المكان الذي سيتم فيه تشغيل الاختبارات ووضع ملفات الإخراج المؤقتة.
بيئة قاموس يمثل البيئة التي سيتم استخدامها عند تنفيذ الاختبارات في
الجناح.
لواحق في حالة قاع اختبار الصيغ التي تفحص الدلائل للاختبارات ، هذا المتغير عبارة عن قائمة
من اللواحق لتحديد ملفات الاختبار. استعمل من قبل: شتيست.
بدائل في حالة قاع اختبار التنسيقات التي تحل محل المتغيرات في نص اختبار ، و
قائمة البدائل لأداء. استعمل من قبل: شتيست.
غير معتمد ضع علامة على دليل غير مدعوم ، سيتم الإبلاغ عن جميع الاختبارات بداخله على أنها
غير مدعوم. استعمل من قبل: شتيست.
أصل التكوين الرئيسي ، هذا هو كائن التكوين للدليل الذي يحتوي على
مجموعة الاختبار ، أو لا شيء.
جذر تكوين الجذر. هذا هو الأعلى قاع التكوين في المشروع.
الأنابيب عادةً ما يفشل الاختبار باستخدام أنبوب الغلاف إذا كان أي من الأوامر على الأنبوب
يفشل. إذا لم يكن ذلك مرغوبًا فيه ، فإن تعيين هذا المتغير على خطأ يجعل الاختبار يفشل فقط
إذا فشل الأمر الأخير في الأنبوب.
الاختبار DISCOVERY
بمجرد تحديد موقع مجموعات الاختبار ، قاع يعبر بشكل متكرر دليل المصدر (التالي
test_source_root) البحث عن الاختبارات. متى قاع يدخل إلى دليل فرعي ، ويتحقق أولاً من
معرفة ما إذا تم تعريف مجموعة اختبار متداخلة في هذا الدليل. إذا كان الأمر كذلك ، فإنه يقوم بتحميل مجموعة الاختبار هذه
بشكل متكرر ، وإلا فإنه يقوم بإنشاء مثيل اختبار محلي للدليل (انظر LOCAL
CONFIGURATION FILES).
يتم تحديد الاختبارات من خلال مجموعة الاختبار المضمنة فيها والمسار النسبي
داخل هذا الجناح. لاحظ أن المسار النسبي قد لا يشير إلى ملف فعلي على القرص؛
بعض تنسيقات الاختبار (مثل اختبار جوجل) تحديد "الاختبارات الافتراضية" التي لها مسار
يحتوي على كل من المسار إلى ملف الاختبار الفعلي والمسار الفرعي لتحديد الاختبار الظاهري.
LOCAL CONFIGURATION FILES
متى قاع يقوم بتحميل دليل فرعي في مجموعة اختبار ، فإنه ينشئ تكوين اختبار محلي
عن طريق استنساخ التكوين للدليل الأصل --- جذر هذا التكوين
ستكون السلسلة دائمًا مجموعة اختبار. بمجرد استنساخ تكوين الاختبار قاع يتحقق من أ
مضاءة محلي ملف في الدليل الفرعي. إذا كان موجودًا ، فسيتم تحميل هذا الملف ويمكن تحميله
تستخدم لتخصص التكوين لكل دليل فردي. يمكن أن يكون هذا المرفق
تستخدم لتحديد الدلائل الفرعية للاختبارات الاختيارية ، أو لتغيير التكوين الآخر
المعلمات - على سبيل المثال ، لتغيير تنسيق الاختبار ، أو اللواحق التي تحدد الاختبار
الملفات.
الاختبار RUN OUTPUT FORMAT
• قاع يتوافق الإخراج للتشغيل التجريبي مع المخطط التالي ، باختصار ومطوَّل
الأوضاع (على الرغم من عدم ظهور خطوط PASS في الوضع القصير). تم اختيار هذا المخطط
لتكون سهلة نسبيًا لتحليلها بشكل موثوق بواسطة آلة (على سبيل المثال في سجل buildbot
كشط) ، ولأدوات أخرى لتوليدها.
من المتوقع أن تظهر كل نتيجة اختبار على سطر يطابق:
: ( )
أين هي نتيجة اختبار قياسية مثل PASS ، FAIL ، XFAIL ، XPASS ،
لم يتم حله ، أو غير مقبول. رموز نتائج الأداء الخاصة بـ "محسَّن" و "مُسجَّل" هي
يسمح أيضا.
• <test الاسم> يمكن أن يتكون الحقل من سلسلة عشوائية لا تحتوي على سطر جديد.
• <التقدم معلومات> يمكن استخدام الحقل للإبلاغ عن معلومات التقدم مثل (1/300) أو
يمكن أن تكون فارغة ، ولكن حتى عندما تكون فارغة ، فإن الأقواس مطلوبة.
قد تتضمن كل نتيجة اختبار معلومات سجل إضافية (متعددة الأسطر) في ما يلي
شكل:
امتحان '( ) "
... رسالة السجل ...
أين <test الاسم> يجب أن يكون اسم اختبار تم الإبلاغ عنه مسبقًا ، <log محدد> هو
سلسلة من الأحرف "*" at الأقل أربعة أحرف (الطول الموصى به هو 20) ، و
<زائدة محدد> عبارة عن سلسلة عشوائية (لم يتم تحليلها).
فيما يلي مثال على إخراج تشغيل اختباري يتكون من أربعة اختبارات A و B و C و
D ، ورسالة سجل للاختبار الفاشل C:
التمرير: أ (1 من 4)
النجاح: ب (2 من 4)
فشل: ج (3 من 4)
********************* فشل اختبار "C" **********************
فشل اختبار "C" كنتيجة لكود الخروج 1.
********************
التمرير: D (4 من 4)
أشعل مثال اختبارات
• قاع يحتوي التوزيع على العديد من أمثلة تطبيقات مجموعات الاختبار في
مثالالاختبارات الدليل.
استخدم Lit-3.7 عبر الإنترنت باستخدام خدمات onworks.net
