تجربة - عبر الإنترنت في السحابة

برنامج:

اسم

تجريبي - تشغيل اختبارات الوحدة

موجز

محاكمة [ الخيارات ] [ ملف | صفقة | وحدة | حالة اختبار | طريقة اختبار ] ...

محاكمة --مساعدة | -h

الوصف

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

ستأخذ المحاكمة إما أسماء الملفات أو أسماء Python المؤهلة بالكامل كوسيطات. هكذا
"محاكمة myproject / foo.py" و "محاكمة myproject.foo" و "محاكمة
myproject.foo.SomeTestCase.test_method 'كلها طرق صالحة لاستدعاء التجربة. متعددة مثل
يتم قبول الوسائط أيضًا ، وسيحدد ترتيبها الترتيب الذي يتم به
يتم تشغيل الاختبارات المقابلة.

بعد تشغيل مجموعة الاختبار المحددة ، يقوم مراسل الاختبار الافتراضي بطباعة ملخص للاختبار
يجري. يتكون هذا من كلمة "PASSED" (إذا تم إجراء جميع الاختبارات كما هو متوقع) أو "FAILED" (إن وجدت
تصرف الاختبار بشكل غير متوقع) متبوعًا بإحصاء الأنواع المختلفة لنتائج الاختبار
مواجهة. تشمل الأنواع المحتملة لنتائج الاختبار ما يلي:

النجاحات
الاختبارات التي اجتازت جميع تأكيداتهم واستكملت دون أخطاء. هؤلاء هم
تم وضع علامة "PASSED" في إخراج الاختبار العادي.

الفشل
الاختبارات التي فشلت في تأكيد ما ، تسمى self.fail () أو مرفوعة بشكل صريح
استثناء self.failureException لسبب ما. تم وضع علامة "فشل" على هذه في الاختبار العادي
الناتج.

الأخطاء الاختبارات التي أثارت استثناء غير متوقع (بما في ذلك AssertionError) ، تختبر ذلك
تسبب أسلوب tearDown () في إثارة استثناء ، الاختبارات التي تعمل لمدة أطول من
الفاصل الزمني للمهلة ، الاختبارات التي تسببت في استدعاء شيء ما إلى twisted.python.log.err ()
دون استدعاء self.flushLoggedErrors () لاحقًا ، الاختبارات التي تغادر المفاعل
في حالة غير نظيفة ، وما إلى ذلك يتم وضع علامة "خطأ" عليها في إخراج الاختبار العادي.

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

يتخطى الاختبارات التي تم تخطيها ، عادةً بسبب فقدان التبعيات. تم وضع علامة على هذه
"تخطي" في إخراج الاختبار العادي.

المتوقع الفشل
الاختبارات التي فشلت ، ولكن كان من المتوقع أن تفشل ، عادةً لأن الاختبار مخصص لـ
الميزة التي لم يتم تنفيذها بعد. يتم وضع علامة "TODO" في الوضع الطبيعي
إخراج الاختبار.

نجاحات غير متوقعة
الاختبارات التي كان يجب إدراجها ضمن الإخفاقات المتوقعة ، باستثناء ذلك بالنسبة للبعض
سبب نجاح الاختبار. تم وضع علامة "نجاح!؟!" في إخراج الاختبار العادي.

OPTIONS

-j, --وظائف عدد
قم بتعيين عدد عمال العملية المراد تشغيلهم. إنه يتعارض مع التصحيح ، exitfirst
وخيارات الملف الشخصي.

-b, --Debug
قم بتشغيل الاختبارات في مصحح أخطاء. إذا كان مصحح الأخطاء هذا هو "pdb" (وهو الإعداد الافتراضي if
غير محدد) ، سيتم تحميل ".pdbrc" من الدليل الحالي إذا كان موجودًا.
يقوم أيضًا بتصحيح الأخطاء بعد الوفاة على الاستثناءات.

-B, --debug-stacktraces
الإبلاغ عن الإنشاء المؤجل وتتبع مكدس رد الاتصال.

--تغطية
قم بتوليد معلومات التغطية في الدليل الفرعي "التغطية" للدليل المؤقت للمحاكمة
الدليل (افتراضيًا "_trial_temp"). لكل وحدة Python تم لمسها بواسطة ملف
تنفيذ الاختبارات المحددة ، سيتم إنشاء ملف في دليل التغطية
تم تسميته بالاسم المؤهل بالكامل للوحدة مع اللاحقة ".cover". على سبيل المثال،
نظرًا لأن مشغل الاختبار التجريبي مكتوب بلغة Python ، فإن دليل التغطية سيفعل ذلك
غالبًا ما يحتوي على ملف باسم "twisted.trial.runner.cover".

يحتوي كل ملف ".cover" على نسخة من مصدر Python للوحدة المعنية ،
ببادئة في بداية كل سطر يحتوي على معلومات التغطية. ل
الأسطر غير القابلة للتنفيذ (الأسطر الفارغة والتعليقات وما إلى ذلك) البادئة فارغة.
بالنسبة للأسطر القابلة للتنفيذ التي تم تشغيلها في سياق مجموعة الاختبار ، فإن البادئة هي
رقم يشير إلى عدد المرات التي تم فيها تنفيذ هذا الخط. السلسلة ">>>>>>"
البادئات سطور قابلة للتنفيذ التي لم يتم تنفيذها في سياق مجموعة الاختبار.

لاحظ أن هذه الوظيفة تستخدم وظيفة Python sys.settrace () ، لذلك تختبر ذلك
من المحتمل أن يؤدي استدعاء sys.settrace () إلى تعطيل وظائف التغطية التجريبية.

