🧪 الدرس 34 – الوحدات (Modules) في python

✅ ما هي الوحدة (Module)؟

الوحدة هي ملف Python يحتوي على وظائف (Functions)، متغيرات (Variables)، أو كود برمجي يمكن استخدامه في ملفات أخرى.

---

📦 أنواع الوحدات:

1. الوحدات المدمجة (Built-in Modules)
   مثل: math, random, os, datetime

2. الوحدات الخارجية (External Modules)
   تحتاج إلى التثبيت عبر pip مثل: requests, numpy, flask

3. الوحدات التي تنشئها بنفسك (Custom Modules)
   تقوم بإنشاء ملف .py وتستخدم محتواه في ملف آخر.

---

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

➤ استيراد وحدة كاملة:

import math
print(math.sqrt(25))  # النتيجة: 5.0

➤ استيراد وظيفة معينة من وحدة:

from math import sqrt
print(sqrt(36))  # النتيجة: 6.0

➤ تغيير اسم الوحدة عند الاستيراد:

import math as m
print(m.pow(2, 3))  # النتيجة: 8.0

---

🛠️ إنشاء وحدة خاصة بك:

ملف باسم mytools.py:

def greet(name):
    return f"Hello, {name}!"

pi = 3.14

ملف آخر يستخدم الوحدة:

import mytools

print(mytools.greet("Noor"))  # النتيجة: Hello, Noor!
print(mytools.pi)             # النتيجة: 3.14

---

💡 ملاحظة:

Python تبحث عن الملفات داخل مجلد المشروع أو في مجلدات site-packages أو مجلد البيئة الافتراضية.

---

✅ التمرين:

📝 المطلوب:

1. أنشئ ملفًا اسمه math_tools.py يحتوي على:

   • دالة add(a, b) تجمع عددين.
   • دالة subtract(a, b) تطرح عددين.

2. أنشئ ملفًا آخر اسمه main.py، يقوم بما يلي:

   • يستورد دوال add و subtract من الوحدة math_tools.
   • يطلب من المستخدم إدخال عددين.
   • يطبع نتيجة الجمع والطرح باستخدام الدوال المستوردة.

---

💡 الحل:

🗂️ الملف الأول: math_tools.py

def add(a, b):
    return a + b

def subtract(a, b):
    return a - b

---

🗂️ الملف الثاني: main.py

from math_tools import add, subtract

# إدخال من المستخدم
x = float(input("أدخل العدد الأول: "))
y = float(input("أدخل العدد الثاني: "))

# العمليات
print(f"الناتج الجمع: {add(x, y)}")
print(f"الناتج الطرح: {subtract(x, y)}")

---

📌 المخرجات (مثال):

أدخل العدد الأول: 10
أدخل العدد الثاني: 5
الناتج الجمع: 15.0
الناتج الطرح: 5.0