المنهج الدراسي الدرس 44 من 250 · الملفات، الأخطاء والوحدات
الملفات، الأخطاء والوحدات

الوحدات، والاستيرادات، وحارس الدالة الرئيسية

عندما تكبر البرامج تقسّمها إلى وحدات (modules): ملفات .py منفصلة، يحتوي كل منها دوال مترابطة. الملف المسمّى geometry.py هو وحدة اسمها geometry، ويستوردها ملف آخر:

# geometry.py
def area(w, h):
    return w * h

# main.py
import geometry
print(geometry.area(3, 4))   # 12

# or pull in just one name
from geometry import area
print(area(3, 4))

هذا يحافظ على تركيز كل ملف ويسمح لك بإعادة استخدام الكود عبر المشاريع. package هو مجرد مجلد من الوحدات.

حارس __main__

عندما تشغّل Python ملفاً مباشرة، فإنها تضبط المتغير الخاص __name__ على النص "__main__". وعندما يُستورَد الملف نفسه، يكون __name__ هو اسم الوحدة بدلاً من ذلك. يشغّل هذا الفرق نمطاً شائعاً جداً:

def area(w, h):
    return w * h

if __name__ == "__main__":
    # only runs when you execute this file directly,
    # NOT when another file imports it
    print(area(3, 4))

يسمح الحارس للملف بأن يكون مكتبة قابلة للاستيراد وسكريبت قابلاً للتشغيل في آن واحد، دون تشغيل كود العرض عند الاستيراد. نحن نقيم هذا الدرس على دالة عادية، لأن المصحح يشغل مقطعاً واحداً فقط، لكن هذا النمط ضروري بمجرد امتلاكك لملفات كثيرة.

دورك

تخيل وحدة صغيرة. قم بتعريف الدالة circle_area(radius) التي تعيد 3.14159 * radius * radius. ثم أضف حارس if __name__ == "__main__":، وقم بداخلها بتعيين المتغير demo إلى circle_area(2) (بما أن هذا المقطع يعمل مباشرة، فسيتم تنفيذ الكتلة المحمية وسيتم تعريف demo).

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.