ما هي الموديولات في بايثون؟ كيفية استيراد واستخدام مكتبات بايثون

🧩 الموديولات في بايثون: دليلك لتنظيم الكود واستخدام المكتبات

تخيل أنك تبني منزلاً. بدلاً من صنع كل قطعة من الصفر (الطوب، الأسمنت، النوافذ)، ستشتري مكونات جاهزة ومنظمة. الموديولات في بايثون هي بالضبط ذلك: مكونات جاهزة من الكود يمكنك استيرادها واستخدامها في برامجك لتوفير الوقت والجهد والحفاظ على تنظيم مشروعك.

في هذا الدرس، سنتعلم معاً ما هي الموديولات، ولماذا تعتبر من أهم مفاهيم البرمجة، وكيف نستخدمها بكل سهولة. هيا بنا! 🚀

📦 ما هو الموديول (Module)؟

الموديول هو ببساطة ملف بايثون (امتداده .py) يحتوي على دوال (Functions)، متغيرات (Variables)، أو حتى كائنات (Classes) مكتوبة مسبقاً وجاهزة للاستخدام.

فكرتها الأساسية:

1. التنظيم: تقسيم البرنامج الكبير إلى أجزاء صغيرة يسهل فهمها وصيانتها.
2. إعادة الاستخدام: كتابة الكود مرة واحدة واستخدامه في مشاريع متعددة.
3. الاستفادة من مكتبات الآخرين: استخدام كود كتبه مبرمجون آخرون لحل مشاكل شائعة، مثل العمليات الحسابية المعقدة، أو التعامل مع التواريخ.

مثال: لديك ملف اسمه greetings.py:

# هذا ملف موديول اسمه greetings
def say_hello(name):
    """دالة لتحية الشخص"""
    return f"مرحباً {name}! أهلاً وسهلاً بك."

def say_goodbye(name):
    """دالة لتوديع الشخص"""
    return f"مع السلامة {name}! إلى اللقاء."

🔧 كيفية استيراد واستخدام الموديول (The import Statement)

للاستفادة من الكود الموجود داخل الموديول، نحتاج إلى استيراده إلى البرنامج الرئيسي باستخدام الكلمة المفتاحية import.

الطريقة الأولى: استيراد الموديول كاملاً

نستورد الموديول بالاسم، ثم نصل لمحتوياته باستخدام النقطة ..

# البرنامج الرئيسي (main.py)
import greetings  # استيراد الموديول greetings

# استخدام دوال الموديول
message = greetings.say_hello("أحمد")
print(message)  # الناتج: مرحباً أحمد! أهلاً وسهلاً بك.

print(greetings.say_goodbye("سارة"))  # الناتج: مع السلامة سارة! إلى اللقاء.

الطريقة الثانية: استيراد دالة أو متغير محدد (from ... import ...)

ماذا لو أردنا استيراد دالة معينة فقط وليس الموديول كله؟ نستخدم from.

# البرنامج الرئيسي (main.py)
from greetings import say_hello  # استيراد الدالة say_hello فقط

# الآن يمكن استخدام الدالة مباشرة بدون اسم الموديول
print(say_hello("فاطمة"))  # الناتج: مرحباً فاطمة! أهلاً وسهلاً بك.

# say_goodbye لن تعمل هنا لأننا لم نستوردها

الطريقة الثالثة: استيراد كل محتويات الموديول (غير مستحسن)

from greetings import *  # استيراد كل الدوال والمتغيرات

print(say_hello("خالد"))
print(say_goodbye("خالد"))

⚠️ تحذير: هذه الطريقة غير مستحسنة لأنها قد تؤدي إلى تعارض في الأسماء إذا كان لديك دوال بنفس الاسم في برنامجك.

الطريقة الرابعة: إعطاء اسم مختصر للموديول (as)

عندما يكون اسم الموديول طويلاً، نعطيه اسمًا مختصراً (اسم مستعار) باستخدام as.

