GitHub CLI (gh)

ما هي أداة GitHub CLI (gh)؟

GitHub CLI، المعروفة باسم gh، هي أداة سطر الأوامر الرسمية من GitHub. إنها تجلب قوة GitHub إلى طرفيتك، مما يتيح لك إدارة المستودعات، والتعامل مع القضايا (issues)، ومعالجة طلبات السحب (pull requests)، والتفاعل مع GitHub Actions دون مغادرة بيئة سطر الأوامر الخاصة بك. تم تصميمها لتبسيط سير عملك، وتقليل تبديل السياق، وجعل البرمجة النصية والأتمتة سلسة.

الميزات الرئيسية

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

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

• الأتمتة والبرمجة النصية: أتمتة المهام المتكررة مثل إنشاء طلبات السحب، وإعداد مستودعات جديدة، أو إدارة القضايا بشكل جماعي.
• تكامل CI/CD: استخدم gh في خطوط أنابيب CI/CD للتفاعل مع GitHub، مثل إنشاء إصدار بعد بناء ناجح.
• سير عمل يركز على الطرفية: للمطورين الذين يعيشون في الطرفية، توفر gh طريقة لأداء جميع المهام المتعلقة بـ GitHub تقريبًا بدون واجهة رسومية.
• فحوصات سريعة للحالة: تحقق بسرعة من حالة طلب سحب أو اطلع على أحدث القضايا لمشروع ما بأمر واحد.

البدء

إليك دليل بسيط بأسلوب “Hello World” لتبدأ مع gh.

1. التثبيت: على نظام macOS، يمكنك استخدام Homebrew:

   brew install gh
   

   لأنظمة أخرى مثل Windows أو Linux، ارجع إلى دليل التثبيت الرسمي.

2. المصادقة: سجل الدخول إلى حساب GitHub الخاص بك. سيفتح هذا الأمر نافذة متصفح للسماح لواجهة سطر الأوامر.

   gh auth login
   

3. إنشاء ونسخ مستودع: لنقم بإنشاء مستودع عام جديد ونسخه.

   # إنشاء مستودع جديد على GitHub
   gh repo create my-cli-app --public --source=. --remote=origin
   
   # نسخ مستودع موجود
   gh repo clone cli/cli
   

4. سرد القضايا: انتقل إلى دليل المستودع المنسوخ واعرض قضاياه المفتوحة.

   cd cli
   gh issue list
   

التسعير

أداة GitHub CLI (gh) مجانية ومفتوحة المصدر بالكامل، وتوزع بموجب ترخيص MIT. يمكنك استخدامها دون أي تكلفة للمشاريع الشخصية والتجارية على حد سواء.

المجتمع

كأداة رسمية من GitHub، تتمتع gh بمجتمع ضخم ونشط. يفتخر المشروع بعشرات الآلاف من النجوم على GitHub ويحظى بإشادة واسعة لمجموعة ميزاته القوية ولتحسين إنتاجية المطورين بشكل كبير. ردود الفعل إيجابية للغاية، وتعتبر الأداة ناضجة ومستقرة للاستخدام اليومي.