CycleMantle
سير العمل

دليل عملي لإنشاء ملف بيانات الاختبار الأول

03
تجهيز البيانات في دقيقة

من مجلد فارغ إلى اختبار ناجح

لديك دالة PHP تنسق إجمالي الطلب، وتريد التحقق منها مع مدخلات متعددة. يعمل CycleMantle كمولّد للبيانات: يكتب ملف JSON يحتوي على طلبات مخترعة، ثم يكتب الاختبارات التي تقرأه. لا يتم نسخ أي بيانات من عملاء حقيقيين. مع نموذج سحابي، تذهب مطالبتك ونص الملف الذي يقرأه الوكيل إلى المزود؛ ومع نموذج محلي لا يغادر أي شيء جهاز الكمبيوتر الخاص بك. خطط لحوالي 4 رسائل دردشة قصيرة: افتح المجلد، اطلب السجلات، اطلب الاختبارات، وشغّلها. تنتج كل رسالة بطاقات يمكنك قراءتها أو قبولها أو رفضها قبل بدء الرسالة التالية. اقرأ البطاقات من الأعلى إلى الأسفل: يحدد كل منها الأداة، والملف أو الأمر المستخدم، والنتيجة التي حصل عليها. إذا كنت تفضل القراءة قبل أي تشغيل، ابدأ الدردشة في وضع Plan only وقم بالتبديل إلى Ask first بعد قراءة الخطة.

01

فتح مجلد المشروع

ابدأ التطبيق، واختر المجلد الذي يحتوي على كود PHP الخاص بك، واختر Ask first كوضع الموافقة، بحيث ينتظر كل تغيير موافقتك. يمكنك تغيير الوضع لاحقًا في أي وقت تريده، على سبيل المثال إلى Auto-run بمجرد أن تثق في الخطوات.

02

طلب سجلات وهمية

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

03

طلب الاختبارات

اطلب سكريبت اختبار صغير يقرأ ملف JSON ويقارن المدخلات المعروفة بالمخرجات المتوقعة. سمِّ الدالة التي يجب اختبارها. اطلب من الوكيل شرح كل اختبار في سطر واحد، حتى تعرف ما الذي يهدف إلى اكتشافه.

04

المراجعة والتشغيل

راجع التغييرات (diff)، وافق عليها، ودع Shell يشغل أمر الاختبار الخاص بك. ثم راجع رمز الخروج (exit code) وقم بتوسيع البطاقة لرؤية المخرجات. إذا فشل اختبار، اطلب من الوكيل شرح سبب الفشل قبل أن يعدل أي شيء.

سكريبت اختبار صغير للبدء منه

tests.php
<?php
function discount(int $cents, int $percent): int {
    return intdiv($cents * (100 - $percent), 100);
}
assert(discount(1000, 0) === 1000);
assert(discount(1000, 10) === 900);
assert(discount(0, 50) === 0);
assert(discount(999, 100) === 0);
echo 'All checks ran';

دالة بسيطة وأربعة اختبارات تأكيد (assert) بمدخلات ونتائج معروفة. لا يستخدم قاعدة بيانات، ولا شبكة، ولا أسرارًا. لاحقًا يمكن للوكيل استبدال الأرقام الثابتة بصفوف من ملف JSON الخاص بك، وستظل الاختبارات بنفس الهيكل. غيّر قيمة متوقعة عن عمد لترى فشلًا. احفظه باسم tests.php في مجلد مشروعك، وشغّله بأمر الاختبار الخاص بك، واقرأ رمز الخروج في البطاقة قبل أن تطلب أي شيء آخر. ثم غيّر قيمة متوقعة عن عمد وشاهد البطاقة تتحول إلى اللون الأحمر.

أربع مهام لأدوات توليد بيانات الاختبار

كتابة السجلات النموذجية