import greetings as gr  # الموديول greetings أصبح اسمه gr داخل هذا البرنامج

print(gr.say_hello("نور"))

📚 الموديولات القياسية في بايثون (Standard Library)

تأتي لغة بايثون مع مجموعة ضخمة من الموديولات الجاهزة تسمى "المكتبة القياسية"، لا تحتاج إلى تثبيت أي شيء إضافي لاستخدامها.

لنرى مثالاً مع موديول math الشهير الذي يحتوي على دوال رياضية:

import math

# استخدام دوال من موديول math
print(math.sqrt(16))   # الجذر التربيعي: الناتج 4.0
print(math.pow(2, 3))  # الأس: 2^3 = 8.0
print(math.pi)         # قيمة الثابت باي: 3.141592653589793

# تقريب رقم لأسفل أو لأعلى
print(math.floor(4.7))  # الناتج: 4
print(math.ceil(4.2))   # الناتج: 5

مثال آخر مع موديول random لإنشاء أرقام عشوائية:

import random

print(random.random())  # رقم عشوائي بين 0 و 1
print(random.randint(1, 10))  # رقم عشوائي صحيح بين 1 و 10 (يشمل الطرفين)

# اختيار عنصر عشوائي من قائمة
my_list = ["تفاح", "موز", "برتقال"]
print(random.choice(my_list))

🛠️ كيف تنشئ موديولك الخاص؟

أنشئ ملف بايثون جديداً واكتب فيه الكود الذي تريد إعادة استخدامه. هذا كل شيء! الملف الذي تنشئه هو موديول. كما فعلنا مع ملف greetings.py.

الخطوات العملية:

1. أنشئ ملفاً جديداً وأسمه my_utils.py.
2. اكتب فيه بعض الدوال البسيطة.
3. أنشئ ملفاً آخر (مثل app.py) في نفس المجلد.
4. استورد الموديول my_utils في app.py واستخدم دواله.

# ملف my_utils.py
def add(a, b):
    return a + b

def multiply(a, b):
    return a * b

# ملف app.py (في نفس المجلد)
import my_utils

result = my_utils.add(5, 3)
print(result)  # الناتج: 8

print(my_utils.multiply(4, 6))  # الناتج: 24

❓ لماذا نرى أحيانًا if name == "main"؟

عند كتابة موديول، قد نريد اختبار دواله مباشرة عند تشغيل الملف نفسه، ولكن ألا تنفذ هذه الاختبارات عندما يتم استيراد الملف كموديول في برنامج آخر. هنا يأتي دور المتغير السحري __name__.

• عندما تشغل ملف بايثون مباشرة، تكون قيمة __name__ هي "__main__".
• عندما يتم استيراد الملف كموديول، تكون قيمة __name__ هي اسم الموديول نفسه.

# ملف my_module.py
def useful_function():
    return "هذه دالة مفيدة!"

# هذا الكود سيعمل فقط إذا شغّلت الملف مباشرة، وليس عند استيراده
if __name__ == "__main__":
    print("جاري اختبار الموديول...")
    print(useful_function())
    print("تم الاختبار بنجاح!")

الآن إذا قمت بتشغيل my_module.py مباشرة، سترى رسائل الاختبار. لكن إذا استوردته في برنامج آخر (import my_module)، فلن تظهر رسائل الاختبار، وستتمكن فقط من استخدام الدالة useful_function().

🧠 ملخص الدرس

🎯 تعلمنا اليوم:

• الموديول هو ملف بايثون يمكن استيراده لاستخدام محتوياته.
• نستورد الموديول بـ import، ويمكننا استخدام from ... import ... لاستيراد أجزاء محددة.
• بايثون تحتوي على مكتبة قياسية غنية بموديولات جاهزة مثل math و random.
• يمكننا بسهولة إنشاء موديولاتنا الخاصة فقط بإنشاء ملف .py.
• if __name__ == "__main__": تساعدنا على فصل كود الاختبار عن كود الموديول الرئيسي.