CycleMantle
الموقع الرسمي لـ CycleMantle

unit testing: قراءة الكود وتشغيل الاختبارات

CycleMantle 2.9.30 هو وكيل يعمل على Windows 10/11، يقرأ كود PHP الخاص بك، يشغل أمر الاختبار ويعرض كل النتائج في الدردشة، لتقرر أي الاختبارات الجديدة تريد الاحتفاظ بها.

الإصدار

2.9.30

تم الإصدار في 8 نوفمبر 2026

التحميل

34 ميجابايت

برنامج التثبيت لنظام Windows

المنصة

Windows 10/11

تطبيق سطح مكتب 64 بت

اللغات

13

لغات واجهة التطبيق

الحساب

لا يوجد

لا حاجة لتسجيل الدخول للتشغيل

الأوضاع

3

Auto-run, Ask first, Plan only

لماذا يساعد

unit testing لـ PHP بدون الأعمال الروتينية

unit testing يعني التحقق من قطعة صغيرة من الكود، مثل دالة، مقابل مدخل معروف ونتيجة متوقعة. تبدأ معظم المشاريع بقوة. ثم تتراكم الزوايا غير المختبرة، ويستغرق كتابة الاختبارات المفقودة يدوياً صبراً أكثر مما يمتلكه الناس. يقرأ CycleMantle ملفات PHP الخاصة بك، يهيئ الاختبارات كاختلافات ويشغل أمر الاختبار الخاص بك في أحد أوضاع الموافقة الثلاثة.

01

كتابة اختبارات لفئة PHP واحدة

تفتح مجلد المشروع وتطلب اختبارات لفئة باسم Cart. يستخدم الوكيل read_file لتحميل المصدر، وgrep للعثور على الدوال العامة، وwrite_file لحفظ tests/CartTest.php. يوقف Ask first العملية هناك. تقرأ الاختلاف، تقبله، وتشغل Shell أمر الاختبار الخاص بك. إذا كان الاختبار يجب أن يتوقع استثناءً، اطلب رسالة تأكيد للاستثناءات، حتى يقول التشغيل الفاشل أي خطأ كان متوقعاً. ارفض أي اختبار لا تفهمه. النتيجة تبقى ملفاً واحداً في مجلدك.

تتبع الأداة
read_file  src/Cart.php  → loaded
grep  function total  → 1 match
write_file  tests/CartTest.php  → saved
Shell  your test command  → exit 0
02

العثور على الأسطر التي لم يشغلها اختبار

يشغل Shell أمر التغطية الخاص بك، الذي يكتب تقريراً في مجلد واحد، ويفتح read_file هذا التقرير حتى يتمكن الوكيل من سرد الدوال التي لم تشغل أسطرها أبداً. ثم يقترح اختباراً لكل منها كاختلاف، مكتوب بـ write_file. الفرق التي تتبع مقاييس تغطية الاختبار الآلي غالباً ما تطارد رقماً كبيراً واحداً. الأرقام قد تضلل. التقرير يقول فقط أي الأسطر شُغلت، لذا تعامل مع الرقم كقائمة مهام، اقبل اختباراً، شغل الأمر مرة أخرى، واقرأ التقرير الجديد قبل الانتقال.

تتبع الأداة
Shell  your coverage command  → report saved
read_file  coverage.txt  → loaded
write_file  tests/CartTest.php  → saved
03

تشغيل unit testing لـ PHP من الدردشة

يشغل Shell الأمر الذي تكتبه عادةً في cmd.exe أو PowerShell ويعيد رمز الخروج الحقيقي، حتى يظهر اختبار فاشل إخراجته في البطاقة الموسعة ويمكن لـ read_file فتح ملف الاختبار الذي يسميه. اقرأ الإخراج. ابدأ بوضع Plan only إذا كنت غير متأكد: يكتب الوكيل خطة ولا يشغل شيئاً حتى تغير الوضع. ثم اختر Ask first، وكل تغيير ينتظر موافقتك. شغل الأمر مرة أخرى بعد كل تعديل مقبول، تعديل واحد في كل مرة.

04

تحويل وصف API إلى ثوابت اختبار

لمحاكاة REST API من ملف OpenAPI، اطلب من الوكيل قراءة الملف بـ read_file وكتابة ملف JSON يحتوي على ردود ثابتة بـ write_file لاستدعاءات الكود الخاص بك. يقرأ الاختبار ذلك JSON بدلاً من الاتصال بخادم. اجعله محلياً. استخدم هذا فقط للخدمات التي تمتلكها أو تصفها في ملفاتك الخاصة، ثم افتح الثابت الجديد في الاختلاف، قارن ردًا واحداً بنص OpenAPI، وشغل اختباراتك مرة أخرى.

عرض جميع سير العمل

