CycleMantle
الأسئلة الشائعة

واجهة API مجانية للاختبار، البيانات الوهمية وتطبيق CycleMantle

05

أساسيات الاختبار

ما هي واجهة API المجانية للاختبار؟

واجهة API المجانية للاختبار هي خدمة ويب عامة تُرجع بيانات نموذجية، وعادةً ما يبحث عنها المطورون كبيئة تجريبية للتدريب. CycleMantle ليس كذلك. إنه يكتب ردودًا ثابتة في ملف JSON تملكه أنت، لذا لا تعتمد اختباراتك على خادم شخص آخر أو على ما إذا كان متاحًا اليوم. استخدم الخدمة العامة فقط إذا سمح مالكها بذلك.

ما هي واجهة API الوهمية؟

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

كيف أحصل على بيانات اختبار واقعية لأعمال الواجهة الأمامية؟

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

ماذا يجب أن يخبرني تقرير التغطية؟

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

كيف أختبر الكود الذي يعتمد على واجهة خلفية متأخرة؟

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

استخدام CycleMantle

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

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

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

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

هل يمكن لـ CycleMantle تشغيل أمر الاختبار الخاص بي؟

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

كيف أتحقق من دالة يتغير مخرجاتها؟

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

ما الفرق بين Ask first و Plan only؟

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

النماذج، الخصوصية والتنزيل

هل تترك ملفات الكمبيوتر؟

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

أي النماذج يمكنني الاتصال بها؟

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

كيف أحمل وأتحقق من المثبت؟

أسهل طريقة هي الضغط على زر التنزيل، الذي يعطي برنامج الإعداد بحجم حوالي 34 ميجابايت، ثم مقارنة رقم التجزئة SHA-256 الخاص به مع المانيفست المنشور. تظهر صفحة التنزيل أمر Windows لذلك. المثبت ليس موقعًا بالرمز الرقمي بعد. قد يحذرك Windows SmartScreen، وتستمر فقط بعد مطابقة رقم التجزئة. احتفظ بصفحة المانيفست مفتوحة أثناء المقارنة.

هل أحتاج إلى حساب لاستخدام التطبيق؟

لا. يعمل CycleMantle بدون حساب، وتأتي واجهته بـ 13 لغة. قد يحتاج مزود الذكاء الاصطناعي السحابي إلى حسابه الخاص وقد يتقاضى رسومًا مقابل الاستخدام، لكن ذلك بينك وبين المزود. النموذج المدمج جاهز للاستخدام دون نقطة نهاية خاصة بك، لذا لا يحتاج اختبار أولي إلى تسجيل دخول على الإطلاق.

CycleMantle لنظام Windows

جرّب اختبارًا صغيرًا مع CycleMantle

تنزيل CycleMantle ↗