سرفصل‌ها درس 44 از 250 · فایل‌ها، خطاها و ماژول‌ها
فایل‌ها، خطاها و ماژول‌ها

ماژول‌ها، importها و نگهبان main

وقتی برنامه‌ها بزرگ می‌شوند آن‌ها را به ماژول‌ها تقسیم می‌کنید: فایل‌های .py جداگانه، که هر کدام تابع‌های مرتبطی را نگه می‌دارد. فایلی به نام geometry.py ماژولی به نام geometry است، و فایل دیگری آن را import می‌کند:

# 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__" قرار می‌دهد. وقتی همان فایل import شود، __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))

نگهبان اجازه می‌دهد یک فایل هم کتابخانه‌ای قابل import و هم اسکریپتی قابل اجرا باشد، بی‌آنکه کد نمایشی هنگام import اجرا شود. این درس را روی یک تابع عادی نمره می‌دهیم، چون نمره‌دهنده یک قطعه‌کد تنها را اجرا می‌کند، اما وقتی فایل‌های زیادی دارید این الگو ضروری است.

نوبت شما

یک ماژول کوچک را تصور کنید. تابعی به نام circle_area(radius) تعریف کنید که 3.14159 * radius * radius را برگرداند. سپس نگهبان if __name__ == "__main__": را اضافه کنید، و درون آن متغیری به نام demo را برابر circle_area(2) قرار دهید (چون این قطعه‌کد مستقیم اجرا می‌شود، بلوک نگهبانی اجرا می‌شود و demo تعریف خواهد شد).

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.