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


إليك كيفية إعداد ملف `pip.conf` لجعل سجل "غيمة" هو المصدر الافتراضي:

## 📝 إعداد ملف pip.conf

يعتمد مسار هذا الملف على نظام التشغيل الخاص بك. اختر النظام المناسب أدناه:

### 1. على أنظمة Linux و macOS
يتم وضع الملف عادةً في المسار `~/.config/pip/pip.conf`. إذا لم يكن المجلد موجودًا، يمكنك إنشاؤه.

أو يمكنك وضعه في المجلد الرئيسي `~/.pip/pip.conf` (للإصدارات القديمة).

### 2. على نظام Windows
يتم وضع الملف في المسار `%APPDATA%\pip\pip.ini`.

---

### ⚙️ محتوى الملف

بما أن سجل "غيمة" هو سجل خاص (Private Registry)، يفضل إضافة `trusted-host` لتجنب مشاكل شهادات SSL ولتعريف الجهاز بأن هذا المستضيف موثوق.

افتح الملف `pip.conf` (أو `pip.ini`) وأضف الأسطر التالية:

```ini
[global]
index-url = https://pypi.ghaymah.systems/simple/
trusted-host = pypi.ghaymah.systems
```

**توضيح الإعدادات:**
*   `index-url`: يحدد أن أي أمر `pip install` سيبحث تلقائيًا في سجل غيمة بدلاً من PyPI العالمي.
*   `trusted-host`: يخبر `pip` بالوثوق في هذا النطاق، وهو ضروري إذا كان السجل يستخدم شهادات داخلية أو HTTP (رغم أن الرابط يستخدم HTTPS، فهذا الإعداد يمنع بعض التحذيرات).

---

### 🔐 إضافة بيانات الاعتماد تلقائيًا

إذا كنت لا تريد إدخال اسم المستخدم وكلمة المرور في كل مرة تطلب فيها حزمة، يمكنك تضمينها داخل الرابط في ملف الإعداد (مع مراعاة الحيطة من كشف كلمة المرور في الأجهزة المشتركة):

```ini
[global]
index-url = https://myuser:mypassword@pypi.ghaymah.systems/simple/
trusted-host = pypi.ghaymah.systems
```

*(استبدل `myuser` و `mypassword` بالبيانات التي حصلت عليها من فريق الدعم).*

---

### 🔄 السيناريو المختلط: الاستخدام مع PyPI العالمي

إذا كنت تريد استخدام سجل "غيمة" للحزم الخاصة بك، مع الحفاظ على القدرة على تحميل الحزم العامة من PyPI، يفضل استخدام `extra-index-url` بدلاً من `index-url` ليبحث في كلا السجلين:

```ini
[global]
# يبحث هنا أولاً (غيمة)
index-url = https://myuser:mypassword@pypi.ghaymah.systems/simple/
# إذا لم يجد الحزمة، يبحث هنا (PyPI الرسمي)
extra-index-url = https://pypi.org/simple
trusted-host = pypi.ghaymah.systems
```

بعد حفظ هذا الملف، يمكنك ببساطة تشغيل:

```bash
pip install my-package
```

وسيقوم `pip` بالبحث في سجل غيمة تلقائيًا.