Gaia: المُقيِّم العالمي لسلامة واجهات برمجة التطبيقات

التبعيات

• قم بتثبيت opam لبناء واجهة برمجة تطبيقات الاختبارات.

• قم بتثبيت git و python3 و pip و .NET لبناء RESTler و Schemathesis.

• قم بتثبيت cargo لبناء Gaia.

• قم بتثبيت docker v26.0.1 و docker compose v2.26.1 لبناء Gaia مع مكدس ELK (اختياري إن لم يكن).

• قم بتثبيت node >= v18.0.0 و npm >= v8.6.0

• لإنشاء مفتاح محلي opam:

make opam-switch

• لتثبيت جميع التبعيات:

make deps

البناء

• لبناء Gaia:

make build

• لبناء واجهة برمجة تطبيقات الاختبارات:

make build-test

مواصفات OpenAPI

• لتوليد مواصفات OpenAPI للاختبارات:

make generate-swagger

• لإزالة مواصفات OpenAPI للاختبارات:

make clean-swagger

التنسيق

• لتنسيق المشروع (الاختبار + المصدر):

make format

التنظيف

• لتنظيف ملفات البناء (الاختبار + المصدر):

make clean-build-files

• لتنظيف كل شيء:

make clean

التنفيذ

• بعد البناء، يمكنك عرض خيارات GAIA عن طريق:

./_bin/gaia --help

• استخدام GAIA:

gaia --configuration <configuration> --openapi-path <openapi-path> --workdir-path <workdir-path> --verbose <verbose>

• workdir-path: دليل العمل حيث ستجد سجلات المُختبرين المختلفة.

• openapi-path: مسار ملف OpenAPI لواجهة برمجة التطبيقات الحقيقية. مطلوب عند استخدام الاختبار العشوائي أو المراقبة ولكن ليس للإحصائيات

• verbose : مستوى التفصيل {NOTHING, LOW, MID, HIGH, ALL} (القيمة الافتراضية: NOTHING)

• configuration: مسار ملف json الذي يحتوي على: