تشغيل الاختبارات
تشغِل Shell أمر الاختبار، وتعرض البطاقة رمز الخروج الفعلي والمخرجات الكاملة.
واجهة API الوهمية هي بديل للخدمة الحقيقية: تُرجع إجابات ثابتة من ملف، لذا تتصرف اختباراتك بنفس الطريقة في كل مرة. تكتب CycleMantle هذا الملف، وتُنشئ سجلات تجريبية، وتشغِل أمر الاختبار من الدردشة بينما تراقب كل خطوة. أنت تقرر أي المقترحات تصل إلى مشروعك.
تشغِل Shell أمر الاختبار، وتعرض البطاقة رمز الخروج الفعلي والمخرجات الكاملة.
تقترح write_file و edit_file اختباراتًا وبيانات اختبار كاختلاف (diff) يمكنك قبوله أو رفضه.
تفتح read_file و grep التقارير والسجلات حتى يتمكن الوكيل من تحديد الأسطر التي لم تُختبر بعد.
تصف المهمة في الدردشة. يقرأ الوكيل الكود الخاص بك، ويشغِل الأوامر ويعرض كل نتيجة كبطاقة، ثم ينتظر قرارك قبل أي تغيير في Ask first. يأتي Plan only أولاً عندما تريد قراءة الخطوات قبل تنفيذ أي منها. تبقى كل بطاقة في الدردشة، لذا يمكنك التمرير للخلف ورؤية ما تم تشغيله.
src/RateClient.phpتم التحميلtests/fixtures/rates.jsonتم الحفظtests/RateClientTest.phpتم الحفظyour test commandexit 0rates.json2 تطابقtests/RateClientTest.phpتم عرض الاختلافتطلب فئتك من خدمة أسعار الصرف رقمًا، ولا يجب أن يعتمد الاختبار على خادم حي. اطلب من الوكيل واجهة API وهمية: يقرأ read_file فئة العميل، ويحفظ write_file في tests/fixtures/rates.json مع ردود ثابتة، ويغير edit_file الاختبار ليقرأ هذا الملف بدلاً من الاتصال الخارجي. يجعل استدعاء الوظائف الحقيقية في إعداد اختبار الوحدة الاختبار معتمدًا على كود لم تقصد فحصه، لذا اجعل البيانات الاختبارية صغيرة وسمّها باسم الاستدعاء الذي تحل محله. يُظهر Ask first الاختلاف قبل حفظ أي شيء. اقبله، ودع Shell يشغِل أمر الاختبار، واقرأ رمز الخروج. ثم وسّع البطاقة لتؤكد أن الردود في المخرجات هي تلك المصنعة. إذا أظهرت المخرجات عنوان خادم حقيقي، أوقف العملية وأصلح الاختبار.
لفئة تقرير قد تحتاج إلى 3 مستخدمين بأسماء وتواريخ ومبالغ. يعني توليد بيانات الاختبار هنا أن يكتب الوكيل ملف JSON لأشخاص مخترعين؛ ولا ينسخ أبدًا صفوفًا من قائمة عملاء حقيقية. من بين الأدوات التي يستخدمها الممتحنون لتوليد بيانات الاختبار، فإن الملف العادي الذي يكتبه الوكيل سهل المراجعة في الاختلاف وسهل التغيير لاحقًا. استخدم glob للعثور على البيانات الاختبارية الموجودة أولاً، حتى لا يتعارض الملف الجديد مع اسم مستخدم بالفعل. افتح الملف في الدردشة، أصلح أي قيمة غريبة يدويًا، أضف صفًا واحدًا باسم فارغ لتغطية حالة حافة، وشغِل الاختبارات مرة أخرى. حافظ على الأسماء واضحة كمفبركة. احجز الملف مع الكود الخاص بك، حتى يشارك الزملاء نفس الصفوف.
شغِل أمر التغطية عبر Shell، ثم اطلب من الوكيل قراءة التقرير بـ read_file. يحدد الوظائف التي لم تُنفذ أسطرها ويقترح اختباراتًا لها كاختلاف. غالبًا ما يسأل الناس عما يجب اختباره في اختبار الوحدة، ويبدأ الجواب ببساطة: مدخل عادي واحد، وحالة حافة مثل قائمة فارغة، وقيمة غير صالحة. اقبل الاختبارات واحدة تلو الأخرى بدلاً من الكل معًا، حتى تلاحظ الضعيف منها. لا يثبت الرقم الأعلى أن الكود صحيح. كن متشككًا. اقرأ كل تأكيد بنفسك، واسأل عما إذا كان سيفشل إذا كانت الوظيفة خاطئة. بعد آخر اختبار مقبول، شغِل الأمر مرة أخيرة. كرر حتى يكون للأهم من الملفات اختبارات تثق بها.
عند فشل اختبار، تعرض البطاقة المخرجات الفعلية لأمر الاختبار الخاص بك. اطلب من الوكيل قراءة الاختبار والفئة التي يتم اختبارها بـ read_file، ثم يشرح التباين. يمكنه استخدام grep للعثور على مكان بناء قيمة واقتراح إصلاح كاختلاف. يسأل الناس لماذا يسبب المحاكاة مشاكل، وإجابة واحدة هي أن الرد الوهمي قد يبتعد عن الخدمة الحقيقية. قارن البيانات الاختبارية مع الخدمة التي تملكها، اقبل الاختلاف فقط إذا كان متطابقًا، وشغِل الأمر مرة أخرى. إذا فشل نفس الاختبار مرتين، انتقل إلى Plan only واطلب شرحًا قبل أي تعديل آخر. احتفظ بالمخرجات الفاشلة حتى يتم قبول الإصلاح.
CycleMantle ليست خدمة مستضافة أو ملحقًا. هي مخصصة فقط لملفاتك الخاصة، جهاز الكمبيوتر الخاص بك والخوادم التي يُسمح لك باستخدامها، وأنت تقرر أي المجلدات والأوامر والخوادم يمكن للوكيل لمسها، لأن Shell والويب و SSH غير مقصورين على مجلد العمل. نجاح الاختبارات لا يضمن صحة الكود.