- الشرير
تحديد مصحح الأخطاء الذي سيتم استخدامه عند تمرير الخيار --debug. الحجة
يجب أن يكون الاسم المؤهل بالكامل لكائن يقوم بتنفيذ نفس الواجهة
كملف pdb للمكتبة القياسية.

--تعطيل
قم بتعطيل أداة تجميع البيانات المهملة طوال مدة التشغيل التجريبي. كل اختبار
run ، try يحفظ كائنات TestResult ، مما يعني أن Python تافه
جامع لديه المزيد من الأشياء غير القمامة للخوض فيها ، مما يجعل كل قمامة-
جمع تشغيل أبطأ قليلا. سيؤدي تعطيل جمع القمامة تمامًا
تكتمل بعض مجموعات الاختبار بشكل أسرع (على النقيض --force-gc ، أدناه) بتكلفة
زيادة (ربما بشكل كبير) استهلاك الذاكرة. يقوم هذا الخيار أيضًا بإجراء الاختبارات
أكثر حتمية قليلاً ، مما قد يساعد في تصحيح الأخطاء في الظروف القصوى.

-e, - التائبون
طباعة tracebacks إلى الإخراج القياسي بمجرد حدوثها.

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

-h, --مساعدة
اطبع رسالة استخدام للمخرجات القياسية ، ثم اخرج.

- طلب المساعدة
اطبع قائمة بالطلبات المحتملة التي يمكن تشغيل طرق اختبار TestCase بها ، بعد ذلك
مخرج. يمكن استخدام الطلبات مع خيار - Order الموضح أدناه.

- مساعدة المراسلين
اطبع قائمة المراسلين الصالحين إلى الإخراج القياسي ، ثم اخرج. يمكن للصحفيين أن يكونوا
تم تحديده باستخدام الخيار --reporter الموضح أدناه.

- مفاعلات المساعدة
اطبع قائمة بالمفاعلات الممكنة للمخرجات القياسية ، ثم اخرج. ليست كلها مدرجة
المفاعلات متوفرة على كل منصة. يمكن اختيار المفاعلات باستخدام
- خيار المفاعل الموصوف أدناه.

-l, --ملف تسجيل ملف تسجيل
قم بتوجيه السجل إلى ملف مختلف. الملف الافتراضي هو "test.log". ملف تسجيل is
نسبة إلى _trial_temp.

-n, --ركض جاف
قم بإجراء جميع الاختبارات واجعلها تمر دون تشغيل.

-N, - لا تتكرر
بشكل افتراضي ، تتكرر التجربة من خلال الحزم للعثور على كل وحدة بداخلها
حزمة فرعية. ما لم تحدد هذا الخيار.

- نوبم لا تقفز تلقائيًا إلى مصحح الأخطاء لتحليل الاستثناءات بعد الوفاة.
يمكن استخدامه فقط مع --debug.

--ترتيب طلب
حدد الترتيب المطلوب تشغيل طرق الاختبار الفردية داخل حالات الاختبار المحددة.
بشكل افتراضي ، يتم تشغيلها أبجديًا. انظر - تعليمات الطلب للحصول على قائمة صالحة أخرى
القيم.

--الملف الشخصي
قم بتشغيل الاختبارات ضمن ملف تعريف Python.

-r, --مفاعل مفاعل
اختر أي مفاعل لاستخدامه. انظر - المفاعلات المساعدة للحصول على قائمة.

--recursionlimit قصر
تعيين حد العودية في بايثون. انظر sys.setrecursionlimit ().

--مراسل صحافي
حدد المراسل لاستخدامه في إخراج المحاكمة. استخدم الخيار --help -itors ل
انظر قائمة المراسلين الصالحين.

-x, - الخروج أولا
أوقف التشغيل التجريبي بعد الاختبار الأول الذي لم ينجح. هذا يتضمن
فشل أو أخطاء أو نجاحات غير متوقعة. لن تعمل مع خيار الوظائف
حاليا.

--تقيأ قم بطباعة سجل مطول بجنون لكل ما يحدث. مفيد عند التصحيح
يتجمد أو يقفل في كود معقد.

- تنسيق شكل
تنسيق لعرض عمليات التتبع مع. القيم المقبولة هي "الافتراضية" و "المختصرة" و
"مطوّل". تنتج كلمة "مختصرة" عمليات التتبع التي تعمل بشكل جيد مع Emacs 'GUD.

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

--testmodule اسم الملف
اطلب المحاكمة للنظر فيها اسم الملف وقم بإجراء أي اختبارات محددة باستخدام أسلوب Emacs
متغير المخزن المؤقت "اسم حالة الاختبار".

- تحذيرات غير منتظمة
اعتبارًا من Twisted 8.0 ، ستبلغ التجربة عن خطأ إذا تم ترك المفاعل غير نظيف في
نهاية الاختبار. يتم توفير هذا الخيار للمساعدة في الترحيل من Twisted 2.5 إلى
الملتوية 8.0 والإصدارات الأحدث. سيؤدي تمكين هذا الخيار إلى تحويل الأخطاء إلى تحذيرات.

-u, - حتى الفشل
استمر في تكرار الاختبارات حتى يثير أحدها خطأ أو فشلًا. هذا هو
مفيد بشكل خاص لإعادة إنتاج حالات الفشل المتقطع.

--الإصدار
يطبع رقم الإصدار الملتوي والخروج.

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

-z, --عشوائي بذرة
قم بإجراء الاختبارات بترتيب عشوائي باستخدام البذور المحددة. لا تمرر هذا الخيار إذا
أنت أيضا تمر - ترتيب.

استخدم الإصدار التجريبي عبر الإنترنت باستخدام خدمات onworks.net