randomSequence10K

مولد تسلسل عشوائي

مرحبًا بكم في مشروع مولد التسلسل العشوائي ! يقوم هذا التطبيق بإنشاء تسلسلات عشوائية من الأعداد الصحيحة، والتي يمكن استخدامها لأغراض مختلفة مثل الاختبار، أو توليد البيانات، أو التجارب الممتعة. يتبع المشروع معايير PHP الحديثة (PSR-12) ويتضمن اختبارًا آليًا باستخدام PHPUnit.

---

سمات

• توليد تسلسلات عشوائية من الأعداد الصحيحة.
• تحديد النطاقات المخصصة لإنشاء التسلسل.
• تم اختباره بالكامل باستخدام PHPUnit، بما في ذلك إعداد تقارير عن تغطية التعليمات البرمجية.
• يدعم معايير الترميز PSR-12 ويتضمن تنسيقًا آليًا للتعليمات البرمجية.
• بيئة حاويات للتطوير والاختبار المستمر.

---

ابدء

المتطلبات الأساسية

لتشغيل هذا المشروع، تأكد من تثبيت ما يلي:

• عامل ميناء
• عامل الميناء يؤلف
• (اختياري) الملحن إذا كان يعمل محليًا.

---

تثبيت

1. استنساخ المستودع:

   git clone https://github.com/illmatix/randomSequence10K.git
   cd randomSequence10K

2. ابدأ بيئة Docker:

   docker-compose up -d --build

3. الوصول إلى الحاوية:

   docker exec -it php-dev-container bash

4. تثبيت تبعيات PHP:

   compose install

الاستخدام

توليد تسلسل عشوائي

قم بتشغيل التطبيق لإنشاء تسلسل عشوائي:

   docker exec -it php-dev-container php public/index.php

يمكنك تخصيص نطاق التسلسل أو طوله عن طريق تعديل فئة SequenceGenerator.

اختبار

يتضمن المشروع اختبارات آلية مكتوبة باستخدام PHPUnit.

تشغيل الاختبارات

تشغيل كافة الاختبارات:

   composer test

تطوير

نمط الكود وتنسيقه

يتبع هذا المشروع معايير PSR-12 ويستخدم أدوات لفرض أنماط الترميز:

• PHP_CodeSniffer : التحقق من الكود للتأكد من توافقه مع PSR-12:

   composer lint

• PHP_CodeSniffer Fixer : إصلاح مشكلات الفحص تلقائيًا:

   composer lint:fix

• PHP-CS-Fixer : تنسيق التعليمات البرمجية تلقائيًا:

   composer format

المساهمة

المساهمات هي موضع ترحيب! إذا كنت ترغب في المساهمة:

1. شوكة المستودع.
2. قم بإنشاء فرع جديد لتغييراتك.
3. أرسل طلب سحب مع وصف التغييرات التي أجريتها.

رخصة

هذا المشروع مرخص بموجب ترخيص MIT. راجع ملف الترخيص للحصول على التفاصيل.

اتصال

لطرح الأسئلة أو الاقتراحات، لا تتردد في التواصل معنا عبر صفحة مشكلات المستودع. ترميز سعيد!