كيف يختلف عن مساعد الدردشة النموذجي

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

مساعد الدردشة النموذجيCycleMantle
تشغيل الاختباراتتنسخ الأمر وتشغله بنفسكيشغل Shell أمر الاختبار الخاص بك في الدردشة
النتيجةوصف لما يجب أن يحدثرمز الخروج الحقيقي والإخراج الكامل
الملفاتكود في رد تنسخه يدوياًملفات اختبار مكتوبة كاختلاف توافق عليه
الموافقةلا شيء للموافقة عليه أو رفضهيسأل Ask first قبل التغييرات؛ لا يشغل Plan only شيئاً

كيف تبدأ في أربع خطوات

  1. حمّل برنامج التثبيت، حوالي 34 ميجابايت، وثبته على Windows 10 أو 11 بعد مقارنة تجزئة SHA-256.
  2. صل نموذجاً: نقطة نهاية لمزود سحابي، نموذج على جهازك، أو النموذج المدمج.
  3. اختر مجلد مشروعك ووصف مهمة واحدة في الدردشة، على سبيل المثال اختبارات لفئة PHP واحدة.
  4. اقرأ البطاقات والاختلاف في Ask first، اقبل ما هو صحيح، ثم شغل أمر الاختبار الخاص بك مرة أخرى.

من يستخدمه ومتى

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

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

الطلاب الذين يتعلمون كتابة الاختبارات هم المجموعة الثالثة، ووضع Plan only يناسبهم أفضل. لا شيء يعمل. تقرأ الخطة، تتعلم لماذا يوجد كل فحص، ثم تترك الوكيل يكتب الملفات الأربعة للتمرين الأول بينما تتبع كل بطاقة.

أسئلة حول اختبار PHP مع CycleMantle

ما هو unit testing؟

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

هل phptest.org هو الموقع الرسمي لـ CycleMantle؟

نعم. هذا هو الموقع الرسمي لـ CycleMantle، وزر التحميل يعطي البناء الأصلي للتطبيق، الذي يجب أن تقارن تجزئة SHA-256 الخاصة به مع المانيفست المنشور قبل تشغيله. تذهب الأسئلة عبر زر Send feedback داخل التطبيق، والتطبيق مستقل عن مشروع PHP.

ماذا يظهر تقرير تغطية الكود؟

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

كيف أشغل unit testing لـ PHP مع CycleMantle؟

أسهل طريقة هي إعطاء الوكيل أمر الاختبار الخاص بك في الدردشة. يشغله Shell في البيئة التي اخترتها، وتظهر البطاقة رمز الخروج الحقيقي والإخراج. اقرأ البطاقة. استخدم Ask first إذا كان الوكيل قد يغير الملفات أيضاً، أو Plan only لرؤية خطة أولاً، واضغط Accept فقط للتعديلات التي تفهمها.

هل النتائج صحيحة دائماً؟

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

هل تخرج ملفاتي من الجهاز؟

نعم، مع نموذج سحابي: طلبك ونص الملف الذي يقرأه الوكيل يذهبان إلى ذلك المزود. مع نموذج محلي لا يخرج شيء من جهازك. الدردشات ومجلدات العمل ومفاتيح API تبقى على جهازك، والتطبيق لا يحتوي على قياس عن بعد، لذا فإن النص الوحيد الذي ينتقل هو ما ترسله إلى نقطة النهاية التي اخترتها. أنت تختارها.

أي إصدارات Windows يدعمها؟

يعمل CycleMantle على Windows 10 و 11، 64 بت، وبرنامج التثبيت حوالي 34 ميجابايت. لا حاجة لحساب. أدوات تغطية الكود ومشغلات الاختبار هي تلك المثبتة بالفعل على جهازك، والوكيل يشغل فقط الأوامر التي تعطيه إياها.

جربه اليوم

اكتب الاختبار التالي مع CycleMantle

حمّل برنامج التثبيت، قارن تجزئة التشفير، صل نموذجاً ثم افتح مشروع PHP واحد لطلب اختبارات لفئة واحدة. راجع كل اختلاف. الإصدار 2.9.30 هو الحالي.

تحميل CycleMantle لنظام Windows ↗

إلى أين تذهب بعد ذلك

كل صفحة من صفحات هذا الموقع متاحة بـ 20 لغة، بينما واجهة التطبيق نفسها تحتوي على 13 لغة.

ما يمكن أن يفعله الوكيل لاختباراتك ↗ صل نموذجاً سحابياً أو محلياً أو مدمجاً ↗ دليل خطوة بخطوة لبيانات الاختبار المصطنعة ↗ تحميل برنامج التثبيت لنظام Windows ↗ إجابات حول الاختبار والتطبيق ↗ ما يسجله هذا الموقع والتطبيق ↗