يتساءل الكثيرون عن كيفية توليد بيانات اختبار أسرع من الكتابة اليدوية. صف الشكل الذي تريده ودع الوكيل يكتبه: ملف JSON يحتوي على 3 عملاء وهميين، كل منهم يحتوي على اسم، وتاريخ تسجيل، ومبلغ طلب. من بين أدوات توليد بيانات الاختبار، يعد الملف العادي في مشروعك أسهل طريقة للقراءة وللتعديل لاحقًا، لأن الاختلاف (diff) يظهر كل قيمة. تظهر أدوات glob و list_dir أين توجد البيانات الثابتة بالفعل، بحيث يوضع الملف الجديد بجانب الآخرين. افتح البطاقة، تحقق من أن كل قيمة مخترعة بوضوح، وعدّل الصفوف غير المعتادة يدويًا قبل قبولها. استخدم نطاقات بريد إلكتروني محجوزة كمثال. اطلب عددًا قليلاً من الصفوف، وليس مئات، حتى تتمكن من قراءة كل منها. اكتب التواريخ بتنسيق ثابت واحد حتى تقرأ كل الصفوف بنفس الطريقة.

كتابة اختبارات تقرأ الملف

اطلب سكريبتًا يحمّل ملف JSON ويتحقق من نتيجة واحدة لكل صف. يفتح الوكيل الكود المصدري باستخدام read_file، ويعثر على الدالة باستخدام grep، ويقترح ملف الاختبار كاختلاف (diff). يعد محاكاة الطرق الثابتة (static methods) في php أمرًا محرجًا، لذا اطلب من الوكيل سرد المكالمات الثابتة قبل أن يكتب أي شيء، واحتفظ بهذه المكالمات خلف دالة صغيرة يمكن للاختبار استبدالها. يوقف Ask first التغيير حتى تقبله. اقرأ كل تأكيد واسأل عما إذا كان سيفشل إذا كانت الدالة خاطئة. ارفض أي اختبار يكرر فقط الكود الذي يختبره. ثم أضف صفًا واحدًا يجب أن يفشل عن عمد. إذا لم يتمكن الوكيل من معرفة الدالة التي تقصدها، سمّها في المطالبة واذكر الملف. احتفظ بمفهوم واحد لكل اختبار.

تشغيل الاختبارات وقراءة رمز الخروج

يشغل Shell أمر الاختبار الخاص بك في البيئة التي اخترتها، مثل Windows المحلي أو WSL أو SSH إلى خادم تملكه. تظهر البطاقة رمز الخروج الفعلي، ورمز الخروج بصفر يعني نجاح كل اختبار بينما يعني أي قيمة أخرى فشلًا. قم بتوسيع البطاقة لقراءة المخرجات سطرًا بسطر. إذا فشل شيء ما، يقرأ الوكيل الرسالة ويقترح إصلاحًا كاختلاف (diff). لا تقبل الإصلاح فقط لأنه يجعل التشغيل أخضر. تحقق من القيمة المتوقعة في الاختبار أولاً. إذا تبع فشل ثانٍ فشل أول، اطلب من الوكيل شرح الأول قبل أن يعدل مرة أخرى. يعد Plan only مرحلة أولى جيدة إذا كان الأمر جديدًا عليك، لأن الوكيل يكتب خطة ولا يشغل شيئًا.

تحديد الكود الذي يحتاج إلى اختبار

بعد نجاح الاختبارات، شغل أمر التغطية (coverage) ودع الوكيل يقرأ التقرير. تجادل الفرق حول ما إذا كان يجب تضمين كود البنية التحتية في تغطية الكود، والإجابة المعقولة هي الاتفاق على ذلك قبل أن يصبح الرقم هدفًا. تطلب بعض الفرق أيضًا تغطية اختبارات إلزامية للطرق الحرجة، مثل فحوصات السعر أو الأذونات. اطلب من الوكيل سرد هذه الطرق باستخدام grep واقتراح اختبارات للطريقة الأولى. راجع الاختلاف (diff)، وشغل الاختبارات مرة أخرى، وتوقف عندما تكون المسارات الحرجة مغطاة. اكتب المجلدات التي احتسبتها، حتى يكون الرقم في الشهر القادم يعني نفس الشيء. اطلب من الوكيل وضع قائمة المجلدات المحسوبة في ملف نصي عادي في مشروعك، واقرأ الاختلاف (diff) قبل قبوله.

CycleMantle لنظام Windows

أنشئ ملف بيانات الاختبار الأول الخاص بك اليوم

تحميل CycleMantle ↗