وصف الأداة

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

الميزات

  • استخراج تذاكر JIRA: يكتشف تلقائيًا ويستخرج معرفات تذاكر JIRA (مثال: PROJ-123) من مدخلاتك
  • بادئات نوع الفرع: اختر من بين أنواع الفروع الشائعة (feature, bugfix, hotfix, release, chore, refactor, docs, test, أو بدون بادئة)
  • فاصل قابل للتخصيص: استخدم الشرطات، أو الشرطة السفلية، أو أي حرف آخر كفاصل للكلمات
  • تحديد الطول: عيّن الحد الأقصى لطول اسم الفرع للامتثال لسياسات المستودع
  • تنظيف تلقائي: يزيل الأحرف الخاصة، يطبع المسافات، ويحوّل إلى أحرف صغيرة
  • معاينة فورية: شاهد اسم الفرع المُنشأ يتحديث في الوقت الحقيقي أثناء الكتابة
  • نسخ إلى الحافظة: انسخ بسرعة اسم الفرع المُنشأ بنقرة واحدة

حالات الاستخدام

  • تعلم كيفية تسمية فروع Git: مثالي للمطورين الذين يتعلمون أفضل ممارسات تسمية فروع Git ومعايير التسمية الموحدة
  • إنشاء فروع Feature: أنشئ أسماء فروع متسقة للميزات الجديدة مثل feature/PROJ-123/add-user-authentication
  • إصلاح الأخطاء: صِغ فروع إصلاح الأخطاء مثل bugfix/PROJ-456/fix-login-error
  • الإصلاحات العاجلة: أنشئ فروع إصلاح عاجلة مثل hotfix/PROJ-789/security-patch
  • اتساق الفريق: تأكد من أن جميع أعضاء الفريق يتبعون نفس معايير تسمية الفروع باستخدام هذا المولد لأسماء الفروع
  • إنشاء فروع سريع: سرّع سير العمل باستخدام هذا المبدع لفرع Git لتوليد الأسماء فورًا بدلاً من تنسيقها يدويًا
  • امتثال المستودع: احترم حدود الطول القصوى لأسماء الفروع التي يفرضها منصة استضافة Git الخاصة بك

أنواع الفروع

  • feature: للميزات والوظائف الجديدة
  • bugfix: لإصلاح الأخطاء العادية
  • hotfix: لإصلاحات الإنتاج العاجلة
  • release: لفروع إعداد الإصدار
  • chore: لمهام الصيانة والتحديثات
  • refactor: لإعادة هيكلة الشيفرة
  • docs: لتحديثات الوثائق
  • test: للتغييرات المتعلقة بالاختبار
  • none: أنشئ أسماء فروع بدون بادئة نوع

أفضل ممارسات تسمية فروع Git

فهم كيفية تسمية فروع Git أمر حاسم للحفاظ على مستودع نظيف. تتبع أسماء الفروع المُنشأة هذا الهيكل بناءً على أفضل ممارسات تسمية الفروع المعتمدة في الصناعة:

[branch-type]/[TICKET-ID]/[description-with-separators]

أمثلة على أسماء فروع Git مُنسقة بشكل صحيح:

  • الإدخال: PROJ-123 Add user authentication
    الإخراج: feature/PROJ-123/add-user-authentication

  • الإدخال: Fix login error
    الإخراج: bugfix/fix-login-error

  • الإدخال: Update documentation for API
    الإخراج: docs/update-documentation-for-api