ghaymah-python-registry/how-to-use.md

بسم الله الرحمن الرحيم

إليك دليل استخدام سجل بايثون في منصة "غيمة" (Ghaymah) مُنسّق بشكل احترافي:

---

📦 دليل النشر على سجل حزم غيمة (Ghaymah Python Registry)

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

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

قبل البدء، تأكد من توفر الأدوات التالية في بيئة العمل:

1. Python 3.x مثبت على جهازك.
2. حزمة Twine (لعملية النشر).

لتثبيت twine، قم بتنفيذ الأمر التالي:

pip install twine

🔑 الحصول على بيانات الاعتماد (Credentials)

للنشر في سجل غيمة، تحتاج إلى اسم مستخدم (username) وكلمة مرور (password) خاصين بحسابك.

ملاحظة هامة: للحصول على بيانات الدخول (myuser و mypassword)، يرجى التواصل معنا مباشرة لإنشاء حسابك وتزويدك ببيانات الاعتماد الآمنة.

🚀 خطوات النشر باستخدام GitHub Actions

يمكنكم أتمتة عملية نشر الحزم عند كل إصدار جديد باستخدام خدمة GitHub Actions. فيما يلي مثال كامل لكيفية إعداد ملف العمل (Workflow) لنشر الحزمة على سجل غيمة.

إعداد ملف Workflow

قم بإنشاء ملف داخل مستودعك (Repository) بالمسار التالي: .github/workflows/publish.yml وأضف الكود أدناه:

name: Publish to Ghaymah PyPI Server

on:
  release:
    types: [created]

jobs:
  build-and-publish:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
    - name: Set up Python
      uses: actions/setup-python@v4
      with:
        python-version: '3.x'
    - name: Install dependencies
      run: |
        python -m pip install --upgrade pip
        pip install build twine
    - name: Build package
      run: python -m build
    - name: Publish to PyPI Server
      env:
        TWINE_REPOSITORY_URL: https://pypi.ghaymah.systems
      run: |
        twine upload --repository-url $TWINE_REPOSITORY_URL dist/* -u user -p password --verbose

⚠️ تنبيه أمني هام

في المثال السابق تم استخدام اسم المستخدم وكلمة المرور مباشرة (user, password) للتوضيح. ينصح بشدة بعدم كتابة بيانات الاعتماد بشكل صريح في الكود. بدلاً من ذلك، استخدم GitHub Secrets لحماية بياناتك:

1. اذهب إلى إعدادات المستودع (Repository Settings).
2. اختر Secrets and variables > Actions.
3. أضف سريين جديدين:
   • GHAYMAH_USERNAME: يحتوي على اسم المستخدم الخاص بك.
   • GHAYMAH_PASSWORD: يحتوي على كلمة المرور الخاصة بك.

ثم عدّل جزء النشر ليصبح كالتالي:

    - name: Publish to PyPI Server
      env:
        TWINE_REPOSITORY_URL: https://pypi.ghaymah.systems
      run: |
        twine upload --repository-url $TWINE_REPOSITORY_URL dist/* -u ${{ secrets.GHAYMAH_USERNAME }} -p ${{ secrets.GHAYMAH_PASSWORD }} --verbose

💻 التثبيت من سجل غيمة

بعد نشر الحزمة بنجاح، يمكن للمستخدمين تثبيتها عبر الأمر pip مع تحديد رابط السجل:

pip install your-package-name --index-url https://pypi.ghaymah.systems/simple/

(استبدل your-package-name باسم الحزمة الخاصة بك).

📞 للتواصل والدعم

إذا واجهتك أي مشكلة أو كنت بحاجة إلى بيانات الدخول، لا تتردد في التواصل معنا.

---

منصة غيمة - حلول سحابية عربية مبتكرة.