كيف تعمل الوحدات والاستيرادات والحزم؟

Question

Accepted Answer

**الوحدة** هي ملف `.py` واحد؛ **الحزمة** هي مجلد يحتوي على وحدات. **الاستيرادات** تسمح لك باستخدام الكود من وحدات أخرى، مما ينظم البرنامج إلى أجزاء قابلة لإعادة الاستخدام.

## الوحدات والاستيراد

```python
# math_utils.py — a module
def add(a, b): return a + b
PI = 3.14159
```

```python
# main.py — different ways to import
import math_utils                  # import the whole module
math_utils.add(2, 3)               # access via the module name

from math_utils import add, PI     # import specific names
add(2, 3)                          # use directly

from math_utils import add as plus # import with an alias
import numpy as np                 # common aliasing convention
```

## الحزم — مجلدات الوحدات

```text
mypackage/
  __init__.py        ← marks it as a package (can be empty)
  module_a.py
  subpackage/
    __init__.py
    module_b.py
```

```python
from mypackage.module_a import something
from mypackage.subpackage.module_b import other
```

ملف `__init__.py` يحدد مجلد كحزمة (ويمكنه تشغيل كود تهيئة الحزمة أو تحديد ما يكشفه `from package import *`).

## صيغة `if __name__ == "__main__"` الاصطلاحية

```python
def main():
    print("running as a script")

if __name__ == "__main__":   # True only when run directly, not when imported
    main()
```

هذا يسمح لملف بالعمل كوحدة قابلة للاستيراد *وأيضاً* كسكريبت قابل للتنفيذ — الكود تحتها يعمل فقط عند تنفيذ الملف مباشرة (`python file.py`)، وليس عند استيراده. صيغة اصطلاحية شاملة تقريباً في Python.

## حيث يبحث Python عن الوحدات

```python
import sys
sys.path   # the list of directories Python searches for imports
# includes: the current directory, installed packages (site-packages), stdlib
```

## المكتبة القياسية وأطراف ثالثة

```python
import os, json, datetime    # standard library — "batteries included"
import requests              # third-party — installed via pip from PyPI
```

## لماذا يهم

الوحدات والحزم هي الطريقة التي تنظم بها كود Python إلى وحدات قابلة لإعادة الاستخدام وسهلة الصيانة بدلاً من ملف عملاق واحد — وهي أساسية لأي مشروع غير بسيط.

فهم أنماط الاستيراد، وهيكل الحزمة (`__init__.py`)، وصيغة `if __name__ == "__main__"` الاصطلاحية (السلوك الثنائي للسكريبت/الوحدة)، وكيفية العثور على الوحدات في Python (`sys.path`) ضروري لهيكلة المشاريع، وإعادة استخدام الكود، واستخدام المكتبة القياسية الشاملة وبيئة PyPI.

أخطاء الاستيراد والارتباك في الهيكل عوائق مبكرة شائعة يحلها هذا المعرفة.

الوحدات والاستيراد

الحزم — مجلدات الوحدات

صيغة if __name__ == "__main__" الاصطلاحية

حيث يبحث Python عن الوحدات

المكتبة القياسية وأطراف ثالثة

لماذا يهم

صيغة `if name == "main"` الاصطلاحية